workspace-v1/orchestration/checklists/CHECKLIST-NUEVO-PROYECTO.md

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

- [ ] 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

## 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

## 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

## 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

## 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

## 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

## 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

## 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

## Configurar backend NestJS

- [ ] Inicializar proyecto NestJS en `apps/backend/`
- [ ] Configurar `package.json`
- [ ] Configurar `tsconfig.json` con paths a shared/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

## 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

## 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

## 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

## 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

## 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)

## 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

# 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

./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