66161b1566
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
163 lines
4.6 KiB
Markdown
163 lines
4.6 KiB
Markdown
# TEMPLATE: Archivo _MAP.md
|
|
|
|
**Version:** 1.0.0
|
|
**Sistema:** NEXUS v3.4 + SIMCO
|
|
**Proposito:** Template estandar para archivos de indice _MAP.md
|
|
|
|
---
|
|
|
|
## Instrucciones de Uso
|
|
|
|
1. Copiar este template al directorio que requiere indice
|
|
2. Renombrar a `_MAP.md`
|
|
3. Reemplazar los placeholders `{...}` con valores reales
|
|
4. Actualizar la fecha en cada modificacion
|
|
5. Mantener enlaces relativos para portabilidad
|
|
|
|
---
|
|
|
|
## Template
|
|
|
|
```markdown
|
|
# {NOMBRE_DEL_DIRECTORIO}
|
|
|
|
> {Descripcion breve del contenido de este directorio}
|
|
|
|
## Contenido
|
|
|
|
| Archivo/Directorio | Descripcion | Estado |
|
|
|--------------------|-------------|--------|
|
|
| [{nombre.md}]({nombre.md}) | {Descripcion breve} | Activo |
|
|
| [{subdirectorio}/]({subdirectorio}/) | {Descripcion del subdirectorio} | Activo |
|
|
|
|
## Navegacion
|
|
|
|
- **Padre:** [../](..)
|
|
- **Relacionados:** [{nombre-relacionado}]({ruta-relacionado})
|
|
|
|
---
|
|
*Actualizado: {YYYY-MM-DD}*
|
|
```
|
|
|
|
---
|
|
|
|
## Ejemplo: Directorio de Modulos
|
|
|
|
```markdown
|
|
# Definicion de Modulos
|
|
|
|
> Modulos funcionales del proyecto, organizados por dominio
|
|
|
|
## Contenido
|
|
|
|
| Archivo/Directorio | Descripcion | Estado |
|
|
|--------------------|-------------|--------|
|
|
| [AUTH-001-autenticacion/](AUTH-001-autenticacion/) | Sistema de autenticacion y autorizacion | Activo |
|
|
| [CORE-002-usuarios/](CORE-002-usuarios/) | Gestion de usuarios y perfiles | Activo |
|
|
| [PAY-003-pagos/](PAY-003-pagos/) | Integracion de pagos con Stripe | En Desarrollo |
|
|
| [REPORT-004-reportes/](REPORT-004-reportes/) | Sistema de reportes y analytics | Planificado |
|
|
|
|
## Navegacion
|
|
|
|
- **Padre:** [../docs/](..)
|
|
- **Relacionados:** [arquitectura/](../01-arquitectura/)
|
|
|
|
---
|
|
*Actualizado: 2026-01-03*
|
|
```
|
|
|
|
---
|
|
|
|
## Ejemplo: Directorio de Arquitectura
|
|
|
|
```markdown
|
|
# Arquitectura
|
|
|
|
> Documentacion de arquitectura, diagramas y decisiones tecnicas
|
|
|
|
## Contenido
|
|
|
|
| Archivo/Directorio | Descripcion | Estado |
|
|
|--------------------|-------------|--------|
|
|
| [ARQUITECTURA-GENERAL.md](ARQUITECTURA-GENERAL.md) | Vision general de la arquitectura | Activo |
|
|
| [DIAGRAMA-COMPONENTES.md](DIAGRAMA-COMPONENTES.md) | Diagrama de componentes del sistema | Activo |
|
|
| [STACK-TECNOLOGICO.md](STACK-TECNOLOGICO.md) | Stack y tecnologias utilizadas | Activo |
|
|
| [diagramas/](diagramas/) | Diagramas en formato Mermaid/PlantUML | Activo |
|
|
|
|
## Navegacion
|
|
|
|
- **Padre:** [../docs/](..)
|
|
- **Relacionados:** [vision-general/](../00-vision-general/)
|
|
|
|
---
|
|
*Actualizado: 2026-01-03*
|
|
```
|
|
|
|
---
|
|
|
|
## Ejemplo: Raiz de docs/
|
|
|
|
```markdown
|
|
# Documentacion del Proyecto
|
|
|
|
> Punto de entrada para toda la documentacion del proyecto {NOMBRE_PROYECTO}
|
|
|
|
## Contenido
|
|
|
|
| Directorio | Descripcion | Estado |
|
|
|------------|-------------|--------|
|
|
| [00-vision-general/](00-vision-general/) | Vision, arquitectura general, stack | Activo |
|
|
| [01-arquitectura/](01-arquitectura/) | Diagramas, decisiones tecnicas, ADRs | Activo |
|
|
| [02-definicion-modulos/](02-definicion-modulos/) | Modulos funcionales del proyecto | Activo |
|
|
| [90-transversal/](90-transversal/) | Inventarios, integraciones, temas transversales | Activo |
|
|
| [95-guias-desarrollo/](95-guias-desarrollo/) | Guias para desarrolladores | Activo |
|
|
| [96-quick-reference/](96-quick-reference/) | Cheatsheets y referencias rapidas | Activo |
|
|
| [97-adr/](97-adr/) | Architecture Decision Records | Activo |
|
|
| [98-analisis/](98-analisis/) | Documentos de analisis | Activo |
|
|
| [99-finiquito/](99-finiquito/) | Documentacion de entrega | Planificado |
|
|
|
|
## Navegacion
|
|
|
|
- **Padre:** [../](..) (raiz del proyecto)
|
|
- **Relacionados:** [README.md](README.md)
|
|
|
|
---
|
|
*Actualizado: 2026-01-03*
|
|
```
|
|
|
|
---
|
|
|
|
## Estados Validos
|
|
|
|
| Estado | Descripcion | Uso |
|
|
|--------|-------------|-----|
|
|
| **Activo** | Documento/directorio en uso activo | Contenido vigente y mantenido |
|
|
| **En Desarrollo** | Contenido en construccion | Trabajo en progreso |
|
|
| **Planificado** | Pendiente de crear | Placeholder para futuro contenido |
|
|
| **Obsoleto** | Ya no se mantiene | Marcar para revision/eliminacion |
|
|
| **Draft** | Borrador sin aprobar | Requiere revision |
|
|
|
|
---
|
|
|
|
## Convenciones
|
|
|
|
1. **Nombres de archivo:** Usar MAYUSCULAS con guiones (ej: `ARQUITECTURA-GENERAL.md`)
|
|
2. **Nombres de directorio:** Usar minusculas con guiones (ej: `01-arquitectura/`)
|
|
3. **Prefijos numericos:** Para ordenar directorios (00-99)
|
|
4. **Enlaces relativos:** Siempre usar rutas relativas para portabilidad
|
|
5. **Fecha de actualizacion:** Actualizar en cada modificacion significativa
|
|
|
|
---
|
|
|
|
## Validacion
|
|
|
|
Usar el script `validate-docs-structure.sh` para verificar:
|
|
- Existencia de _MAP.md en directorios con contenido
|
|
- Coherencia de enlaces
|
|
- Archivos huerfanos (no referenciados)
|
|
|
|
---
|
|
|
|
**Template generado:** 2026-01-03
|
|
**Sistema:** NEXUS v3.4 + SIMCO
|