# INSTRUCCIONES PARA AGENTE DE ARQUITECTURA - ERP GENÉRICO

**Proyecto:** ERP Genérico
**Versión:** 1.0.0
**Fecha:** 2025-11-24

---

## 🎯 CONTEXTO

Este documento contiene las instrucciones específicas para lanzar el agente de arquitectura que ejecutará las 3 etapas del plan de documentación del ERP Genérico.

**Plan completo:** Ver `PLAN-DOCUMENTACION-ERP-GENERICO.md`

---

## 📋 ETAPA 1: ANÁLISIS Y RETROALIMENTACIÓN

### Objetivo
Analizar módulos core de Odoo, identificar patrones arquitectónicos, y crear documentación de análisis.

### Comando para lanzar el agente

```
Task tool con los siguientes parámetros:

subagent_type: "general-purpose"

prompt:
"Eres el Architecture-Analyst trabajando en el ERP Genérico.

CONTEXTO:
- Proyecto: projects/erp-generic/
- Plan: projects/erp-generic/docs/PLAN-DOCUMENTACION-ERP-GENERICO.md
- Referencias Odoo: shared/reference/ODOO-MODULES-ANALYSIS.md
- Referencia estructura: projects/erp-construccion/docs/

TAREA: Ejecutar ETAPA 1 del plan (Análisis y Retroalimentación)

MÓDULOS ODOO A ANALIZAR (por prioridad):
1. base - Sistema base, modelos fundamentales
2. auth_signup - Autenticación y registro
3. account - Módulo financiero
4. stock - Inventario
5. purchase - Compras
6. sale - Ventas
7. analytic - Contabilidad analítica
8. mail - Mensajería y notificaciones
9. crm - CRM básico
10. hr - Recursos humanos
11. project - Proyectos genéricos
12. portal - Portal de usuarios

PARA CADA MÓDULO CREAR:
1. Documento de análisis en: projects/erp-generic/docs/01-analysis/odoo-analysis/odoo-{modulo}-analysis.md

Estructura del análisis:
- Descripción del módulo
- Modelos de datos principales (tablas, campos, relaciones)
- Patrones arquitectónicos observados
- APIs y endpoints relevantes
- Reglas de negocio identificadas
- Aplicabilidad al ERP Genérico
- Recomendaciones

2. Para análisis en Odoo usar:
- shared/reference/ODOO-MODULES-ANALYSIS.md (ya existe)
- Si es necesario, buscar más info en shared/reference/ sobre Odoo

3. Crear ADRs (Architecture Decision Records) en: projects/erp-generic/docs/01-analysis/adr/

ADRs sugeridos:
- ADR-001-stack-tecnologico.md
- ADR-002-arquitectura-modular.md
- ADR-003-multi-tenancy.md
- ADR-004-seguridad-rbac.md
- ADR-005-base-de-datos.md

4. Crear mapa de componentes compartidos en: projects/erp-generic/docs/01-analysis/component-mapping/shared-components-map.md

Incluir:
- Lista de componentes que irán en shared/components/
- Componentes de base de datos comunes
- Módulos backend comunes
- Componentes frontend comunes
- Dependencias entre componentes

5. Retroalimentación a ERP Construcción:
- Comparar módulos del ERP Construcción con análisis de Odoo
- Identificar mejoras arquitectónicas
- Documentar en: projects/erp-generic/docs/01-analysis/feedback-construccion.md

ENTREGABLES ESPERADOS:
- 12 documentos de análisis de Odoo
- 5 ADRs
- 1 mapa de componentes compartidos
- 1 documento de retroalimentación

CRITERIOS DE COMPLETITUD:
- Todos los módulos listados están analizados
- ADRs cubren decisiones arquitectónicas clave
- Mapa de componentes es completo y detallado
- Retroalimentación a construcción es específica y accionable

FORMATO: Usar markdown, seguir convenciones del workspace.

NOTA: NO implementar código, solo crear documentación de análisis."

model: "sonnet" (usar Sonnet para análisis complejo)
```

### Verificación post-ejecución

Después de que el agente termine, verificar:

```bash
# Verificar documentos de análisis
ls projects/erp-generic/docs/01-analysis/odoo-analysis/
# Debe haber 12 archivos

# Verificar ADRs
ls projects/erp-generic/docs/01-analysis/adr/
# Debe haber al menos 5 archivos

# Verificar mapa de componentes
cat projects/erp-generic/docs/01-analysis/component-mapping/shared-components-map.md

# Verificar retroalimentación
cat projects/erp-generic/docs/01-analysis/feedback-construccion.md
```

---

## 📋 ETAPA 2: MODELADO DE REQUERIMIENTOS Y BASE DE DATOS

### Objetivo
Crear modelos de dominio, requerimientos funcionales, especificaciones técnicas, y diseño de base de datos.

### Comando para lanzar el agente

```
Task tool con los siguientes parámetros:

subagent_type: "general-purpose"

prompt:
"Eres el Architecture-Analyst trabajando en el ERP Genérico.

CONTEXTO:
- Proyecto: projects/erp-generic/
- Plan: projects/erp-generic/docs/PLAN-DOCUMENTACION-ERP-GENERICO.md
- Análisis completado: projects/erp-generic/docs/01-analysis/
- Referencia: projects/erp-construccion/docs/01-fase-alcance-inicial/

TAREA: Ejecutar ETAPA 2 del plan (Modelado de Requerimientos y BD)

MÓDULOS DEL ERP GENÉRICO (según plan):

FASE 1 - CORE (P0):
- MGN-001: Fundamentos (Auth, usuarios, roles, multi-tenancy)
- MGN-002: Empresas y Organizaciones
- MGN-003: Catálogos Maestros
- MGN-004: Financiero Básico
- MGN-005: Inventario Básico
- MGN-006: Compras Básico
- MGN-007: Ventas Básico
- MGN-008: Contabilidad Analítica

FASE 2 - COMPLEMENTARIA (P1):
- MGN-009: CRM Básico
- MGN-010: RRHH Básico
- MGN-011: Proyectos Genéricos
- MGN-012: Reportes y Analytics
- MGN-013: Portal de Usuarios
- MGN-014: Mensajería y Notificaciones

PARA CADA MÓDULO CREAR:

1. MODELOS DE DOMINIO en: projects/erp-generic/docs/02-requirements/domain-models/

Ejemplo para MGN-001:
- {modulo}-domain.md (ej: auth-domain.md)
- Incluir: Entidades, atributos, relaciones, diagramas
- Formato: Similar a análisis de Odoo pero específico para nuestro ERP

2. REQUERIMIENTOS FUNCIONALES en: projects/erp-generic/docs/01-fase-core/MGN-XXX-{nombre}/requerimientos/

Formato: RF-{SIGLA}-{NNN}-titulo.md
Ejemplo: RF-AUTH-001-autenticacion-jwt.md

Estructura de cada RF (usar como plantilla los RF de erp-construccion):
- ID y título
- Descripción
- Justificación
- Actores involucrados
- Flujo principal
- Flujos alternativos
- Reglas de negocio
- Criterios de aceptación

Estimación: ~5 RF por módulo = 70 RF totales

3. ESPECIFICACIONES TÉCNICAS en: projects/erp-generic/docs/01-fase-core/MGN-XXX-{nombre}/especificaciones/

Formato: ET-{SIGLA}-{NNN}-titulo.md
Ejemplo: ET-AUTH-001-jwt-implementation.md

Estructura de cada ET (usar como plantilla los ET de erp-construccion):
- ID y título
- Requerimiento relacionado (RF-XXX-NNN)
- Stack tecnológico
- Diseño de API (endpoints, request/response)
- Diseño de BD (tablas, campos)
- Diseño de UI (wireframes, componentes)
- Validaciones
- Manejo de errores
- Testing

Estimación: ~5 ET por módulo = 70 ET totales

4. DISEÑO DE BASE DE DATOS en: projects/erp-generic/docs/02-requirements/database-design/schemas/

Crear DDL completos:
- {modulo}-schema.sql (ej: auth-schema.sql)
- Incluir: CREATE SCHEMA, CREATE TABLE, CREATE TYPE (enums), CREATE INDEX
- Implementar RLS (Row Level Security) desde diseño
- Documentar relaciones (FK)
- Comentarios en código SQL

Schemas esperados:
- auth.sql
- core.sql (empresas, catálogos)
- financial.sql
- inventory.sql
- purchase.sql
- sales.sql
- analytics.sql
- crm.sql
- hr.sql
- projects.sql
- reporting.sql
- notifications.sql

5. MATRIZ DE TRAZABILIDAD en cada módulo: projects/erp-generic/docs/01-fase-core/MGN-XXX-{nombre}/implementacion/TRACEABILITY.yml

ENTREGABLES ESPERADOS:
- 10-14 modelos de dominio
- 70 requerimientos funcionales
- 70 especificaciones técnicas
- 12 esquemas de base de datos (DDL)
- 14 matrices de trazabilidad

CRITERIOS DE COMPLETITUD:
- Todos los módulos tienen modelos de dominio
- Cada módulo tiene al menos 5 RF y 5 ET
- Diseño de BD está completo y coherente
- Matrices de trazabilidad vinculan RF ↔ ET ↔ BD

FORMATO: Seguir exactamente formato de erp-construccion

NOTA: NO implementar código, solo crear documentación."

model: "sonnet"
```

### Verificación post-ejecución

```bash
# Verificar modelos de dominio
ls projects/erp-generic/docs/02-requirements/domain-models/
# Debe haber ~10-14 archivos

# Verificar RF de un módulo ejemplo
ls projects/erp-generic/docs/01-fase-core/MGN-001-fundamentos/requerimientos/
# Debe haber ~5 archivos RF-XXX-NNN.md

# Verificar ET
ls projects/erp-generic/docs/01-fase-core/MGN-001-fundamentos/especificaciones/
# Debe haber ~5 archivos ET-XXX-NNN.md

# Verificar schemas de BD
ls projects/erp-generic/docs/02-requirements/database-design/schemas/
# Debe haber ~12 archivos .sql

# Verificar trazabilidad
cat projects/erp-generic/docs/01-fase-core/MGN-001-fundamentos/implementacion/TRACEABILITY.yml
```

---

## 📋 ETAPA 3: DOCUMENTACIÓN DETALLADA Y PREPARACIÓN

### Objetivo
Completar la estructura de documentación con historias de usuario, planes de pruebas, y documentación transversal.

### Comando para lanzar el agente

```
Task tool con los siguientes parámetros:

subagent_type: "general-purpose"

prompt:
"Eres el Architecture-Analyst trabajando en el ERP Genérico.

CONTEXTO:
- Proyecto: projects/erp-generic/
- Plan: projects/erp-generic/docs/PLAN-DOCUMENTACION-ERP-GENERICO.md
- Etapa 1 y 2 completadas
- Referencia: projects/erp-construccion/docs/

TAREA: Ejecutar ETAPA 3 del plan (Documentación Detallada)

ACTIVIDADES:

1. CREAR HISTORIAS DE USUARIO para cada módulo en: projects/erp-generic/docs/01-fase-core/MGN-XXX-{nombre}/historias-usuario/

Formato: US-{SIGLA}-{NNN}-titulo.md
Ejemplo: US-FUND-001-login-usuario.md

Estructura (usar como plantilla US de erp-construccion):
- ID y título
- Como [rol] quiero [funcionalidad] para [beneficio]
- Criterios de aceptación (Given/When/Then)
- Requerimientos relacionados
- Story Points
- Prioridad

Estimación: ~10 US por módulo = 140 US totales

2. CREAR DOCUMENTACIÓN DE MÓDULOS:

Para cada módulo crear:
- README.md en: projects/erp-generic/docs/01-fase-core/MGN-XXX-{nombre}/README.md
  (Descripción completa del módulo, objetivos, alcance)

- _MAP.md en: projects/erp-generic/docs/01-fase-core/MGN-XXX-{nombre}/_MAP.md
  (Índice maestro con links a todos los documentos del módulo)

- Inventarios en: projects/erp-generic/docs/01-fase-core/MGN-XXX-{nombre}/implementacion/
  * DATABASE.yml - Lista de objetos de BD
  * BACKEND.yml - Lista de módulos/servicios backend
  * FRONTEND.yml - Lista de componentes frontend

3. CREAR PLANES DE PRUEBAS para cada módulo en: projects/erp-generic/docs/01-fase-core/MGN-XXX-{nombre}/pruebas/

- TEST-PLAN.md (estrategia de testing, alcance, criterios)
- TEST-CASES.md (casos de prueba específicos)

4. CREAR DOCUMENTACIÓN TRANSVERSAL:

- projects/erp-generic/docs/ESTRUCTURA-COMPLETA.md
  Similar a: projects/erp-construccion/docs/ESTRUCTURA-COMPLETA.md
  Incluir: Resumen ejecutivo, distribución por fase, estructura de directorios, métricas

- projects/erp-generic/docs/ROADMAP-DETALLADO.md
  Roadmap de desarrollo del ERP Genérico (sprints, hitos, dependencias)

- projects/erp-generic/docs/GUIA-USO-REFERENCIAS-ODOO.md
  Guía de cómo usar los análisis de Odoo durante el desarrollo

- projects/erp-generic/docs/01-fase-core/README.md
  Descripción de la Fase 1 (Core)

- projects/erp-generic/docs/01-fase-core/_MAP.md
  Índice maestro de todos los módulos de Fase 1

- projects/erp-generic/docs/02-fase-complementaria/README.md
  Descripción de la Fase 2 (Complementaria)

- projects/erp-generic/docs/02-fase-complementaria/_MAP.md
  Índice maestro de todos los módulos de Fase 2

ENTREGABLES ESPERADOS:
- 140 historias de usuario
- 28 archivos README.md y _MAP.md (2 por módulo)
- 42 inventarios YAML (3 por módulo)
- 28 planes de pruebas (2 por módulo)
- 7 documentos transversales

CRITERIOS DE COMPLETITUD:
- Todos los módulos tienen US completas
- Todos los módulos tienen README.md y _MAP.md
- Inventarios están estructurados y completos
- Planes de pruebas cubren funcionalidad crítica
- Documentación transversal es exhaustiva

FORMATO: Seguir exactamente formato de erp-construccion.

NOTA: Esta es la etapa final de documentación antes del desarrollo."

model: "sonnet"
```

### Verificación post-ejecución

```bash
# Verificar historias de usuario
ls projects/erp-generic/docs/01-fase-core/MGN-001-fundamentos/historias-usuario/
# Debe haber ~10 archivos US-XXX-NNN.md

# Verificar documentación de módulo
cat projects/erp-generic/docs/01-fase-core/MGN-001-fundamentos/README.md
cat projects/erp-generic/docs/01-fase-core/MGN-001-fundamentos/_MAP.md

# Verificar inventarios
ls projects/erp-generic/docs/01-fase-core/MGN-001-fundamentos/implementacion/
# Debe haber: DATABASE.yml, BACKEND.yml, FRONTEND.yml

# Verificar planes de pruebas
ls projects/erp-generic/docs/01-fase-core/MGN-001-fundamentos/pruebas/
# Debe haber: TEST-PLAN.md, TEST-CASES.md

# Verificar documentación transversal
cat projects/erp-generic/docs/ESTRUCTURA-COMPLETA.md
cat projects/erp-generic/docs/ROADMAP-DETALLADO.md
cat projects/erp-generic/docs/GUIA-USO-REFERENCIAS-ODOO.md
```

---

## ✅ CHECKLIST GENERAL

### Antes de iniciar cada etapa:
- [ ] Revisar el plan completo
- [ ] Verificar que referencias están disponibles
- [ ] Confirmar estructura de carpetas base existe

### Durante la ejecución:
- [ ] Monitorear progreso del agente
- [ ] Revisar calidad de documentos generados
- [ ] Validar que sigue formato de referencia

### Al completar cada etapa:
- [ ] Ejecutar verificación post-ejecución
- [ ] Revisar y validar entregables
- [ ] Aprobar antes de pasar a siguiente etapa

### Al completar todas las etapas:
- [ ] Documentación completa y coherente
- [ ] Estructura sigue formato de erp-construccion
- [ ] Referencias a Odoo están integradas
- [ ] Listo para iniciar desarrollo

---

## 🎯 RESULTADO ESPERADO FINAL

Al completar las 3 etapas, el proyecto `erp-generic` debe tener:

```
projects/erp-generic/docs/
├── 01-analysis/                    # Análisis de Odoo, ADRs, componentes
├── 02-requirements/                # Modelos de dominio, diseño de BD
├── 03-architecture/                # Arquitectura del sistema
├── 01-fase-core/                   # 8 módulos core completamente documentados
├── 02-fase-complementaria/         # 6 módulos complementarios documentados
├── ESTRUCTURA-COMPLETA.md          # Documentación transversal
├── ROADMAP-DETALLADO.md
└── GUIA-USO-REFERENCIAS-ODOO.md

Total estimado: ~370 archivos de documentación
```

Con esta documentación completa, se podrá:
1. Iniciar desarrollo del ERP Genérico
2. Reutilizar componentes en los 3 ERPs especializados
3. Mantener coherencia arquitectónica
4. Facilitar onboarding de nuevos desarrolladores

---

**Creado:** 2025-11-24
**Versión:** 1.0.0
**Autor:** Claude Code
**Estado:** ✅ Listo para usar