# ERP Básico SaaS - Solución Integral Austera

## Descripción

Sistema ERP completo pero austero, diseñado para PyMEs que necesitan funcionalidad integral sin la complejidad ni el costo de soluciones enterprise.

## Target de Mercado

- PyMEs con 5-50 empleados
- Negocios que necesitan más que un POS
- Empresas que buscan digitalización económica
- Comercios con operaciones de compra-venta
- Pequeñas manufacturas

## Precio

**~300-500 MXN/mes** (según módulos activos)

## Plan Base (300 MXN/mes)

| Módulo | Incluido | Descripción |
|--------|----------|-------------|
| Autenticación | Obligatorio | Login, 2FA, roles básicos |
| Usuarios | Obligatorio | Hasta 5 usuarios |
| Multi-tenant | Obligatorio | Aislamiento por empresa |
| Catálogos | Incluido | Productos, categorías, unidades |
| Inventario | Incluido | Stock, movimientos, alertas |
| Ventas | Incluido | Cotizaciones, pedidos, facturas |
| Compras | Incluido | Órdenes de compra, proveedores |
| Clientes | Incluido | CRM básico, contactos |
| Reportes | Incluido | Dashboard, reportes esenciales |

## Módulos Opcionales

| Módulo | Precio | Descripción |
|--------|--------|-------------|
| Contabilidad | +150 MXN/mes | Pólizas, balances, estados financieros |
| RRHH | +100 MXN/mes | Empleados, nómina básica, asistencia |
| Facturación CFDI | +100 MXN/mes | Timbrado SAT México |
| Usuarios extra | +50 MXN/usuario | Más de 5 usuarios |
| WhatsApp Bot | Por consumo | Consultas y notificaciones |
| Soporte Premium | +200 MXN/mes | Atención prioritaria |

## Stack Tecnológico

- **Backend:** Node.js + Express/NestJS + TypeScript
- **Frontend:** React 18 + Vite + Tailwind CSS
- **Database:** PostgreSQL 15+ con RLS
- **Cache:** Redis (compartido)
- **Auth:** JWT + bcrypt

## Arquitectura

```
erp-basico/
├── backend/
│   ├── src/
│   │   ├── modules/
│   │   │   ├── auth/           # Autenticación
│   │   │   ├── users/          # Gestión usuarios
│   │   │   ├── companies/      # Multi-tenant
│   │   │   ├── catalogs/       # Catálogos maestros
│   │   │   ├── inventory/      # Inventario
│   │   │   ├── sales/          # Ventas
│   │   │   ├── purchases/      # Compras
│   │   │   ├── partners/       # Clientes/Proveedores
│   │   │   └── reports/        # Reportes
│   │   └── shared/
│   │       ├── guards/
│   │       ├── decorators/
│   │       └── utils/
├── frontend/
│   ├── src/
│   │   ├── features/           # Por módulo
│   │   ├── shared/             # Componentes base
│   │   └── app/                # Layout, routing
├── database/
│   └── ddl/
│       ├── 00-extensions.sql
│       ├── 01-schemas.sql
│       ├── 02-core-tables.sql
│       └── 03-business-tables.sql
└── orchestration/
```

## Base de Datos (~40 tablas)

### Schema: `auth`
- users, roles, permissions, sessions, tokens

### Schema: `core`
- companies, settings, sequences, audit_logs

### Schema: `catalog`
- products, categories, units, taxes, payment_methods

### Schema: `inventory`
- warehouses, stock_moves, stock_quants, adjustments

### Schema: `sales`
- quotations, sale_orders, invoices, payments

### Schema: `purchases`
- purchase_orders, supplier_invoices, receipts

### Schema: `partners`
- partners, contacts, addresses

### Schema: `reports`
- report_configs, saved_reports

## Diferenciación vs POS Micro

| Aspecto | POS Micro | ERP Básico |
|---------|-----------|------------|
| Precio | 100 MXN | 300-500 MXN |
| Tablas BD | ~10 | ~40 |
| Módulos | 4 | 10+ |
| Usuarios | 1 | 5+ |
| Compras | No | Sí |
| Inventario | Básico | Completo |
| Reportes | Mínimos | Dashboard |
| Facturación | No | Opcional |
| Contabilidad | No | Opcional |

## Herencia del Core

Este producto hereda **directamente** de `erp-core`:

| Componente | % Herencia | Adaptación |
|------------|------------|------------|
| Auth | 100% | Ninguna |
| Users | 100% | Ninguna |
| Multi-tenant | 100% | Ninguna |
| Catálogos | 80% | Simplificado |
| Inventario | 70% | Sin lotes/series |
| Ventas | 70% | Sin workflows complejos |
| Compras | 70% | Sin aprobaciones |
| Partners | 90% | Ninguna |
| Reportes | 50% | Subset de reportes |

## Feature Flags

```yaml
# Configuración por tenant
features:
  accounting: false      # +150 MXN
  hr: false              # +100 MXN
  cfdi: false            # +100 MXN
  whatsapp_bot: false    # Por consumo
  advanced_reports: false
  multi_warehouse: false
  serial_numbers: false
  lot_tracking: false
```

## Limitaciones (Por diseño)

- Máximo 10,000 productos
- Máximo 5 usuarios en plan base
- Sin multi-sucursal en plan base
- Sin contabilidad avanzada (solo opcional)
- Sin manufactura
- Sin proyectos
- Sin e-commerce integrado

## Roadmap

### MVP (v1.0)
- [x] Auth completo (heredado de core)
- [ ] Catálogos básicos
- [ ] Inventario simple
- [ ] Ventas (cotización → pedido → factura)
- [ ] Compras básicas
- [ ] Dashboard inicial

### v1.1
- [ ] Módulo contabilidad (opcional)
- [ ] CFDI México (opcional)
- [ ] Reportes adicionales

### v1.2
- [ ] RRHH básico (opcional)
- [ ] Multi-almacén
- [ ] Integraciones bancarias

---

*Producto: ERP Básico SaaS v1.0*
*Precio Target: 300-500 MXN/mes*
*Mercado: PyMEs México*
