workspace-v1/projects/erp-construccion/docs/02-definicion-modulos/MAE-016-gestion-documental/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.5 KiB

MAE-016: Gestión Documental

Módulo: Sistema de Gestión Documental Corporativa
Story Points: 35 | Prioridad: Media | Fase: 2 (Enterprise)

Descripción General

Sistema centralizado para gestión, almacenamiento y control de documentos de proyectos de construcción. Incluye versionamiento, control de acceso, firma electrónica, y repositorio con clasificación por tipo y proyecto.

Alcance Funcional

1. Repositorio Documental

  • Almacenamiento en la nube (AWS S3)
  • Clasificación por proyecto y tipo
  • Metadata y etiquetado
  • Búsqueda avanzada
  • Versionamiento automático

2. Control de Versiones

  • Historial completo de versiones
  • Comparación entre versiones
  • Restauración de versiones anteriores
  • Trazabilidad de cambios

3. Firma Electrónica

  • Firma simple y avanzada
  • Validación de identidad
  • Certificado digital
  • Trazabilidad de firmas

4. Control de Acceso

  • Permisos por rol y proyecto
  • Documentos confidenciales
  • Registro de accesos
  • Compartir temporal

5. Workflow de Aprobación

  • Flujo de revisión de documentos
  • Aprobación multinivel
  • Comentarios y observaciones
  • Notificaciones automáticas

Componentes Técnicos

Backend (NestJS + TypeORM)

@Module({
  imports: [TypeOrmModule.forFeature([
    Document, DocumentVersion, DocumentSignature,
    DocumentAccess, DocumentApproval
  ])],
  providers: [
    DocumentService, VersionService, SignatureService,
    StorageService, ApprovalWorkflowService
  ],
  controllers: [DocumentController, SignatureController]
})
export class DocumentModule {}

Base de Datos (PostgreSQL)

CREATE SCHEMA documents;

CREATE TYPE documents.document_type AS ENUM ('contract', 'blueprint', 'permit', 'invoice', 'report', 'other');
CREATE TYPE documents.signature_type AS ENUM ('simple', 'advanced');
CREATE TYPE documents.approval_status AS ENUM ('pending', 'approved', 'rejected', 'revision');

Storage (AWS S3)

  • Bucket: documents-inmobiliaria
  • Estructura: {constructoraId}/{projectId}/{type}/{year}/{month}
  • Encriptación: AES-256
  • Lifecycle: Archive después de 2 años

Integraciones

  • MAI-001 (Proyectos): Documentos por proyecto
  • MAI-012 (Contratos): Firma de contratos
  • MAI-013 (Seguridad): Control de acceso por rol

Métricas Clave

  • Volumen: GB almacenados por proyecto
  • Accesos: Documentos más consultados
  • Tiempo de aprobación: Días promedio
  • Firmas: Documentos firmados vs pendientes

Generado: 2025-11-21