Documentación para desarrolladores
Guía técnica del monorepo ixiclinic para el equipo que recibe el proyecto.
ixiclinic es una plataforma SaaS multi-tenant de gestión para laboratorios clínicos en República Dominicana: un solo sistema cubre recepción, facturación con cumplimiento fiscal DGII, laboratorio, imágenes, seguros (ARS), portal del paciente y operación por sucursales.
Esta sección está dirigida al equipo de ingeniería que recibe el proyecto. Documenta cómo está construido el monorepo, cómo levantarlo en local y las convenciones que hay que respetar al tocar el código. No es documentación de usuario final — para eso está el resto del sitio (por ejemplo Primeros pasos).
Mapa de la sección
| Página | De qué trata |
|---|---|
| Arquitectura | Estructura del monorepo, apps desplegables, orden de build de Turbo |
| Setup local | Prerrequisitos, variables de entorno, levantar todo en local |
| Convenciones | Estilo de código, server actions, Zod 4, naming, helpers |
| Multi-tenancy | Aislamiento de datos por tenantId y contexto de tenant |
| Autenticación | JWT, refresh tokens, cookies, superadmin y portal del cliente |
| Guías | Recetas paso a paso para tareas comunes de desarrollo |
| Apps del monorepo | Detalle por aplicación (admin, console, portal, etc.) |
| Base de datos | Esquema Drizzle, migraciones y entornos de PostgreSQL |
| Referencia de API | Módulos del API, rutas públicas y documentación Scalar |
| Operaciones | Despliegue, entornos de producción y monitoreo |
| Known issues | Deuda técnica, gotchas y hallazgos pendientes |
Por dónde empezar
- Setup local — clona, instala y levanta el stack completo para tener algo corriendo lo antes posible.
- Arquitectura — una vez que arranca, entiende cómo encajan las piezas (apps → API → PostgreSQL).
- Convenciones — antes de tu primer cambio, revisa las reglas no negociables (server actions en el admin, Zod 4, path aliases).
Nota: Algunas particularidades del dominio (DGII, ARS, términos clínicos en español) y la mezcla de nombres ES/EN en las rutas son deliberadas. Están explicadas en Convenciones; respétalas en lugar de "normalizarlas".