> For the complete documentation index, see [llms.txt](https://senselab.gitbook.io/senselab-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://senselab.gitbook.io/senselab-docs/docs.md).

# Documentación del Proyecto Senselab Core API

**Última actualización:** Abril 2026 — v5.0.1

![PHPStan Level 8](/files/mx2kRR79v8iUwuQEtEvM) ![Audit Score 9.2/10](/files/O14Yje5WoXGNngc3Flr7) ![Hacienda v4.4 Compliance](/files/3K76OlCo48o6Moe3cMpi) ![AI Services](/files/5yWU2QsNCgNIFuSRz1to) ![Multi-Tenant](/files/LFn3sbe5Xd0sjgjLZGue)

Este directorio contiene toda la documentación organizada del proyecto.

## 📁 Estructura

```
docs/
├── api/           # Documentación de la API (controllers, models, policies)
├── archive/       # Documentación histórica (fases completadas, sprints, sesiones)
├── database/      # Configuración y esquema de base de datos
├── diagrams/      # 📊 Diagramas de arquitectura, ERDs, flujos, benchmarks (Mermaid)
├── guides/        # Guías de instalación, docker, testing, refactorización
├── hacienda/      # Integración con Ministerio de Hacienda CR (normativa + diagramas)
├── images/badges/ # 🏆 Badges SVG de auditoría y métricas
├── sprints/       # Documentación de sprints y resúmenes ejecutivos
├── examples.http  # Ejemplos REST Client para probar endpoints
└── *.md           # Documentos de referencia activa
```

## 📖 Documentos Principales

| Archivo                                                                 | Descripción                          |
| ----------------------------------------------------------------------- | ------------------------------------ |
| [README.md](/senselab-docs/readme.md)                                   | Documentación principal del proyecto |
| [ESTADO\_ACTUAL\_PROYECTO.md](/senselab-docs/estado_actual_proyecto.md) | Estado actual con métricas reales    |
| [CHANGELOG.md](/senselab-docs/changelog.md)                             | Historial de cambios                 |
| [SECURITY.md](/senselab-docs/security.md)                               | Políticas de seguridad               |

## 📘 Curso y Glosario

| Archivo                                                                                         | Descripción                                                                                                               |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| [Curso Completo: De Cero a Experto](/senselab-docs/docs/curso_completo_senselab_core_api.md)    | Curso autodidacta integral — arquitectura, módulos, seguridad, testing, despliegue, IA, facturación electrónica y roadmap |
| [Glosario Completo de Terminología](/senselab-docs/docs/glosario_completo_senselab_core_api.md) | Referencia exhaustiva de toda la terminología: modelos, servicios, DTOs, traits, eventos, jobs, observers, config y más   |

## � Diagramas de Arquitectura (NUEVO)

| Diagrama                                                                                          | Tipo          | Audiencia               |
| ------------------------------------------------------------------------------------------------- | ------------- | ----------------------- |
| [Arquitectura Multi-Tenant](/senselab-docs/docs/diagrams/01-arquitectura-multi-tenant.md)         | Topología     | Desarrolladores, DevOps |
| [Flujo Facturación Electrónica](/senselab-docs/docs/diagrams/02-flujo-facturacion-electronica.md) | Secuencia     | Desarrolladores, QA     |
| [Ciclo de Vida del Dato con IA](/senselab-docs/docs/diagrams/03-ciclo-vida-dato-ia.md)            | Flujo         | Ejecutivos, Ventas      |
| [Precisión de Servicios IA](/senselab-docs/docs/diagrams/04-precision-servicios-ia.md)            | Gráficos      | Ejecutivos, Ventas      |
| [ERD Módulo Contable](/senselab-docs/docs/diagrams/05-erd-modulo-contable.md)                     | ERD           | Desarrolladores         |
| [ERD Módulo Logística](/senselab-docs/docs/diagrams/06-erd-modulo-logistica.md)                   | ERD           | Desarrolladores         |
| [Matriz RBAC Seguridad](/senselab-docs/docs/diagrams/07-matriz-rbac-seguridad.md)                 | Tabla + Grafo | Admins, Seguridad       |
| [Benchmarks Rendimiento Redis](/senselab-docs/docs/diagrams/08-benchmarks-rendimiento-redis.md)   | XY Chart      | Ventas, DevOps          |

> Ver el [índice completo de diagramas](/senselab-docs/docs/diagrams.md) con resumen ejecutivo y badges.

## �📄 Documentos de Referencia Activa (este directorio)

| Archivo                                                                                                               | Descripción                                                                   |
| --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| [IA\_FUNCIONALIDADES.md](/senselab-docs/docs/ia_funcionalidades.md)                                                   | Módulo de Inteligencia Artificial (10 servicios, 32 endpoints)                |
| [VALORACION\_COMERCIAL\_Y\_PRICING.md](/senselab-docs/docs/valoracion_comercial_y_pricing.md)                         | 💰 Valoración comercial, estudio de mercado y estrategia de pricing (4 tiers) |
| [KNOWN\_WARNINGS.md](/senselab-docs/docs/known_warnings.md)                                                           | Warnings conocidos y aceptados (PHPStan/SonarQube)                            |
| [PENDIENTES\_PROYECTO.md](/senselab-docs/docs/pendientes_proyecto.md)                                                 | Lista de pendientes y TODOs                                                   |
| [MAPA\_ESTRUCTURAL\_API.txt](https://github.com/jeremy-sud/Senselab_Core_API/blob/main/docs/MAPA_ESTRUCTURAL_API.txt) | Mapa estructural de la arquitectura                                           |
| [release\_checklist.md](/senselab-docs/docs/checklist-pre-release-senselab-cast-api.md)                               | Checklist pre-release para producción                                         |
| [examples.http](https://github.com/jeremy-sud/Senselab_Core_API/blob/main/docs/examples.http)                         | Ejemplos REST Client para probar endpoints                                    |

## 📊 Estado Actual (Abril 2026 — v5.0.1)

| Métrica               | Valor                                      |
| --------------------- | ------------------------------------------ |
| **Controladores API** | 96                                         |
| **Modelos Eloquent**  | 98                                         |
| **Tests**             | 959+ passing (154 archivos)                |
| **Servicios**         | 67 (10 IA + 9 Hacienda + 48 core)          |
| **FormRequests**      | 175                                        |
| **Resources**         | 81                                         |
| **Policies**          | 80                                         |
| **Migraciones**       | 103                                        |
| **DTOs**              | 63 (\~65% cobertura)                       |
| **PHPStan**           | Level 8 — 0 errores                        |
| **Auditoría**         | 9.2/10                                     |
| **Hacienda v4.4**     | 38/38 compliance (100%)                    |
| **Rutas**             | 16 archivos particionados en `routes/api/` |
| **Fases completadas** | 1-22 ✅ (Roadmap 100%)                      |

## 🚀 Guías Rápidas

### Instalación

* [Installation Guide](/senselab-docs/docs/guides/installation_guide.md) - Instalación completa
* [Docker Guide](/senselab-docs/docs/guides/docker_guide.md) - Configuración Docker
* [Docker Quickstart](/senselab-docs/docs/guides/docker_quickstart.md) - Inicio rápido con Docker
* [Instalación Docker Resumen](/senselab-docs/docs/guides/instalacion_docker_resumen.md) - Resumen rápido

### Desarrollo

* [Contributing](/senselab-docs/docs/guides/contributing.md) - Guía de contribución
* [Colaboradores README](/senselab-docs/docs/guides/colaboradores_readme.md) - Onboarding para colaboradores
* [Testing Guide](/senselab-docs/docs/guides/testing_guide.md) - Cómo ejecutar tests
* [Guía Datos Testeo](/senselab-docs/docs/guides/guia_datos_testeo.md) - Datos de prueba
* [Como Probar API](/senselab-docs/docs/guides/como_probar_api.md) - Probar endpoints
* [Setup VS Code](/senselab-docs/docs/guides/setup_extensiones_vscode.md) - Extensiones recomendadas
* [Generador de Módulos](/senselab-docs/docs/guides/generador_modulos.md) - Crear nuevos módulos ERP
* [Refactorización Controladores](/senselab-docs/docs/guides/refactorizacion_controladores.md) - Patrón Service Layer

### API

* [API Documentation](/senselab-docs/docs/api/api_documentation.md) - Endpoints completos
* [Controllers Summary](/senselab-docs/docs/api/controllers_summary.md) - Resumen de controllers
* [Controllers Complete](/senselab-docs/docs/api/controllers_complete_summary.md) - Detalle completo
* [Models Relations](/senselab-docs/docs/api/models_relations.md) - Relaciones de modelos
* [FormRequests Guide](/senselab-docs/docs/api/formrequests_usage_guide.md) - Validación
* [Policies Guide](/senselab-docs/docs/api/policies_guide.md) - Autorización RBAC

### Inteligencia Artificial 🤖

* [IA Funcionalidades](/senselab-docs/docs/ia_funcionalidades.md) - Documentación completa
* **10 Servicios**: OCR, Chatbot, Predicciones, Anomalías, Contenido, CABYS, Credit Scoring
* **32 Endpoints** bajo `/api/ai/`

### Hacienda Costa Rica

* [Facturación Electrónica Setup](/senselab-docs/docs/hacienda/facturacion_electronica_setup.md) - Configuración FE
* [Facturación Electrónica API](/senselab-docs/docs/hacienda/facturacion_electronica_api.md) - Endpoints FE
* [Análisis v4.4](/senselab-docs/docs/hacienda/analisis_hacienda_cr_v44_completo.md) - Análisis completo
* [Plan Implementación v4.4](/senselab-docs/docs/hacienda/plan_implementacion_v44_hacienda.md) - Plan detallado

### Base de Datos

* [Database README](/senselab-docs/docs/database/database_readme.md) - Esquema de BD
* [Database Config](/senselab-docs/docs/database/database_config.md) - Configuración

### Infraestructura

* [CI/CD Guide](/senselab-docs/docs/guides/ci_cd_guide.md) - Pipeline de integración continua
* [Backup Strategy](/senselab-docs/docs/guides/backup_strategy.md) - Estrategia de backups
* [Multi Tenancy](/senselab-docs/docs/guides/multi_tenancy.md) - Arquitectura multi-tenant
* [Sentry Setup](/senselab-docs/docs/guides/sentry_setup.md) - Monitoreo de errores
* [Branding](/senselab-docs/docs/guides/branding.md) - Guía de marca

## 📊 Sprints

Los documentos de sprints completados están en `sprints/`:

| Sprint   | Estado | Documento                                                                                        |
| -------- | ------ | ------------------------------------------------------------------------------------------------ |
| Sprint 1 | ✅      | [Policies & RBAC](/senselab-docs/docs/sprints/sprint_1_completado_100.md)                        |
| Sprint 2 | ✅      | [Controllers & Bugs](/senselab-docs/docs/sprints/sprint_2_completado_100.md)                     |
| Sprint 3 | ✅      | [Cache & Performance](/senselab-docs/docs/sprints/sprint_3_optimizacion_cache.md)                |
| Sprint 4 | ✅      | [Redis Cache](/senselab-docs/docs/sprints/sprint_4_cache_redis_completado.md)                    |
| Sprint 5 | ✅      | [RBAC Tests](/senselab-docs/docs/sprints/sprint_5_rbac_tests_100_completado.md)                  |
| Sprint 6 | ✅      | [Cache Optimization](/senselab-docs/docs/sprints/sprint_6_cache_optimization.md)                 |
| Sprint 7 | ✅      | [Controllers/Policies](/senselab-docs/docs/sprints/sprint_7_completitud_controllers_policies.md) |
| Sprint 8 | ✅      | [Módulo IA + PHPStan](/senselab-docs/docs/sprints/sprint_8_completo.md)                          |
| Sprint 9 | ✅      | [PHPUnit Attributes](/senselab-docs/docs/sprints/sprint_9.1_phpunit_attributes.md)               |
| FASE 10  | ✅      | Service Layer + CQRS                                                                             |
| FASE 11  | ✅      | Test fixes + Production bugs                                                                     |

## 📦 Archivos Históricos

La carpeta `archive/` contiene documentación histórica que ya no es activa pero se preserva para referencia:

* Documentos de fases completadas (FASE 1-11)
* Resúmenes de sesiones de trabajo
* Auditorías y análisis anteriores
* Planes de implementación completados
* Backups de archivos refactorizados


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://senselab.gitbook.io/senselab-docs/docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.