Documentación Técnica de uunit9

Documentación Técnica de uunit9

Bienvenido a la documentación para desarrolladores de uunit9, la plataforma integral de Punto de Venta (POS), Cocina (KDS), Gestión de Caja, Inventario y Compras para la industria gastronómica.

Mapa del Repositorio

El proyecto está estructurado como un monorepo utilizando pnpm workspaces y Turborepo:

• apps/api: Servidor Backend REST desarrollado con Hono / Nitro, integrado con Better Auth, Drizzle ORM y tareas programadas (scheduler.ts).
• apps/platform: Aplicación Frontend SPA desarrollada con React, Vite, TanStack Router, Tailwind CSS y Radix / shadcn UI.
• apps/docs: Sitio de documentación generado con Astro Starlight.
• packages/db: Capa de persistencia con Drizzle ORM, esquemas PostgreSQL, migraciones y datos de prueba (seed.ts).
• packages/shared: Tipos, esquemas Zod de validación y utilidades compartidas entre backend y frontend.
• packages/config: Configuraciones base compartidas de TypeScript y Biome.

Secciones de la Documentación

1. Arquitectura del Sistema — Estructura del monorepo y flujo de datos de extremo a extremo.
2. Primeros Pasos para Desarrolladores — Configuración del entorno local y gestión de la base de datos.
3. Flujos de Dominio — Ciclo de vida de órdenes POS, sesiones de caja y compras/aprobaciones.
4. Referencia de API — Tabla completa de endpoints REST, autenticación y formato de errores.
5. Testing y CI — Cobertura de pruebas con Vitest, pruebas de humo y pipelines.
6. Deploy de Producción — Topología de producción: Cloudflare, Railway, Neon, Upstash y checklist de despliegue.