Simplapp V2 🚀

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

"Configura cada proceso, factura en segundos."

---

✨ Características Principales

• 🚀 Facturación Electrónica V1.0: Genera facturas, cotizaciones y remisiones cumpliendo con la normativa DIAN en segundos.
• 📊 Dashboard Inteligente: Visualiza la salud de tu negocio en tiempo real con métricas precisas y gráficos interactivos (Recharts).
• 👥 CRM & Proveedores: Registro detallado de clientes y proveedores para fortalecer tus relaciones comerciales.
• 📦 Control de Inventarios: Seguimiento de stock, bodegas ilimitadas y alertas de vencimiento.
• 📄 Exportación Masiva: Exporta tus datos a CSV profesionalmente para informes contables.
• 🎨 UX Premium: Interfaz moderna con modo oscuro, glassmorphism y animaciones fluidas (Framer Motion).
• 🌐 Arquitectura Multi-dominio: Separación de Marketing y Dashboard mediante subdominios (app.simplapp.com.co).

---

🛠️ Stack Tecnológico

📄 Para una lista detallada de librerías y herramientas, consulta el documento: Stack Tecnológico.

• Framework: Next.js 16 (App Router) + React 19.
• Base de Datos: PostgreSQL + Prisma 7.
• Estilos: Tailwind CSS 4 + Radix UI.
• Estado: TanStack Query (React Query) + Context API.
• Seguridad: JWT (Jose) + Cookies httpOnly + CSRF Protection.

---

📂 Estructura del Proyecto (Monorepo)

.
├── apps/
│   └── web/              # Aplicación principal Next.js (Dashboard + Marketing)
├── packages/
│   ├── ui/               # Sistema de diseño y componentes compartidos
│   ├── domain/           # Lógica de negocio y entidades de base de datos
│   ├── interfaces/       # Hooks, API client y utilidades core
├── .doc/                 # 📚 Documentación técnica detallada
└── .agent/               # Configuración del agente de IA

---

🚀 Guía de Instalación Local

Requisitos Previos

• Node.js (v20 o superior recomendado).
• pnpm (Instalado globalmente).
• Instancia de PostgreSQL activa.

Pasos

1. Clonar el repositorio:

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

2. Instalar dependencias:

   pnpm install

3. Configurar Variables de Entorno: Copia el archivo de ejemplo en apps/web:

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

   Edita .env con tus credenciales de base de datos y JWT.
4. Preparar Base de Datos:

   pnpm --filter web build # Esto genera el cliente de Prisma
   npx prisma migrate dev --schema=apps/web/prisma/schema.prisma

5. Iniciar Servidor de Desarrollo:

   pnpm dev

   Visita http://localhost:3000.

---

📚 Documentación Adicional

• Arquitectura de Routing: Cómo funcionan los subdominios y el SPA.
• Arquitectura de Datos: Flujo de información y contextos globales.
• Guía de Implementación: Pasos para crear una nueva sección desde cero.
• Guía de Skeletons: Cómo usar los estados de carga.
• API Endpoints: Referencia de rutas del servidor.

---

🤝 Contribuciones

Este es un proyecto privado para Simplapp V2. Si eres parte del equipo de desarrollo, asegúrate de seguir la Guía de Commits antes de subir cambios.

Hecho con ❤️ por el equipo de Simplapp.