- Configure workspace Git repository with comprehensive .gitignore - Add Odoo as submodule for ERP reference code - Include documentation: SETUP.md, GIT-STRUCTURE.md - Add gitignore templates for projects (backend, frontend, database) - Structure supports independent repos per project/subproject level Workspace includes: - core/ - Reusable patterns, modules, orchestration system - projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.) - knowledge-base/ - Reference code and patterns (includes Odoo submodule) - devtools/ - Development tools and templates - customers/ - Client implementations template 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
4.4 KiB
4.4 KiB
Documentación Transversal
Versión: 2.0.0 Última Actualización: 2025-11-28 Estado: Consolidado
Propósito
Documentación cross-cutting del proyecto que no pertenece a una épica específica. Incluye inventarios, arquitectura, roadmap, métricas, y archivos históricos.
Estructura de Carpetas
| Carpeta | Descripción | Archivos |
|---|---|---|
| inventarios/ | Referencias a inventarios (ver orchestration/inventarios/) |
2 |
| arquitectura/ | Diagramas, flujos, funciones utilitarias | 5 |
| features/ | Documentación de features completadas | 8 |
| gaps/ | Análisis de GAPs identificados | 6 |
| roadmap/ | Roadmap general y por fase | 2 |
| sprints/ | Sprints históricos | 2 |
| metricas/ | Métricas del proyecto | 1 |
| correcciones/ | Issues y correcciones | 5 |
| restructuracion-v2/ | Reestructuración e implementaciones | 6 |
| archivos-historicos/ | Logs y reportes fechados (archivo) | ~20 |
Inventarios Consolidados
Nota: Los inventarios YAML están ubicados en
orchestration/inventarios/, no en esta carpeta. Ver inventarios/README.md para referencias.
Los 4 inventarios más importantes del proyecto:
| Inventario | Ubicación | Contenido |
|---|---|---|
| DATABASE_INVENTORY.yml | orchestration/inventarios/ |
13 schemas, 104 tablas, 162 índices |
| BACKEND_INVENTORY.yml | orchestration/inventarios/ |
20 módulos NestJS, 145 endpoints |
| FRONTEND_INVENTORY.yml | orchestration/inventarios/ |
15 features React, 200+ componentes |
| TRACEABILITY_MATRIX.yml | orchestration/inventarios/ |
16 épicas, 120+ User Stories |
Arquitectura
| Archivo | Descripción |
|---|---|
| FLUJO-INICIALIZACION-USUARIO.md | Flujo de registro y onboarding |
| DIAGRAMA-DEPENDENCIAS-INITIALIZE-USER-STATS.md | Dependencias de inicialización |
| FUNCIONES-UTILITARIAS-GAMILIT.md | Funciones SQL específicas |
| FUNCIONES-UTILITARIAS-PUBLIC.md | Funciones SQL públicas |
| STORAGE-SYSTEM.md | Sistema de almacenamiento |
Features Completadas
| Archivo | Descripción |
|---|---|
| FEATURES-IMPLEMENTADAS.md | Lista de features implementadas |
| FEATURES-PENDIENTES.md | Features pendientes |
| ADMIN-DASHBOARD-COMPLETO.md | Dashboard admin |
| AUDIT-LOGGING-COMPLETO.md | Sistema de auditoría |
| SOCIAL-FEATURES-COMPLETO.md | Features sociales |
Archivos Históricos
Los archivos con fechas específicas (logs, reportes, validaciones) se encuentran en:
archivos-historicos/
└── 2025-11/
├── VALIDACION-PRODUCCION-2025-11-24.md
├── CHECKLIST-PRODUCCION-2025-11-24.md
├── DESARROLLO-TEACHER-PORTAL-COMPLETO-2025-11-24.md
└── ... (20 archivos)
Estos archivos son referencias históricas del desarrollo. Para documentación actual, ver las carpetas principales.
Navegación Rápida
- ¿Buscas un componente? → inventarios/
- ¿Cómo funciona algo? → arquitectura/
- ¿Qué está implementado? → features/
- ¿Qué falta por hacer? → gaps/
- ¿Cuál es el plan? → roadmap/
- ¿Qué se hizo antes? → archivos-historicos/
Ver También
- docs/00-vision-general/ - Visión del producto
- docs/95-guias-desarrollo/ - Guías de desarrollo
- docs/97-adr/ - Decisiones de arquitectura
Consolidado: 2025-11-28 Archivos antes: ~50 en raíz Archivos después: 2 en raíz, resto organizado en subcarpetas