workspace-v1/projects/erp-construccion/docs/02-definicion-modulos/MAI-018-preconstruccion-licitaciones/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

115 lines
3.7 KiB
Markdown

# MAI-018: Preconstrucción y Licitaciones
**Módulo:** Gestión de Preconstrucción y Proceso de Licitación
**Story Points:** 45 | **Prioridad:** P0 (Crítica) | **Fase:** 1
## Descripción General
Sistema para gestión de la fase de preconstrucción incluyendo análisis de viabilidad, presupuestos preliminares, y proceso completo de licitación para selección de contratistas y proveedores. Soporte para licitaciones públicas y privadas.
## Alcance Funcional
### 1. Análisis de Viabilidad
- Estudios de mercado y factibilidad
- Análisis técnico del terreno
- Viabilidad financiera (TIR, VPN, ROI)
- Permisos y licencias requeridas
- Cronograma preliminar
### 2. Presupuesto Preliminar
- Estimación paramétrica ($/m²)
- Catálogo de precios de referencia
- Análisis de costos por etapa
- Comparativo histórico de proyectos similares
- Margen de contingencia
### 3. Proceso de Licitación
- Creación de convocatoria
- Bases de licitación y anexos técnicos
- Registro de participantes
- Recepción de propuestas (técnica y económica)
- Evaluación y comparativo
- Fallo y notificación
### 4. Evaluación de Propuestas
- Tabla comparativa automática
- Criterios ponderados (precio, calidad, experiencia)
- Validación de requisitos técnicos
- Análisis de precios unitarios
- Recomendación de adjudicación
### 5. Gestión de Proveedores/Contratistas
- Catálogo de proveedores certificados
- Historial de participaciones
- Calificación de desempeño
- Documentación legal vigente
- Especialidades y capacidades
## Componentes Técnicos
### Backend (NestJS + TypeORM)
```typescript
@Module({
imports: [TypeOrmModule.forFeature([
FeasibilityStudy, PreliminaryBudget, Tender,
TenderProposal, Vendor, TenderEvaluation
])],
providers: [
PreconstrutionService, TenderService,
ProposalEvaluationService, VendorService
],
controllers: [PreconstrutionController, TenderController]
})
export class PreconstrutionModule {}
```
### Base de Datos (PostgreSQL)
```sql
-- Schema: preconstruction
CREATE SCHEMA IF NOT EXISTS preconstruction;
-- Tipos ENUM
CREATE TYPE preconstruction.tender_type AS ENUM ('public', 'private', 'direct');
CREATE TYPE preconstruction.tender_status AS ENUM ('draft', 'published', 'receiving', 'evaluating', 'awarded', 'cancelled');
CREATE TYPE preconstruction.proposal_status AS ENUM ('received', 'evaluating', 'qualified', 'disqualified', 'winner');
```
### Frontend (React + TypeScript)
```typescript
interface TenderDashboardProps {
projectId: string;
onSelectTender: (tender: Tender) => void;
}
const TenderDashboard: React.FC<TenderDashboardProps> = ({ projectId, onSelectTender }) => {
// Listado de licitaciones por proyecto
// Filtros por estado y tipo
// Acciones rápidas: crear, publicar, evaluar
};
```
## Integraciones
- **MAI-001 (Proyectos):** Vinculación de licitaciones a proyectos
- **MAI-002 (Presupuestos):** Generación de presupuesto definitivo desde preliminar
- **MAI-012 (Contratos):** Generación automática de contrato al adjudicar
- **MAI-013 (Seguridad):** Control de acceso a información confidencial
## Métricas Clave
- **Licitaciones activas:** Por proyecto y estado
- **Ahorro vs presupuesto:** % de ahorro logrado en licitación
- **Tiempo de proceso:** Días desde publicación hasta fallo
- **Participación:** Número promedio de propuestas por licitación
- **Conversión:** % de licitaciones adjudicadas vs canceladas
## Equipo y Roles
- **Director de Proyecto:** Aprobación de viabilidad y adjudicación
- **Gerente de Preconstrucción:** Análisis técnico y coordinación
- **Área de Compras:** Gestión de licitaciones
- **Comité de Evaluación:** Evaluación de propuestas
---
**Generado:** 2025-11-20