rckrdmrd/workspace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
513a86ceee
workspace/projects/erp-suite/apps/saas/orchestration/CONTEXTO-SAAS.md
rckrdmrd 2781837d9e feat: Add SaaS products architecture and alignment analysis 
Analysis and Documentation:
- Add ANALISIS-ALINEACION-WORKSPACE-2025-12-08.md with comprehensive gap analysis
- Document SIMCO v3.2 system with 20+ directives
- Identify alignment gaps between orchestration and projects

New SaaS Products Structure:
- Create apps/products/pos-micro/ - Ultra basic POS (~100 MXN/month)
  - Target: Mexican informal market (street vendors, small stores)
  - Features: Offline-first PWA, WhatsApp bot, minimal DB (~10 tables)
- Create apps/products/erp-basico/ - Austere ERP (~300-500 MXN/month)
  - Target: SMBs needing full ERP without complexity
  - Features: Inherits from erp-core, modular pricing

SaaS Layer:
- Create apps/saas/ structure (billing, portal, admin, onboarding)
- Add README.md and CONTEXTO-SAAS.md documentation

Vertical Alignment:
- Verify HERENCIA-ERP-CORE.md exists in all verticals
- Add HERENCIA-SPECS-CORE.md to verticals
- Update orchestration inventories

Updates:
- Update WORKSPACE-STATUS.md with new products and analysis
- Update suite inventories with new structure

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-08 11:34:35 -06:00

2.6 KiB
Raw Blame History

Contexto del Proyecto: SaaS Layer

Identificación

Campo Valor
Nombre SaaS Layer
Tipo Infraestructura
Nivel 2B.1 (Core de Suite)
Suite erp-suite
Ruta Base projects/erp-suite/apps/saas/
Estado En Planificación

Descripción

Capa de servicios compartidos para gestión de multi-tenancy, billing, suscripciones y portal de clientes.

Responsabilidades

  1. Billing - Cobros, suscripciones, facturación
  2. Portal - Self-service para clientes
  3. Admin - Gestión de tenants
  4. Onboarding - Registro de nuevos clientes

Stack Tecnológico

backend:
  runtime: Node.js 20+
  framework: NestJS
  language: TypeScript 5.3+

frontend:
  framework: React 18
  bundler: Vite
  styling: Tailwind CSS

database:
  engine: PostgreSQL 15+
  schema: saas

integrations:
  payments: Stripe, Conekta
  invoicing: PAC CFDI (México)
  notifications: Email, WhatsApp

Variables del Proyecto

PROJECT_NAME: saas-layer
PROJECT_CODE: SAAS
SUITE: erp-suite

# Paths
BILLING_ROOT: apps/saas/billing
PORTAL_ROOT: apps/saas/portal
ADMIN_ROOT: apps/saas/admin
ONBOARDING_ROOT: apps/saas/onboarding

# Database
DB_SCHEMA: saas
MAX_TABLES: 15

Módulos

Módulo Descripción Prioridad
billing Suscripciones y cobros P0
portal Portal de clientes P1
admin Panel de administración P1
onboarding Registro de clientes P0

Planes de Suscripción

ID Plan Precio Target
pos-micro POS Micro 100 MXN/mes Mercado informal
erp-basic ERP Básico 300 MXN/mes PyMEs
erp-pro ERP Pro 500 MXN/mes PyMEs+
vertical-x Vertical 1,000+ MXN/mes Industrias específicas

Dependencias

Productos que dependen de SaaS Layer

  • products/pos-micro - Billing, onboarding
  • products/erp-basico - Billing, portal, onboarding
  • verticales/* - Billing, portal, admin

Servicios externos

  • Stripe - Pagos internacionales
  • Conekta - Pagos México
  • PAC CFDI - Facturación electrónica
  • SendGrid - Email transaccional
  • WhatsApp Business API - Notificaciones

Roadmap

Sprint 1: Billing MVP

  • Modelo de datos
  • Integración Stripe básica
  • Webhook de pagos
  • API de suscripciones

Sprint 2: Onboarding

  • Flujo de registro
  • Selección de plan
  • Configuración inicial
  • Activación automática

Sprint 3: Portal

  • Dashboard cliente
  • Ver facturas
  • Cambiar plan
  • Soporte básico

Última actualización: 2025-12-08