rckrdmrd
1a53b5c4d3
- Backend NestJS con módulos de autenticación, inventario, créditos - Frontend React con dashboard y componentes UI - Base de datos PostgreSQL con migraciones - Tests E2E configurados - Configuración de Docker y deployment Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
226 lines
6.0 KiB
Markdown
226 lines
6.0 KiB
Markdown
# Plan de Actualizacion de Documentacion - MiInventario
|
|
|
|
**Fecha:** 2026-01-10
|
|
**Fase:** Planeacion
|
|
**Estado:** Aprobado para Ejecucion
|
|
|
|
---
|
|
|
|
## 1. OBJETIVO
|
|
|
|
Sincronizar toda la documentacion de inventarios y trazas con el estado real del codigo implementado, siguiendo los estandares SIMCO v4.0.0.
|
|
|
|
---
|
|
|
|
## 2. ARCHIVOS A ACTUALIZAR
|
|
|
|
### 2.1 Inventarios (Orden de Ejecucion)
|
|
|
|
| # | Archivo | Prioridad | Dependencias |
|
|
|---|---------|-----------|--------------|
|
|
| 1 | DATABASE_INVENTORY.yml | P0 | Ninguna |
|
|
| 2 | BACKEND_INVENTORY.yml | P0 | DATABASE |
|
|
| 3 | FRONTEND_INVENTORY.yml | P0 | BACKEND |
|
|
| 4 | MASTER_INVENTORY.yml | P0 | Todos |
|
|
|
|
### 2.2 Trazas
|
|
|
|
| # | Archivo | Prioridad |
|
|
|---|---------|-----------|
|
|
| 5 | TRAZA-TAREAS-DATABASE.md | P1 |
|
|
| 6 | TRAZA-TAREAS-BACKEND.md | P1 |
|
|
| 7 | TRAZA-TAREAS-MOBILE.md | P1 |
|
|
|
|
### 2.3 Contexto
|
|
|
|
| # | Archivo | Prioridad |
|
|
|---|---------|-----------|
|
|
| 8 | CONTEXTO-PROYECTO.md | P1 |
|
|
|
|
---
|
|
|
|
## 3. DETALLE DE CAMBIOS POR ARCHIVO
|
|
|
|
### 3.1 DATABASE_INVENTORY.yml
|
|
|
|
**Cambios Principales:**
|
|
- Actualizar `estado: implementado`
|
|
- Cambiar modelo de schemas multiples a schema unico (public)
|
|
- Documentar 13 tablas con campos completos
|
|
- Documentar 10 ENUMs
|
|
- Documentar 17 indices
|
|
- Documentar 13 foreign keys
|
|
- Registrar migracion TypeORM
|
|
|
|
**Tablas a Documentar:**
|
|
1. users - Usuarios del sistema
|
|
2. stores - Tiendas
|
|
3. store_users - Relacion usuarios-tiendas
|
|
4. videos - Videos subidos
|
|
5. inventory_items - Items de inventario
|
|
6. credit_balances - Saldos de creditos
|
|
7. credit_packages - Paquetes de creditos
|
|
8. credit_transactions - Transacciones de creditos
|
|
9. payments - Pagos
|
|
10. referrals - Referidos
|
|
11. notifications - Notificaciones
|
|
12. otps - Codigos OTP
|
|
13. refresh_tokens - Tokens de refresco
|
|
|
|
---
|
|
|
|
### 3.2 BACKEND_INVENTORY.yml
|
|
|
|
**Cambios Principales:**
|
|
- Actualizar `estado: implementado` en todos los modulos
|
|
- Documentar 11 modulos con archivos
|
|
- Documentar 45+ endpoints
|
|
- Documentar 13 entidades
|
|
- Documentar 12+ DTOs
|
|
- Actualizar tests E2E: 53 pasando
|
|
|
|
**Modulos a Documentar:**
|
|
1. auth - 5 endpoints (register, verify-otp, login, refresh, logout)
|
|
2. users - 3 endpoints (me, update, fcm-token)
|
|
3. stores - 5 endpoints (create, list, get, update, delete)
|
|
4. inventory - 7 endpoints (list, stats, low-stock, categories, get, update, delete)
|
|
5. videos - 5 endpoints (initiate, confirm, status, result, list)
|
|
6. credits - 3 endpoints (balance, transactions, packages)
|
|
7. payments - 4 endpoints (create, list, get, webhook)
|
|
8. referrals - 5 endpoints (my-code, stats, list, validate, apply)
|
|
9. notifications - 5 endpoints (list, unread-count, mark-read, mark-all, register-token)
|
|
10. ia-provider - 0 endpoints (servicio interno)
|
|
11. health - 2 endpoints (health, ready)
|
|
|
|
---
|
|
|
|
### 3.3 FRONTEND_INVENTORY.yml
|
|
|
|
**Cambios Principales:**
|
|
- Actualizar `estado: implementado` en todas las screens
|
|
- Documentar 23 screens con rutas expo-router
|
|
- Documentar 7 stores Zustand
|
|
- Documentar 9 servicios API
|
|
- Documentar estructura de navegacion
|
|
|
|
**Screens por Grupo:**
|
|
- Auth (3): login, register, verify-otp
|
|
- Tabs (4): index/home, scan, inventory, profile
|
|
- Credits (2): buy, history
|
|
- Stores (3): index, new, [id]
|
|
- Inventory (1): [id]
|
|
- Notifications (1): index
|
|
- Referrals (1): index
|
|
- Profile (1): edit
|
|
- Payments (1): methods
|
|
- Help (1): index
|
|
- Support (1): index
|
|
- Legal (2): terms, privacy
|
|
|
|
**Stores:**
|
|
1. useAuthStore - Autenticacion
|
|
2. useCreditsStore - Creditos
|
|
3. useInventoryStore - Inventario
|
|
4. useNotificationsStore - Notificaciones
|
|
5. usePaymentsStore - Pagos
|
|
6. useReferralsStore - Referidos
|
|
7. useStoresStore - Tiendas
|
|
|
|
---
|
|
|
|
### 3.4 MASTER_INVENTORY.yml
|
|
|
|
**Cambios Principales:**
|
|
- Actualizar `version: 2.0.0`
|
|
- Actualizar `estado: desarrollo-activo`
|
|
- Actualizar progreso de fases:
|
|
- Fase 1 MVP Core: 100%
|
|
- Fase 3 Monetizacion: 100%
|
|
- Actualizar resumen de epicas
|
|
- Actualizar metricas de codigo
|
|
- Actualizar integraciones activas
|
|
|
|
---
|
|
|
|
### 3.5 TRAZA-TAREAS-*.md
|
|
|
|
**Cambios Comunes:**
|
|
- Actualizar estado de todas las tareas a "completado"
|
|
- Agregar fecha de completado
|
|
- Documentar archivos creados
|
|
- Actualizar estadisticas
|
|
|
|
---
|
|
|
|
### 3.6 CONTEXTO-PROYECTO.md
|
|
|
|
**Cambios Principales:**
|
|
- Actualizar `estado: En Desarrollo Activo`
|
|
- Actualizar `version: 1.0.0`
|
|
- Actualizar puertos (3142 en lugar de 3150)
|
|
- Actualizar estado de implementacion
|
|
- Actualizar integraciones
|
|
|
|
---
|
|
|
|
## 4. VALIDACIONES POST-ACTUALIZACION
|
|
|
|
### 4.1 Consistencia de Datos
|
|
- [ ] Tablas en DATABASE_INVENTORY coinciden con migracion
|
|
- [ ] Modulos en BACKEND_INVENTORY coinciden con /modules
|
|
- [ ] Screens en FRONTEND_INVENTORY coinciden con /app
|
|
- [ ] Endpoints documentados coinciden con controllers
|
|
- [ ] Totales en MASTER coinciden con inventarios detallados
|
|
|
|
### 4.2 Validaciones de Codigo
|
|
- [ ] Backend build: `npm run build`
|
|
- [ ] Mobile TypeScript: `npx tsc --noEmit`
|
|
- [ ] Tests E2E: `npm run test:e2e`
|
|
|
|
### 4.3 Estructura de Archivos
|
|
- [ ] Todos los archivos YAML validos
|
|
- [ ] Todos los archivos Markdown bien formateados
|
|
- [ ] Referencias cruzadas correctas
|
|
|
|
---
|
|
|
|
## 5. RIESGOS Y MITIGACIONES
|
|
|
|
| Riesgo | Impacto | Mitigacion |
|
|
|--------|---------|------------|
|
|
| Inconsistencia entre docs | Alto | Validacion cruzada automatica |
|
|
| Campos faltantes en entidades | Medio | Verificar contra migracion |
|
|
| Rutas de screens incorrectas | Bajo | Verificar con `ls app/` |
|
|
|
|
---
|
|
|
|
## 6. CRONOGRAMA DE EJECUCION
|
|
|
|
| Paso | Actividad | Duracion Estimada |
|
|
|------|-----------|-------------------|
|
|
| 1 | Actualizar DATABASE_INVENTORY | 10 min |
|
|
| 2 | Actualizar BACKEND_INVENTORY | 15 min |
|
|
| 3 | Actualizar FRONTEND_INVENTORY | 15 min |
|
|
| 4 | Actualizar MASTER_INVENTORY | 10 min |
|
|
| 5 | Actualizar Trazas (3 archivos) | 10 min |
|
|
| 6 | Actualizar CONTEXTO-PROYECTO | 5 min |
|
|
| 7 | Validaciones finales | 10 min |
|
|
| **TOTAL** | | **~75 min** |
|
|
|
|
---
|
|
|
|
## 7. CRITERIOS DE EXITO
|
|
|
|
1. Todos los inventarios reflejan estado real del codigo
|
|
2. Todas las trazas muestran tareas completadas
|
|
3. Build de backend exitoso
|
|
4. TypeScript de mobile sin errores
|
|
5. Tests E2E pasando (53 tests)
|
|
6. Documentacion consistente entre archivos
|
|
|
|
---
|
|
|
|
**Plan Creado:** 2026-01-10
|
|
**Estado:** Listo para Ejecucion
|
|
**Aprobado por:** Agente Orquestador
|