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
305 lines
7.3 KiB
Markdown
305 lines
7.3 KiB
Markdown
# Checklist: Crear Nuevo Proyecto
|
|
|
|
**Version:** 1.0.0
|
|
**Fecha:** 2026-01-03
|
|
**Aplica a:** Creacion de proyectos STANDALONE o SUITE
|
|
**Relacionado:** SIMCO-ESTRUCTURA-REPOS.md, SIMCO-NIVELES.md
|
|
|
|
---
|
|
|
|
## Proposito
|
|
|
|
Este checklist guia la creacion de nuevos proyectos en el workspace NEXUS, asegurando que la estructura, herencia y documentacion cumplan con los estandares SIMCO.
|
|
|
|
---
|
|
|
|
## Pre-Requisitos
|
|
|
|
```markdown
|
|
- [ ] Definido el nombre del proyecto (kebab-case, ej: "mi-proyecto")
|
|
- [ ] Definido el tipo: STANDALONE o SUITE
|
|
- [ ] Aprobacion del Product Owner
|
|
- [ ] Espacio en workspace disponible
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 1: Estructura Base
|
|
|
|
### 1.1 Para Proyecto STANDALONE
|
|
|
|
```markdown
|
|
## Crear estructura de directorios
|
|
|
|
- [ ] Crear directorio base: `projects/{proyecto}/`
|
|
- [ ] Crear subdirectorios de aplicaciones:
|
|
- [ ] `apps/database/`
|
|
- [ ] `apps/backend/`
|
|
- [ ] `apps/frontend/`
|
|
- [ ] `apps/mobile/` (si aplica)
|
|
- [ ] `apps/ml/` (si aplica)
|
|
- [ ] Crear directorio de documentacion: `docs/`
|
|
- [ ] `docs/00-vision-general/`
|
|
- [ ] `docs/01-especificaciones/`
|
|
- [ ] Crear directorio orchestration: `orchestration/`
|
|
```
|
|
|
|
### 1.2 Para Proyecto SUITE
|
|
|
|
```markdown
|
|
## Crear estructura de suite
|
|
|
|
- [ ] Crear directorio base: `projects/{suite}/`
|
|
- [ ] Crear estructura de apps:
|
|
- [ ] `apps/{core}/` (ej: erp-core)
|
|
- [ ] `apps/verticales/`
|
|
- [ ] `apps/saas/` (si aplica)
|
|
- [ ] `apps/products/` (si aplica)
|
|
- [ ] Crear directorio de documentacion: `docs/`
|
|
- [ ] Crear directorio orchestration: `orchestration/`
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 2: Orchestration
|
|
|
|
### 2.1 Estructura Orchestration
|
|
|
|
```markdown
|
|
## Crear estructura completa de orchestration
|
|
|
|
- [ ] Crear `orchestration/00-guidelines/`
|
|
- [ ] Crear `orchestration/inventarios/`
|
|
- [ ] Crear `orchestration/trazas/`
|
|
- [ ] Crear `orchestration/referencias/`
|
|
- [ ] Crear `orchestration/directivas/` (si tiene directivas propias)
|
|
```
|
|
|
|
### 2.2 Archivos Obligatorios
|
|
|
|
```markdown
|
|
## Crear archivos obligatorios
|
|
|
|
- [ ] Crear `00-guidelines/CONTEXTO-PROYECTO.md`
|
|
- [ ] Completar seccion de Identificacion
|
|
- [ ] Definir variables DB (nombre, schema prefix)
|
|
- [ ] Definir variables Backend (puerto, prefijo API)
|
|
- [ ] Definir variables Frontend (puerto)
|
|
- [ ] Definir herencia
|
|
|
|
- [ ] Crear `00-guidelines/HERENCIA-SIMCO.md`
|
|
- [ ] Definir nivel del proyecto
|
|
- [ ] Listar directivas activas
|
|
- [ ] Documentar cadena de herencia
|
|
|
|
- [ ] Crear `PROXIMA-ACCION.md`
|
|
- [ ] Definir primera tarea del proyecto
|
|
```
|
|
|
|
### 2.3 Inventarios
|
|
|
|
```markdown
|
|
## Crear inventarios iniciales
|
|
|
|
- [ ] Crear `inventarios/MASTER_INVENTORY.yml`
|
|
- [ ] Crear `inventarios/DATABASE_INVENTORY.yml`
|
|
- [ ] Crear `inventarios/BACKEND_INVENTORY.yml`
|
|
- [ ] Crear `inventarios/FRONTEND_INVENTORY.yml`
|
|
```
|
|
|
|
### 2.4 Trazas
|
|
|
|
```markdown
|
|
## Crear archivos de trazas
|
|
|
|
- [ ] Crear `trazas/TRAZA-TAREAS-DATABASE.md`
|
|
- [ ] Crear `trazas/TRAZA-TAREAS-BACKEND.md`
|
|
- [ ] Crear `trazas/TRAZA-TAREAS-FRONTEND.md`
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 3: Base de Datos
|
|
|
|
```markdown
|
|
## Configurar estructura de database
|
|
|
|
- [ ] Crear `apps/database/ddl/`
|
|
- [ ] Crear `apps/database/ddl/schemas/`
|
|
- [ ] Crear schema principal: `ddl/schemas/{proyecto}_management/`
|
|
- [ ] `00-schema.sql`
|
|
- [ ] `tables/`
|
|
- [ ] `functions/`
|
|
- [ ] `triggers/`
|
|
- [ ] `indexes/`
|
|
- [ ] Crear `apps/database/ddl/seeds/`
|
|
- [ ] Crear `apps/database/ddl/migrations/`
|
|
- [ ] Crear `apps/database/scripts/`
|
|
- [ ] `recreate-db.sh`
|
|
- [ ] `load-seeds.sh`
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 4: Backend
|
|
|
|
```markdown
|
|
## Configurar backend NestJS
|
|
|
|
- [ ] Inicializar proyecto NestJS en `apps/backend/`
|
|
- [ ] Configurar `package.json`
|
|
- [ ] Configurar `tsconfig.json` con paths a core/modules
|
|
- [ ] Configurar `nest-cli.json`
|
|
- [ ] Crear estructura de modulos base:
|
|
- [ ] `src/modules/`
|
|
- [ ] `src/config/`
|
|
- [ ] `src/common/`
|
|
- [ ] Configurar variables de entorno (.env.example)
|
|
- [ ] Configurar conexion a base de datos
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 5: Frontend
|
|
|
|
```markdown
|
|
## Configurar frontend React
|
|
|
|
- [ ] Inicializar proyecto React en `apps/frontend/`
|
|
- [ ] Configurar `package.json`
|
|
- [ ] Configurar `tsconfig.json`
|
|
- [ ] Configurar bundler (Vite recomendado)
|
|
- [ ] Crear estructura base:
|
|
- [ ] `src/pages/`
|
|
- [ ] `src/components/`
|
|
- [ ] `src/hooks/`
|
|
- [ ] `src/services/`
|
|
- [ ] `src/types/`
|
|
- [ ] Configurar routing base
|
|
- [ ] Configurar variables de entorno
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 6: Documentacion
|
|
|
|
```markdown
|
|
## Crear documentacion inicial
|
|
|
|
- [ ] Crear `docs/00-vision-general/README.md`
|
|
- [ ] Descripcion del proyecto
|
|
- [ ] Objetivos principales
|
|
- [ ] Stack tecnologico
|
|
- [ ] Arquitectura de alto nivel
|
|
- [ ] Crear `docs/01-especificaciones/` (vacio, listo para specs)
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 7: Registro en Workspace
|
|
|
|
```markdown
|
|
## Registrar proyecto en workspace
|
|
|
|
- [ ] Agregar entrada en INDICE-DIRECTIVAS-WORKSPACE.yml
|
|
- [ ] Seccion proyectos
|
|
- [ ] Definir tipo (STANDALONE/SUITE)
|
|
- [ ] Definir estado inicial
|
|
|
|
- [ ] Actualizar orchestration/WORKSPACE-STATUS.md
|
|
- [ ] Agregar a lista de proyectos activos
|
|
|
|
- [ ] (Si SUITE) Crear VERTICALES-INDEX.yml
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 8: Validacion
|
|
|
|
```markdown
|
|
## Ejecutar validaciones
|
|
|
|
- [ ] Ejecutar validate-repo-structure.sh --only-projects
|
|
- [ ] Verificar herencia de directivas
|
|
- [ ] Verificar que CONTEXTO-PROYECTO.md tiene todas las variables
|
|
- [ ] Verificar que HERENCIA-SIMCO.md lista directivas correctas
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 9: Git
|
|
|
|
```markdown
|
|
## Configurar control de versiones
|
|
|
|
- [ ] Inicializar git (si aplica)
|
|
- [ ] Crear .gitignore apropiado
|
|
- [ ] Configurar branch protection (si aplica)
|
|
- [ ] Crear commit inicial con estructura base
|
|
```
|
|
|
|
---
|
|
|
|
## Seccion 10: Para Verticales (Solo SUITE)
|
|
|
|
```markdown
|
|
## Configuracion adicional para verticales
|
|
|
|
- [ ] Usar TEMPLATE-ESTRUCTURA-VERTICAL.md
|
|
- [ ] Crear `00-guidelines/HERENCIA-ERP-CORE.md`
|
|
- [ ] Crear `referencias/DEPENDENCIAS-CORE.yml`
|
|
- [ ] Registrar en `{suite}/orchestration/VERTICALES-INDEX.yml`
|
|
- [ ] Documentar schemas heredados del suite-core
|
|
```
|
|
|
|
---
|
|
|
|
## Comandos Utiles
|
|
|
|
### Crear Estructura STANDALONE
|
|
|
|
```bash
|
|
# Variables
|
|
PROYECTO="nombre-proyecto"
|
|
BASE_PATH="projects/$PROYECTO"
|
|
|
|
# Crear estructura
|
|
mkdir -p $BASE_PATH/{apps/{database/ddl/{schemas,seeds,migrations},backend/src,frontend/src},docs/{00-vision-general,01-especificaciones},orchestration/{00-guidelines,inventarios,trazas,referencias}}
|
|
|
|
# Crear archivos obligatorios
|
|
touch $BASE_PATH/orchestration/00-guidelines/{CONTEXTO-PROYECTO.md,HERENCIA-SIMCO.md}
|
|
touch $BASE_PATH/orchestration/{PROXIMA-ACCION.md}
|
|
touch $BASE_PATH/orchestration/inventarios/{MASTER_INVENTORY.yml,DATABASE_INVENTORY.yml,BACKEND_INVENTORY.yml,FRONTEND_INVENTORY.yml}
|
|
touch $BASE_PATH/orchestration/trazas/{TRAZA-TAREAS-DATABASE.md,TRAZA-TAREAS-BACKEND.md,TRAZA-TAREAS-FRONTEND.md}
|
|
touch $BASE_PATH/docs/00-vision-general/README.md
|
|
|
|
echo "Estructura creada en $BASE_PATH"
|
|
```
|
|
|
|
### Validar Estructura
|
|
|
|
```bash
|
|
./devtools/scripts/validation/validate-repo-structure.sh --verbose
|
|
```
|
|
|
|
---
|
|
|
|
## Notas Finales
|
|
|
|
- **Tiempo estimado:** 30-60 minutos para estructura completa
|
|
- **Responsable:** Tech-Leader o Workspace-Manager
|
|
- **Siguiente paso:** Crear primera HU del proyecto siguiendo SIMCO-TAREA.md
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
- **Arquitectura:** `SIMCO-ESTRUCTURA-REPOS.md`
|
|
- **Niveles:** `SIMCO-NIVELES.md`
|
|
- **Template Vertical:** `TEMPLATE-ESTRUCTURA-VERTICAL.md`
|
|
- **Validador:** `validate-repo-structure.sh`
|
|
|
|
---
|
|
|
|
**Checklist Version:** 1.0.0 | **Sistema:** SIMCO | **Tipo:** Checklist de Proyecto
|