| id |
title |
type |
status |
version |
priority |
phase |
created_date |
updated_date |
source |
normativas |
| MGN-020-ai-integration |
Modulo AI Integration - Gateway LLM para Clinica Dental |
Module |
Draft |
1.0.0 |
P1 |
Fase IA |
2026-01-13 |
2026-01-13 |
erp-core/MGN-020-ai-integration |
| 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
# 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
Modulo MGN-020 - AI Integration | Clinica Dental
Propagado desde erp-core via erp-clinicas
Actualizado: 2026-01-13
rckrdmrd
27b4e7bccf