rckrdmrd
27b4e7bccf
- Update docs/_MAP.md with new phase references - Add docs/04-fase-saas/ phase structure - Add docs/05-fase-ia/ phase structure Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
211 lines
6.7 KiB
Markdown
211 lines
6.7 KiB
Markdown
---
|
|
id: MGN-020-ai-integration
|
|
title: Modulo AI Integration - Gateway LLM para Clinica Dental
|
|
type: Module
|
|
status: Draft
|
|
version: 1.0.0
|
|
priority: P1
|
|
phase: Fase IA
|
|
created_date: 2026-01-13
|
|
updated_date: 2026-01-13
|
|
source: erp-core/MGN-020-ai-integration
|
|
normativas: [NOM-013-SSA2-2015, LFPDPPP]
|
|
---
|
|
|
|
# MGN-020: AI Integration - Gateway LLM para Clinica Dental
|
|
|
|
> Capa de abstraccion unificada para integracion con modelos de lenguaje especializados en odontologia
|
|
|
|
## Resumen Ejecutivo
|
|
|
|
El modulo AI Integration proporciona un gateway centralizado para consumir servicios de modelos de lenguaje (LLM) de multiples proveedores a traves de OpenRouter. Esta adaptado para el dominio odontologico, con conocimiento de nomenclatura dental FDI, tratamientos, y normativas mexicanas de salud bucal.
|
|
|
|
---
|
|
|
|
## 1. Objetivos del Modulo
|
|
|
|
| Objetivo | Descripcion | Prioridad |
|
|
|----------|-------------|-----------|
|
|
| Gateway unificado | API unica para multiples providers LLM | P0 |
|
|
| Fallback automatico | Cambio automatico a modelo backup | P0 |
|
|
| Cost tracking | Registro de costos por clinica | P0 |
|
|
| Streaming | Respuestas en tiempo real via SSE | P1 |
|
|
| Prompt templates dentales | Templates especializados en odontologia | P1 |
|
|
| Rate limiting | Limites por plan de suscripcion | P1 |
|
|
|
|
---
|
|
|
|
## 2. System Prompt Especializado en Odontologia
|
|
|
|
```
|
|
Eres el asistente virtual de {{CLINICA_DENTAL}}, una clinica dental en Mexico.
|
|
|
|
## Especialidades
|
|
- Odontologia general y preventiva
|
|
- Ortodoncia (brackets, alineadores, retenedores)
|
|
- Endodoncia (tratamientos de conductos)
|
|
- Periodoncia (enfermedad periodontal)
|
|
- Estetica dental (blanqueamiento, carillas)
|
|
- Cirugia oral (extracciones, implantes)
|
|
|
|
## Conocimientos Tecnicos
|
|
- Nomenclatura dental FDI (sistema de dos digitos)
|
|
- Cuadrantes dentales:
|
|
* Cuadrante 1: Superior derecho (11-18)
|
|
* Cuadrante 2: Superior izquierdo (21-28)
|
|
* Cuadrante 3: Inferior izquierdo (31-38)
|
|
* Cuadrante 4: Inferior derecho (41-48)
|
|
- Piezas deciduas (temporales):
|
|
* 51-55, 61-65, 71-75, 81-85
|
|
- Estados de piezas: Sano, Caries, Obturacion, Endodoncia, Corona, Ausente
|
|
- Caras dentales: Mesial, Distal, Oclusal, Vestibular, Lingual/Palatino
|
|
|
|
## Normativas
|
|
- NOM-013-SSA2-2015: Prevencion y control de enfermedades bucales
|
|
- COFEPRIS: Regulacion de materiales e insumos
|
|
- NOM-004-SSA3-2012: Expediente clinico
|
|
|
|
## Reglas de Comportamiento
|
|
1. Responde en espanol mexicano profesional pero calido
|
|
2. NUNCA des diagnosticos clinicos - siempre recomienda visita al odontologo
|
|
3. Explica procedimientos de forma clara y sin tecnicismos excesivos
|
|
4. Para citas, usa el sistema de agenda del consultorio
|
|
5. Respeta la confidencialidad del expediente clinico
|
|
6. No compartas informacion de un paciente con otro
|
|
7. Para urgencias (dolor intenso, trauma, sangrado), indica acudir de inmediato
|
|
```
|
|
|
|
---
|
|
|
|
## 3. Modelos Soportados
|
|
|
|
### 3.1 Tabla de Modelos y Costos
|
|
|
|
| Modelo | ID OpenRouter | Input/1M tokens | Output/1M tokens | Uso Dental |
|
|
|--------|---------------|----------------:|-----------------:|------------|
|
|
| Claude 3 Haiku | anthropic/claude-3-haiku | $0.25 | $1.25 | Chat rapido |
|
|
| Claude 3 Sonnet | anthropic/claude-3-sonnet | $3.00 | $15.00 | Consultas complejas |
|
|
| GPT-4 Turbo | openai/gpt-4-turbo | $10.00 | $30.00 | Analisis detallado |
|
|
| GPT-4o-mini | openai/gpt-4o-mini | $0.15 | $0.60 | Alto volumen |
|
|
|
|
### 3.2 Recomendacion por Caso de Uso Dental
|
|
|
|
| Caso de Uso | Modelo Recomendado | Justificacion |
|
|
|-------------|-------------------|---------------|
|
|
| Chat con pacientes | Claude 3 Haiku | Rapido y natural |
|
|
| Explicar tratamientos | Claude 3 Sonnet | Alta calidad |
|
|
| Analisis de caso | GPT-4 Turbo | Profundidad |
|
|
| Recordatorios masivos | GPT-4o-mini | Costo bajo |
|
|
|
|
---
|
|
|
|
## 4. Rate Limits por Plan
|
|
|
|
| Plan | Requests/dia | Tokens/dia | Max Tokens/Request |
|
|
|------|-------------:|-----------:|-------------------:|
|
|
| Consultorio | 0 | 0 | 0 (sin acceso) |
|
|
| Clinica | 0 | 0 | 0 (sin acceso) |
|
|
| Centro Dental | 500 | 100,000 | 2,000 |
|
|
|
|
> Nota: La funcionalidad de IA solo esta disponible en el plan Centro Dental.
|
|
|
|
---
|
|
|
|
## 5. Capacidades Principales
|
|
|
|
### 5.1 Funcionalidades Core
|
|
|
|
- **Chat con Pacientes**: Respuestas a dudas comunes sobre tratamientos
|
|
- **Explicacion de Procedimientos**: Descripcion detallada de tratamientos
|
|
- **Recomendaciones de Cuidado**: Instrucciones pre y post operatorias
|
|
- **Informacion de Precios**: Consulta de costos aproximados (via MCP)
|
|
- **Agendamiento**: Asistencia para agendar citas (via MCP)
|
|
|
|
### 5.2 Seguridad y Normativas
|
|
|
|
| Medida | Implementacion |
|
|
|--------|----------------|
|
|
| API key rotation | Secrets manager con encriptacion |
|
|
| Rate limiting | Por clinica segun plan |
|
|
| Content filtering | OpenRouter builtin |
|
|
| Cost caps | Limite mensual configurable |
|
|
| Audit trail | Log de todas las consultas |
|
|
| NOM-013-SSA2 | No diagnosticar, solo informar |
|
|
| LFPDPPP | No almacenar datos sensibles en prompts |
|
|
|
|
---
|
|
|
|
## 6. Estructura del Modulo
|
|
|
|
```
|
|
MGN-020-ai-integration/
|
|
+-- README.md <- Este archivo
|
|
+-- _MAP.md <- Indice y navegacion
|
|
+-- requerimientos/
|
|
| +-- RF-AI-001.md <- Gateway LLM
|
|
| +-- RF-AI-002.md <- Streaming
|
|
| +-- RF-AI-003.md <- Cost tracking
|
|
| +-- RF-AI-004.md <- Prompt templates dentales
|
|
| +-- INDICE-RF-AI.md
|
|
+-- especificaciones/
|
|
| +-- ET-AI-DATABASE.md <- Modelo de datos
|
|
| +-- ET-AI-BACKEND.md <- API y servicios
|
|
| +-- ET-AI-FRONTEND.md <- UI de chat
|
|
| +-- INDICE-ET-AI.md
|
|
+-- historias-usuario/
|
|
| +-- INDICE-US-AI.md
|
|
+-- implementacion/
|
|
+-- TRACEABILITY.yml
|
|
```
|
|
|
|
---
|
|
|
|
## 7. Dependencias
|
|
|
|
### 7.1 Internas
|
|
|
|
| Modulo | Relacion |
|
|
|--------|----------|
|
|
| MGN-004-tenants | Aislamiento por clinica |
|
|
| MGN-001-auth | Autenticacion JWT |
|
|
| MGN-017-plans | Feature gating (solo Centro Dental) |
|
|
| MGN-022-mcp-server | Herramientas de negocio |
|
|
|
|
### 7.2 Externas
|
|
|
|
| Servicio | Proposito |
|
|
|----------|-----------|
|
|
| OpenRouter API | Gateway multi-provider |
|
|
| Redis | Cache de configuraciones |
|
|
|
|
---
|
|
|
|
## 8. Configuracion
|
|
|
|
```bash
|
|
# OpenRouter
|
|
OPENROUTER_API_KEY=sk-or-xxx
|
|
OPENROUTER_SITE_URL=https://clinica.ejemplo.com
|
|
OPENROUTER_SITE_NAME=Clinica Dental Ejemplo
|
|
|
|
# Defaults para odontologia
|
|
AI_DEFAULT_MODEL=anthropic/claude-3-haiku
|
|
AI_DEFAULT_TEMPERATURE=0.7
|
|
AI_DEFAULT_MAX_TOKENS=1000
|
|
AI_SYSTEM_PROMPT_TYPE=dental
|
|
```
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
- **Fuente**: [erp-core/MGN-020-ai-integration](../../../../../erp-core/docs/05-fase-ia/MGN-020-ai-integration/)
|
|
- **MCP Server**: [MGN-022-mcp-server](../MGN-022-mcp-server/)
|
|
- **OpenRouter Docs**: https://openrouter.ai/docs
|
|
|
|
---
|
|
|
|
*Modulo MGN-020 - AI Integration | Clinica Dental*
|
|
*Propagado desde erp-core via erp-clinicas*
|
|
*Actualizado: 2026-01-13*
|