# Arquitectura técnica

## 1. Objetivo

Entregar un sistema trazable para investigación de jurisprudencia administrativa chilena y redacción asistida de oficios. La respuesta debe mantener una separación explícita entre:

- antecedentes entregados por el usuario;
- normas vigentes;
- jurisprudencia administrativa recuperada;
- interpretación de la inteligencia artificial;
- conclusión propuesta;
- borrador sujeto a revisión humana.

## 2. Componentes

### Aplicación PHP

Gestiona autenticación, consultas, historial, análisis, fuentes, revisión y exportación.

### MySQL/MariaDB

Almacena usuarios, consultas, análisis, fuentes y registro de auditoría.

### OpenAI Responses API

Ejecuta razonamiento y búsqueda web. La herramienta `web_search` se configura con dominios oficiales permitidos y búsqueda obligatoria.

### Fuentes externas

- Contraloría General de la República.
- LeyChile / Biblioteca del Congreso Nacional.
- Diario Oficial.
- ChileCompra para pronunciamientos e instructivos relacionados con contratación pública.

## 3. Flujo de análisis

```text
Consulta del usuario
        |
        v
Normalización de hechos y pregunta
        |
        v
Búsqueda web en dominios oficiales
        |
        v
Recuperación de texto, URL, título y citas
        |
        v
Análisis jurídico estructurado
        |
        v
Validación de dominio y almacenamiento
        |
        v
Revisión humana
        |
        v
Exportación del borrador de oficio
```

## 4. Tablas

### users

Usuarios, roles, estado y último acceso.

### legal_queries

Pregunta jurídica, hechos, organismo, calidad jurídica, producto y estado.

### legal_analyses

Respuesta generada, modelo, identificador de respuesta, nivel de respaldo, respuesta cruda y revisión.

### analysis_sources

Fuente, dominio, tipo documental y comprobación contra la lista permitida.

### audit_logs

Acciones relevantes, entidad, usuario, IP y metadatos.

## 5. Controles de calidad

- Búsqueda obligatoria para cada análisis.
- Lista blanca de dominios.
- Conservación de respuesta cruda para auditoría técnica.
- Fuentes visibles y clicables.
- Estado separado entre analizado y revisado.
- Advertencia permanente de borrador.
- No se permite afirmar certeza cuando la evidencia es insuficiente.

## 6. Riesgos que deben resolverse antes de producción

### Variación de sitios oficiales

La interfaz o indexación de Contraloría puede cambiar. La capa de búsqueda debe permanecer desacoplada para reemplazar proveedores o incorporar una base local.

### Documentos incompletos

Una página encontrada puede contener solo un resumen. La siguiente fase debe descargar y validar el documento completo cuando exista.

### Evolución jurisprudencial

No basta con encontrar un dictamen coincidente. Se debe comprobar si fue reconsiderado, complementado o limitado posteriormente.

### Información reservada

No deben enviarse documentos con datos personales, reservados o secretos a un servicio externo sin autorización institucional y evaluación jurídica/técnica.

### Alucinaciones

La IA puede equivocarse. Los números, fechas, artículos y citas deben revisarse desde la fuente oficial antes de firmar un oficio.

## 7. Evolución a una solución robusta

1. Repositorio local de dictámenes validados.
2. Extracción de metadatos y texto completo.
3. Segmentación en fragmentos con referencia a página y párrafo.
4. Índice FULLTEXT y vectorial.
5. Grafo de relaciones entre dictámenes.
6. Alertas de nuevos pronunciamientos.
7. Plantillas por institución y materia.
8. Versionado y aprobación formal.
9. Firma electrónica y expediente.