📚 Betali Documentation

Esta carpeta contiene toda la documentación organizada del proyecto Betali.

📂 Estructura de Carpetas

/architecture/

Documentación de arquitectura del sistema:

• SAAS_ARCHITECTURE.md - Arquitectura SaaS multi-tenant (LEER PRIMERO)
• BETALI_MCP_DOCS.md - Documentación MCP con patrones establecidos
• DATABASE_SCHEMA.md - Esquema de base de datos
• BACKEND_CONFIGURED_PAGES.md - Páginas configuradas en backend
• PAYMENT-SYSTEM-ARCHITECTURE.md - Arquitectura del sistema de pagos
• FULFILLMENT-SYSTEM.md - Sistema de cumplimiento de órdenes

/prds/

Product Requirements Documents (especificaciones de features):

• PRD-01-Sales-Order-Management.md - Gestión de órdenes de venta
• PRD-02-Purchase-Order-System.md - Sistema de órdenes de compra
• PRD-03-Pricing-Tax-Management.md - Gestión de precios e impuestos
• PRD-04-SaaS-Signup-Onboarding.md - Registro y onboarding SaaS
• PRD-05-Inventory-Alerts-Notifications.md - Alertas de inventario
• PRD-06-Production-Manufacturing-Movements.md - Sistema de elaboración/producción (BOM)
• PRD-PRICING-SYSTEM.md - Sistema de precios
• PRD-SUBSCRIPTION-BILLING-SYSTEM.md - Sistema de facturación y suscripciones
• PRD_ORGANIZATION_LIMITS.md - Límites de organizaciones

/roadmaps/

Roadmaps y reportes de progreso:

• MVP_ROADMAP.md - Roadmap del MVP
• MVP-STATUS-REPORT.md - Reporte de estado del MVP
• MVP-PROGRESS-ANALYSIS.md - Análisis de progreso MVP
• MVP-FINAL-READINESS-REPORT.md - Reporte de preparación final MVP
• MVP-LAUNCH-CRITICAL-GAPS.md - Gaps críticos para lanzamiento
• PRODUCTION_READY_ROADMAP.md - Roadmap para producción
• ROADMAP-ACTUALIZADO-*.md - Roadmaps actualizados
• ROADMAP-MISSING-FEATURES.md - Features faltantes

/testing/

Guías y documentación de testing:

• E2E-TESTING-GUIDE.md - Guía de testing end-to-end
• TESTING-INSTRUCTIONS.md - Instrucciones generales de testing
• UNIT-TESTING-PLAN.md - Plan de testing unitario
• STOCK-RESERVATION-TEST-GUIDE.md - Guía de testing de reservas de stock
• ROLES-PERMISSIONS-TESTING-RECOMMENDATIONS.md - Testing de roles y permisos
• VALIDATION-CHECKLIST-WEEKS-1-3.md - Checklist de validación
• READY-TO-TEST-CHECKLIST.md - Checklist pre-testing
• SMOKE-*.md - Smoke tests

/implementation/

Guías de implementación de features:

• PHASE1-IMPLEMENTATION-GUIDE.md - Guía de implementación Fase 1
• PHASE1-QUICK-START.md - Quick start Fase 1
• PRICING-SYSTEM-IMPLEMENTATION.md - Implementación sistema de precios
• FRONTEND-STOCK-VALIDATION-IMPLEMENTATION.md - Validación de stock frontend
• STRIPE-MIGRATION-READY.md - Migración a Stripe
• TAX_MANAGEMENT_SYSTEM_DOCS.md - Sistema de gestión de impuestos

/cleanup/

Documentación de limpieza de código:

• CLEANUP_ANALYSIS.md - Análisis de código muerto y obsoleto
• CLEANUP_PROMPT.md - Prompt para agente de limpieza
• CLEANUP_REPORT.md - Reporte de limpieza ejecutada

/sessions/

Notas de sesiones de desarrollo:

• NEXT-SESSION-*.md - Instrucciones para próximas sesiones
• START-*.md - Puntos de inicio
• LEEME-PRIMERO.md - Documento de inicio rápido
• DIA2-*.md - Notas del día 2
• WEEK3-*.md - Notas de semana 3
• PROXIMA-*.md - Próximas tareas

Raíz de /docs/

• CHANGELOG-*.md - Cambios y merges históricos
• README.md - Este archivo

🎯 Por Dónde Empezar

Si eres nuevo en el proyecto:

1. Lee architecture/SAAS_ARCHITECTURE.md para entender la arquitectura
2. Revisa architecture/BETALI_MCP_DOCS.md para patrones y best practices
3. Consulta roadmaps/MVP-STATUS-REPORT.md para estado actual
4. Revisa los PRDs relevantes en /prds/ según el feature que trabajes

📝 Notas

• Documentos en /sessions/ son históricos y de referencia
• /cleanup/ contiene análisis y reportes de limpieza de código
• PRDs son las especificaciones autoritativas de features
• /architecture/ contiene decisiones de arquitectura importantes

---

Documentación organizada el 2026-01-21