Simplapp V2 es la plataforma de gestión empresarial "todo en uno" diseñada para modernizar la operación de las empresas colombianas. Desde facturación electrónica hasta control de inventarios, notas de crédito y CRM, Simplapp ofrece una interfaz unificada e intuitiva para mantener tu negocio bajo control.

"Configura cada proceso, factura en segundos."

• Facturación Electrónica: Genera facturas cumpliendo con la normativa DIAN (CUFE, XML, estados de validación).
• Notas de Crédito: Devoluciones, descuentos comerciales y ajustes de precio vinculados automáticamente a facturas.
• Cotizaciones y Remisiones: Flujo completo de pre-venta.
• Gestión de Pagos: Abonos parciales, múltiples métodos de pago y crédito comercial.
• Estados de Factura: Borrador → Emitida → Pagada / Parcialmente Pagada / Por Pagar / Cancelada.

• Métricas de ventas anuales con filtro por año y comparación vs. año anterior.
• Gráficos interactivos de barras mensuales (Recharts).
• Facturas pendientes de cobro, clientes registrados y ticket promedio.
• Acciones rápidas y recordatorios automáticos.

• Registro detallado de clientes (persona natural y jurídica).
• Vendedores con asignación a facturas.
• Identificación tributaria DIAN (NIT, CC, CE, Pasaporte).

• Gestión de productos y servicios con categorías.
• Múltiples bodegas con seguimiento de stock (Kárdex).
• Listas de precios configurables (mayorista, minorista, porcentaje).
• Movimientos de inventario: entrada, salida, ajuste, transferencia.

• Onboarding guiado paso a paso para nuevas empresas.
• Perfil de empresa con datos fiscales y contables.
• Cuentas bancarias y gestión de tesorería.
• Sistema de notificaciones en tiempo real.

• Interfaz moderna con animaciones fluidas (Framer Motion).
• Skeletons de carga para percepción de rendimiento.
• Exportación masiva a CSV para informes contables.
• Arquitectura multi-dominio: Marketing + Dashboard (app.simplapp.com.co).

📄 Documentación detallada del stack: .docs/stack/technologies.md

.
├── apps/
│   ├── web/                  # Aplicación principal Next.js
│   │   ├── app/
│   │   │   ├── (auth)/       # Login, Register, ForgotPassword, ResetPassword
│   │   │   ├── (dashboard)/  # Dashboard, Ventas, Inventario, Settings
│   │   │   ├── (marketing)/  # Landing page pública por país
│   │   │   ├── Onboarding/   # Configuración inicial de empresa
│   │   │   ├── api/          # 19 módulos de API Routes
│   │   │   └── context/      # Contexts globales (Navigation, AppState)
│   │   └── prisma/           # Schema de Prisma y seeders
│   ├── admin/                # Panel de administración (futuro)
│   └── api/                  # API standalone (futuro)
│
├── packages/
│   ├── domain/               # Lógica de negocio pura (sin dependencias UI)
│   │   ├── entities/         # Bill, Client, Company, CreditNote, Product...
│   │   ├── schemas/          # Zod schemas (auth, bills, onboarding)
│   │   └── utils/            # Utilidades de negocio (billing calculations)
│   │
│   ├── interfaces/           # Capa de infraestructura y comunicación
│   │   ├── hooks/features/   # Custom hooks por dominio (useBills, useClients...)
│   │   ├── repositories/     # Repositorios Prisma (Bill, Client, CreditNote, User)
│   │   ├── services/         # Servicios de negocio (BillService, CreditNoteService...)
│   │   ├── contexts/         # Contextos compartidos
│   │   └── types/            # Tipos compartidos
│   │
│   ├── ui/                   # Sistema de diseño (Storybook)
│   │   ├── atoms/            # Componentes base (Button, Input, Badge...)
│   │   ├── molecules/        # Componentes compuestos
│   │   ├── organisms/        # Componentes complejos
│   │   └── hooks/            # Hooks de UI
│   │
│   └── config/               # Configuración compartida (tailwind preset)
│
├── tools/
│   ├── prompts/              # Prompts para agentes IA
│   └── seeders/              # Scripts de seed de datos
│
├── .docs/                    # 📚 Documentación técnica completa
│   ├── architecture/         # Arquitectura de datos y routing
│   ├── api/                  # Documentación de endpoints
│   ├── guides/               # Guías de implementación, commits, deployment...
│   ├── modules/              # Documentación por módulo
│   ├── diagrams/             # Diagramas del sistema
│   ├── runbooks/             # Playbooks operacionales
│   ├── decisions/            # Decisiones arquitectónicas (ADR)
│   └── stack/                # Detalle del stack tecnológico
│
└── .agents/                  # 🤖 Configuración de agentes IA
    ├── CLAUDE/               # Agente Arquitecto
    ├── GEMINI/               # Agente Desarrollador Iterativo
    ├── skills/               # Skills especializados (GSAP, refactoring, design)
    └── instructions.md       # Reglas compartidas

La API de Simplapp expone 19 módulos a través de Next.js API Routes:

• Node.js v20 o superior.
• pnpm v10+ (instalado globalmente).
• Instancia de PostgreSQL activa.

1. Clonar el repositorio:

   git clone https://github.com/Santy401/SimplappV2.git
   cd SimplappV2

2. Instalar dependencias:

   pnpm install

3. Configurar Variables de Entorno:

   cp apps/web/.example.env apps/web/.env

   Edita .env con tus credenciales de base de datos y secretos JWT.

4. Preparar Base de Datos:

   cd apps/web
   npx prisma generate
   npx prisma migrate dev

5. Seed de datos (opcional):

   pnpm db:seed

6. Iniciar servidor de desarrollo:

   pnpm dev        # Todos los packages
   pnpm dev:web    # Solo la app web

   Visita http://localhost:3000.

Este proyecto utiliza dos agentes especializados de IA para asistir en el desarrollo:

• Claude (.agents/CLAUDE/): Arquitecto — planificación, diseño de features y refactors complejos.
• Gemini (.agents/GEMINI/): Desarrollador Iterativo — iteración rápida, bug fixing y ejecución.

Las instrucciones compartidas están en .agents/instructions.md y las reglas generales para agentes en AGENTS.md.

Este es un proyecto privado para Simplapp V2. Si eres parte del equipo de desarrollo:

1. Lee la Guía de Commits antes de subir cambios.
2. Consulta la Guía de Implementación para crear nuevas features.
3. Asegúrate de pasar pnpm build && pnpm check-types && pnpm lint antes de hacer push.

Hecho con ❤️ por el equipo de Simplapp.