# 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