DesarrolladoresGuías
Guías
Guías prácticas paso a paso para las tareas más comunes al trabajar en el monorepo ixiclinic.
Recetas concretas para "cómo hacer X". Cada guía sigue el patrón real del código — léelas junto a un módulo existente para no salirte de la convención.
¿Cuál necesito?
| Guía | Úsala cuando… |
|---|---|
| Añadir un módulo a la API | Necesitas un nuevo dominio en el backend (rutas REST, lógica de negocio y validación). |
| Añadir una pantalla al admin | Vas a crear una vista nueva en el dashboard del laboratorio (apps/admin). |
| Escribir una server action | El admin/console/portal necesita leer o escribir datos contra la API. |
| Añadir una tabla al schema | Vas a persistir datos nuevos (tabla Drizzle + migración en dev y prod). |
Nota: En el admin no hay fetch del lado del cliente. Toda lectura/escritura pasa por server actions (
apps/admin/src/actions/). Si tu pantalla necesita datos, primero existe la server action; luego la pantalla.
Orden típico de una feature completa
Una feature de punta a punta suele tocar las cuatro guías en este orden:
- Tabla del schema — dónde viven los datos.
- Módulo de la API — los endpoints REST.
- Server action — el puente entre el admin y la API.
- Pantalla del admin — la UI.