rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2fb9f3f6b5
michangarrito/orchestration/_archive/analisis/PLAN-SPRINT1-DOCUMENTACION-2026-01-10.md
Adrian Flores Cortes 2fb9f3f6b5
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
Details
CI/CD Pipeline / Frontend CI (push) Waiting to run
Details
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
Details
CI/CD Pipeline / Mobile CI (push) Waiting to run
Details
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
Details
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
Details
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
Details
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
Details
[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure 
- Move 7 non-standard folders to _archive/
- Archive 3 extra root files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: CONSUMER (L2)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 14:38:04 -06:00

278 lines
8.7 KiB
Markdown
Raw Blame History

# Plan Sprint 1: Documentacion Base - MiChangarrito
**Fecha**: 2026-01-10
**Version**: 1.0.0
**Estado**: EN_PLANIFICACION
**Responsable**: Agente Orquestador
---
## 1. OBJETIVO DEL SPRINT
Crear la documentacion base SIMCO para el proyecto michangarrito, incluyendo:
1. `docs/_MAP.md` - Mapa de navegacion de documentacion
2. `DATABASE_INVENTORY.yml` - Inventario de base de datos
3. `BACKEND_INVENTORY.yml` - Inventario de backend NestJS
4. `FRONTEND_INVENTORY.yml` - Inventario de frontend React
---
## 2. RESUMEN DEL ANALISIS
### 2.1 Documentacion (docs/)
| Metrica | Valor |
|---------|-------|
| Total archivos MD | 42 |
| Secciones principales | 4 (00-vision, 01-epicas, 02-especificaciones, 90-transversal) |
| Epicas documentadas | 28 (MCH-001 a MCH-028) |
| MAPs existentes | 3 (raiz, epicas, especificaciones) |
| Duplicados detectados | 1 (ARQUITECTURA-DATABASE.md) |
### 2.2 Base de Datos (database/)
| Metrica | Valor |
|---------|-------|
| Archivos SQL | 15 |
| Schemas | 9 |
| Tablas | 27 |
| ENUMs | 2 |
| Funciones | 5 |
| Triggers | 14+ |
| Foreign Keys | 25+ |
| Extensiones | 4 (uuid-ossp, pgcrypto, unaccent, pg_trgm) |
### 2.3 Backend (apps/backend/)
| Metrica | Valor |
|---------|-------|
| Framework | NestJS 10.3.0 |
| Modulos | 12 |
| Controladores | 14 |
| Servicios | 14+ |
| Entidades | 20+ |
| Endpoints | 100+ |
| Puerto | 3141 |
### 2.4 Frontend (apps/frontend/)
| Metrica | Valor |
|---------|-------|
| Framework | React 19.2.0 + Vite 7.2.4 |
| Paginas | 9 |
| Componentes | 1 (Layout) |
| Contextos | 1 (AuthContext) |
| Servicios API | 1 (api.ts con 6 grupos) |
| Puerto | 3140 |
---
## 3. ENTREGABLES
### 3.1 docs/_MAP.md (ACTUALIZAR)
**Ubicacion**: `/home/isem/workspace-v1/projects/michangarrito/docs/_MAP.md`
**Accion**: ACTUALIZAR archivo existente
**Contenido requerido**:
- [ ] Estructura jerarquica completa
- [ ] Estadisticas actualizadas (42 archivos, 28 epicas)
- [ ] Referencias correctas a subdirectorios
- [ ] Estado por seccion
- [ ] Navegacion rapida por componente
**Dependencias**:
- Ningun archivo depende directamente de este
- Es archivo de referencia/navegacion
---
### 3.2 DATABASE_INVENTORY.yml (CREAR)
**Ubicacion**: `/home/isem/workspace-v1/projects/michangarrito/orchestration/inventarios/DATABASE_INVENTORY.yml`
**Accion**: CREAR nuevo archivo
**Contenido requerido**:
- [ ] Metadata (version, proyecto, engine, puerto, database)
- [ ] Resumen (9 schemas, 27 tablas, 5 funciones, 14+ triggers)
- [ ] Detalle de cada schema:
- public: tenants, tenant_configs, tenant_integration_credentials, tenant_whatsapp_numbers
- auth: users, sessions, otp_codes
- catalog: categories, products, product_templates
- sales: sales, sale_items, payments, daily_closures
- inventory: inventory_movements, stock_alerts
- customers: customers, fiados, fiado_payments
- orders: orders, order_items
- subscriptions: plans, subscriptions, token_packages, token_usage, tenant_token_balance
- messaging: conversations, messages, notifications
- [ ] Scripts de BD (create-database.sh, recreate-database.sh, validate-integrations.sh)
- [ ] Rutas base
**Dependencias**:
- Archivos SQL en database/schemas/
- Seeds en database/seeds/
- Scripts en database/scripts/
---
### 3.3 BACKEND_INVENTORY.yml (CREAR)
**Ubicacion**: `/home/isem/workspace-v1/projects/michangarrito/orchestration/inventarios/BACKEND_INVENTORY.yml`
**Accion**: CREAR nuevo archivo
**Contenido requerido**:
- [ ] Metadata (version, proyecto, framework, lenguaje)
- [ ] Configuracion (puerto 3141, base_path /api, version v1, swagger /docs)
- [ ] Resumen (12 modulos, 100+ endpoints, 20+ entities)
- [ ] Detalle de cada modulo:
- auth: Tenant, User, AuthController, AuthService
- products: Product, ProductsController, ProductsService
- categories: Category, CategoriesController, CategoriesService
- sales: Sale, SaleItem, SalesController, SalesService
- customers: Customer, Fiado, FiadoPayment, CustomersController, CustomersService
- orders: Order, OrderItem, OrdersController, OrdersService
- inventory: InventoryMovement, StockAlert, InventoryController, InventoryService
- payments: PaymentMethod, PaymentsController, PaymentsService
- subscriptions: Plan, Subscription, TokenBalance, TokenUsage, SubscriptionsController
- messaging: Conversation, Message, Notification, MessagingController
- billing: BillingController, BillingService
- integrations: TenantIntegrationCredential, TenantWhatsAppNumber, IntegrationsController
- [ ] Guards (JwtAuthGuard)
- [ ] Estrategias (JwtStrategy)
- [ ] Scripts NPM
**Dependencias**:
- Archivos en apps/backend/src/
- Entidades TypeORM que mapean a database/schemas/
- package.json
---
### 3.4 FRONTEND_INVENTORY.yml (CREAR)
**Ubicacion**: `/home/isem/workspace-v1/projects/michangarrito/orchestration/inventarios/FRONTEND_INVENTORY.yml`
**Accion**: CREAR nuevo archivo
**Contenido requerido**:
- [ ] Metadata (version, proyecto, framework, lenguaje)
- [ ] Configuracion (puerto 3140, proxy a backend 3141)
- [ ] Resumen (9 paginas, 1 componente, 1 contexto)
- [ ] Detalle de paginas:
- Dashboard: Metricas y resumen del negocio
- Products: Catalogo de productos
- Orders: Gestion de pedidos
- Customers: Directorio de clientes
- Fiado: Gestion de creditos
- Inventory: Control de inventario
- Settings: Configuracion
- Login: Autenticacion
- Register: Registro de negocios
- [ ] Componentes (Layout)
- [ ] Contextos (AuthContext)
- [ ] Servicios API (api.ts)
- [ ] Rutas configuradas
- [ ] Dependencias principales
**Dependencias**:
- Archivos en apps/frontend/src/
- package.json
- Consume API de backend
---
## 4. ESTRUCTURA DE ARCHIVOS A CREAR
```
michangarrito/
├── docs/
│ └── _MAP.md [ACTUALIZAR]
└── orchestration/
└── inventarios/
├── DATABASE_INVENTORY.yml [CREAR]
├── BACKEND_INVENTORY.yml [CREAR]
└── FRONTEND_INVENTORY.yml [CREAR]
```
---
## 5. ORDEN DE EJECUCION
| # | Archivo | Accion | Razon |
|---|---------|--------|-------|
| 1 | docs/_MAP.md | ACTUALIZAR | Base de navegacion, sin dependencias |
| 2 | DATABASE_INVENTORY.yml | CREAR | Base de datos es fundamento de todo |
| 3 | BACKEND_INVENTORY.yml | CREAR | Depende del inventario de BD |
| 4 | FRONTEND_INVENTORY.yml | CREAR | Depende del inventario de backend |
---
## 6. VALIDACIONES REQUERIDAS
### 6.1 docs/_MAP.md
- [ ] Todas las secciones documentadas
- [ ] Referencias a archivos existentes correctas
- [ ] Estadisticas actualizadas
### 6.2 DATABASE_INVENTORY.yml
- [ ] 9 schemas documentados
- [ ] 27 tablas listadas
- [ ] Columnas principales de cada tabla
- [ ] Foreign keys documentadas
- [ ] Triggers y funciones listados
### 6.3 BACKEND_INVENTORY.yml
- [ ] 12 modulos documentados
- [ ] Endpoints por modulo
- [ ] Entidades mapeadas a tablas de BD
- [ ] Guards y estrategias
### 6.4 FRONTEND_INVENTORY.yml
- [ ] 9 paginas documentadas
- [ ] Componentes y sus props
- [ ] Servicios API utilizados
- [ ] Rutas configuradas
---
## 7. CRITERIOS DE ACEPTACION
1. **Completitud**: Todos los elementos del analisis estan documentados
2. **Precision**: Los conteos y estadisticas son correctos
3. **Consistencia**: Formato SIMCO respetado segun templates
4. **Navegabilidad**: docs/_MAP.md permite encontrar cualquier archivo
5. **Trazabilidad**: Inventarios referencian archivos reales
---
## 8. DEPENDENCIAS IDENTIFICADAS
### 8.1 Dependencias Internas
| Archivo Origen | Archivo Destino | Tipo |
|----------------|-----------------|------|
| DATABASE_INVENTORY.yml | database/schemas/*.sql | DOCUMENTA |
| BACKEND_INVENTORY.yml | apps/backend/src/** | DOCUMENTA |
| BACKEND_INVENTORY.yml | DATABASE_INVENTORY.yml | REFERENCIA |
| FRONTEND_INVENTORY.yml | apps/frontend/src/** | DOCUMENTA |
| FRONTEND_INVENTORY.yml | BACKEND_INVENTORY.yml | REFERENCIA |
### 8.2 Archivos Criticos (No Modificar)
- database/schemas/*.sql
- apps/backend/src/**
- apps/frontend/src/**
---
## 9. TEMPLATES DE REFERENCIA
| Template | Ubicacion |
|----------|-----------|
| MASTER | /home/isem/workspace-v1/shared/knowledge-base/templates/inventories/TEMPLATE-MASTER-INVENTORY.yml |
| DATABASE | /home/isem/workspace-v1/shared/knowledge-base/templates/inventories/TEMPLATE-DATABASE-INVENTORY.yml |
| BACKEND | /home/isem/workspace-v1/shared/knowledge-base/templates/inventories/TEMPLATE-BACKEND-INVENTORY.yml |
| MAP | /home/isem/workspace-v1/orchestration/templates/TEMPLATE-MAP.md |
---
## 10. NOTAS
- El proyecto ya tiene un docs/_MAP.md existente que debe ser ACTUALIZADO, no recreado
- Los inventarios se crean en orchestration/inventarios/ (crear directorio si no existe)
- Seguir estructura SIMCO de templates del workspace
- Usar ejemplo de gamilit como referencia de inventario completo
---
**Fin del Plan**
Reference in New Issue View Git Blame Copy Permalink