workspace-v1/projects/erp-construccion/docs/02-definicion-modulos/MAE-015-activos-maquinaria/README.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

2.4 KiB

MAE-015: Activos y Maquinaria

Módulo: Gestión de Activos Fijos y Maquinaria de Construcción
Story Points: 40 | Prioridad: Media | Fase: 2 (Enterprise)

Descripción General

Sistema para gestión y control de activos fijos, maquinaria, vehículos y herramientas utilizados en proyectos de construcción. Incluye inventario, mantenimiento, depreciación, y asignación a proyectos.

Alcance Funcional

1. Catálogo de Activos

  • Registro de maquinaria y equipo
  • Características técnicas
  • Documentos (factura, póliza, manuales)
  • Valor de adquisición y depreciación
  • Ubicación actual

2. Asignación a Proyectos

  • Transfer de activos entre proyectos
  • Tracking de ubicación
  • Costeo por uso (horas/días)
  • Historial de asignaciones

3. Mantenimiento Preventivo

  • Calendario de mantenimientos
  • Checklist por tipo de activo
  • Registro de mantenimientos realizados
  • Alertas de próximos mantenimientos
  • Bitácora de fallas

4. Control de Herramientas

  • Vale de salida/entrada
  • Responsable por herramienta
  • Inventario en resguardo
  • Reportes de pérdidas/robos

5. Depreciación Contable

  • Cálculo automático (línea recta, acelerada)
  • Depreciación mensual
  • Valor en libros
  • Reportes para contabilidad

Componentes Técnicos

Backend (NestJS + TypeORM)

@Module({
  imports: [TypeOrmModule.forFeature([
    Asset, AssetAssignment, MaintenanceSchedule,
    MaintenanceRecord, ToolCheckout, Depreciation
  ])],
  providers: [
    AssetService, MaintenanceService,
    ToolService, DepreciationService
  ],
  controllers: [AssetController, MaintenanceController]
})
export class AssetModule {}

Base de Datos (PostgreSQL)

CREATE SCHEMA assets;

CREATE TYPE assets.asset_type AS ENUM ('machinery', 'vehicle', 'tool', 'equipment');
CREATE TYPE assets.asset_status AS ENUM ('available', 'in_use', 'maintenance', 'retired');
CREATE TYPE assets.maintenance_type AS ENUM ('preventive', 'corrective', 'inspection');

Integraciones

  • MAI-002 (Proyectos): Asignación de activos a proyectos
  • MAI-003 (Presupuestos): Costeo de uso de maquinaria
  • MAE-014 (Finanzas): Depreciación para contabilidad

Métricas Clave

  • Utilización: % de tiempo en uso vs disponible
  • Costo por hora: Depreciación + mantenimiento / horas uso
  • Tiempo fuera de servicio: Días en mantenimiento
  • ROI: Retorno sobre inversión por activo

Generado: 2025-11-21