Plataforma de inteligencia artificial para el analisis automatizado de contratos y documentos legales del sector minero chileno.
El Analizador de Contratos Mineros es una plataforma web impulsada por inteligencia artificial disenada para transformar la manera en que profesionales legales y de negocios revisan contratos del sector minero en Chile. En lugar de depender exclusivamente de la revision manual — un proceso lento, costoso y propenso a errores humanos — el sistema permite subir documentos y obtener un analisis estructurado de riesgos en minutos.
Propuesta de valor: Reducir el tiempo de revision de contratos de dias o semanas a minutos, manteniendo un nivel de detalle profesional y la capacidad de profundizar en cualquier hallazgo a traves de una conversacion interactiva con la IA.
La plataforma combina tecnicas avanzadas de procesamiento de documentos (incluyendo OCR para documentos escaneados), busqueda semantica vectorial y modelos de lenguaje de ultima generacion (Claude de Anthropic y Gemini de Google) para entregar analisis precisos, contextualizados y trazables hasta la clausula y pagina exacta del documento original.
En el sector minero chileno, la gestion de contratos implica lidiar con documentos extensos, complejos y de alta relevancia legal. Un contrato minero tipico puede tener decenas o cientos de paginas, incluyendo clausulas sobre responsabilidades laborales, medioambientales, penalidades financieras, garantias y jurisdiccion.
La revision manual de un contrato completo puede tomar dias. Cuando hay multiples documentos asociados (anexos, adendas, estados de pago), el tiempo se multiplica.
Clausulas criticas pueden pasar desapercibidas en revisiones manuales, especialmente cuando el volumen de trabajo es alto o los plazos son ajustados.
Cada profesional revisa con sus propios criterios. No existe un marco consistente para evaluar riesgos de manera uniforme entre diferentes contratos o proyectos.
Un proyecto minero involucra contratos, anexos, adendas, tablas de referencia y estados de pago. Cruzar informacion entre ellos manualmente es propenso a errores.
El Analizador de Contratos Mineros aborda cada uno de estos desafios al automatizar la lectura, comprension y evaluacion de documentos utilizando inteligencia artificial. El sistema no reemplaza al profesional — lo potencia, entregandole un primer analisis estructurado sobre el cual puede profundizar, cuestionar y tomar decisiones informadas.
El sistema esta disenado para ser utilizado por diferentes perfiles profesionales dentro del ecosistema de contratos mineros:
Revisa clausulas de riesgo, verifica cumplimiento normativo y evalua implicancias legales de los contratos.
Supervisa el portafolio de contratos de un proyecto, necesita vision ejecutiva rapida de los riesgos principales.
Gestiona el dia a dia del contrato, cruza informacion entre documentos y verifica estados de pago.
Necesita entender riesgos operacionales y financieros sin profundizar en jerga legal.
Nota sobre roles: El sistema permite configurar la perspectiva del analisis segun el rol. Por ejemplo, un analisis desde la perspectiva del "mandante" (quien contrata) enfocara los riesgos de manera distinta a uno desde la perspectiva del "contratista".
El sistema organiza el trabajo en proyectos. Cada proyecto representa un conjunto de documentos relacionados — por ejemplo, todos los contratos y anexos de una faena minera especifica. Dentro de cada proyecto se pueden:
El usuario sube documentos al sistema arrastrando archivos o seleccionandolos desde su computador. El sistema automaticamente:
Documentos escaneados: El sistema es capaz de leer documentos que son imagenes (como fotos de contratos o PDFs generados por escaner) gracias a tecnologia de reconocimiento optico de caracteres (OCR) con soporte para espanol.
La funcionalidad central del sistema. El usuario hace preguntas o solicita analisis, y la IA:
El analisis no es un evento unico — es una conversacion. El usuario puede:
El siguiente diagrama muestra el flujo completo desde que un usuario accede al sistema hasta que obtiene resultados de su analisis:
El siguiente diagrama muestra todas las acciones que un usuario puede realizar dentro del sistema, agrupadas por area funcional:
A continuacion se describe paso a paso que ocurre internamente cuando un usuario sube un documento y solicita su analisis:
El usuario arrastra un archivo PDF o Excel al area de carga. El sistema valida que sea un formato soportado y que no exceda el tamano maximo (100 MB).
Para PDFs digitales, el sistema lee directamente el texto. Para PDFs escaneados (imagenes), utiliza tecnologia OCR con soporte para espanol. Para archivos Excel, convierte las hojas en formato de tabla legible.
El sistema identifica automaticamente las tablas dentro de los documentos, incluso aquellas sin bordes visibles, preservando su estructura original.
El texto se divide en secciones logicas respetando la estructura del contrato: clausulas principales, articulos, subclausulas. Cada seccion mantiene referencia a sus paginas originales.
Cada seccion se convierte en una representacion matematica (embedding) que captura su significado, no solo las palabras. Esto permite buscar por concepto: "penalidades" encontrara secciones sobre "multas" aunque no usen esa palabra exacta.
Los embeddings se almacenan en una base de datos especializada (ChromaDB) optimizada para busquedas por similitud semantica. El documento queda marcado como "listo".
El usuario escribe su pregunta o solicita un analisis. La pregunta tambien se convierte en embedding para buscar las secciones mas relevantes.
El sistema busca en todos los documentos del proyecto, asegurando que cada documento contribuya proporcionalmente a los resultados, evitando que un documento muy largo domine.
Las secciones relevantes se envian al modelo de IA (Claude o Gemini) junto con los criterios de riesgo. La IA evalua cada seccion y genera hallazgos estructurados.
Los resultados se envian al usuario palabra por palabra (streaming), permitiendo ver el analisis mientras se genera. Al finalizar, se muestran los hallazgos como tarjetas organizadas.
Una de las caracteristicas mas poderosas del sistema es la capacidad de mantener conversaciones de multiples turnos con la IA. Esto permite profundizar en hallazgos especificos, pedir aclaraciones o analizar el contrato desde diferentes angulos.
Cada pregunta considera las preguntas y respuestas anteriores. La IA "recuerda" lo que ya se ha discutido.
Cuando la conversacion se vuelve muy larga (mas de 12,000 tokens), el sistema automaticamente resume los turnos antiguos para mantener el contexto sin perder informacion importante.
Se pueden tener varias conversaciones simultaneas sobre el mismo proyecto, cada una con un enfoque diferente.
Cualquier conversacion puede descargarse como documento Markdown, util para generar reportes o compartir hallazgos.
Los criterios son el "lente" a traves del cual la IA analiza los documentos. Permiten personalizar que buscar, desde que perspectiva y con que nivel de importancia. Esto asegura que el analisis sea relevante para el contexto especifico de cada proyecto.
| Elemento | Descripcion | Ejemplo |
|---|---|---|
| Nombre del set | Identificador del conjunto de criterios | "Criterios Mineros Chile - Mandante" |
| Descripcion | Proposito del conjunto | "Evaluacion de riesgos para el mandante en contratos EPC" |
| Rol / Perspectiva | Desde que punto de vista se analiza | "Mandante", "Contratista", "Regulador" |
| Reglas | Lista de condiciones individuales a evaluar | Ver ejemplos abajo |
| Categoria | Condicion | Riesgo |
|---|---|---|
| Penalidades | Multas diarias sin limite o tope maximo | ALTO |
| Plazos | Plazos de ejecucion sin holgura para imprevistos | ALTO |
| Garantias | Boletas de garantia superiores al 15% del valor total | MEDIO |
| Responsabilidad | Clausulas de indemnidad amplias sin excepciones | ALTO |
| Terminacion | Causales de terminacion anticipada unilateral | MEDIO |
| Seguridad | Requisitos de seguridad laboral no alineados con normativa vigente | BAJO |
| Jurisdiccion | Jurisdiccion fuera de Chile o arbitraje extranjero | INFO |
Criterios por defecto: Se puede marcar un set de criterios como "por defecto", el cual se aplicara automaticamente a nuevos proyectos. Los usuarios siempre pueden activar o desactivar criterios adicionales segun necesidad.
El sistema clasifica cada hallazgo en uno de cuatro niveles de riesgo, facilitando la priorizacion de la revision:
Riesgo significativo que requiere atencion inmediata. Clausulas que podrian generar perdidas financieras importantes, responsabilidades desproporcionadas o incumplimientos legales graves.
Ejemplo: "Multas diarias sin tope maximo que podrian superar el valor total del contrato."
Riesgo moderado que debe ser evaluado y posiblemente negociado. Clausulas que representan condiciones desfavorables pero manejables con las precauciones adecuadas.
Ejemplo: "Garantias de fiel cumplimiento del 12% del monto total, ligeramente por sobre el estandar de la industria."
Riesgo menor que conviene tener en cuenta pero no requiere accion urgente. Clausulas que siguen practicas comunes con pequenas desviaciones.
Ejemplo: "Plazo de entrega de documentacion de cierre podria ser ajustado para mayor holgura."
No representa un riesgo en si, pero es informacion relevante que el usuario debe conocer para tener una vision completa del contrato.
Ejemplo: "La jurisdiccion aplicable es la de Santiago, Chile, conforme a la legislacion nacional."
Cada hallazgo generado por la IA incluye los siguientes elementos:
| Campo | Descripcion |
|---|---|
| Clausula | Nombre o numero de la clausula donde se encontro el hallazgo |
| Nivel de Riesgo | ALTO, MEDIO, BAJO o INFO |
| Paginas | Rango de paginas donde se encuentra el texto relevante |
| Descripcion | Explicacion detallada del hallazgo y por que representa un riesgo |
| Documento Fuente | Nombre del archivo del cual proviene (importante en analisis multi-documento) |
| Tipo de Documento | Contrato, adenda, anexo, estado de pago, etc. |
| Regla Activada | Si aplica, la regla del criterio que genero el hallazgo |
| Formato | Tipo de Documento | Descripcion | Procesamiento |
|---|---|---|---|
| PDF Digital | Contrato, Adenda, Anexo | PDFs generados por computador con texto seleccionable | Extraccion directa de texto + deteccion de tablas |
| PDF Escaneado | Contrato, Adenda, Anexo | PDFs que son imagenes (escaner, fotografia) | OCR con reconocimiento optico en espanol |
| Excel (.xlsx) | Estado de Pago, Tabla de Referencia | Planillas con datos tabulares | Conversion a formato de tabla legible |
| Excel (.xls) | Estado de Pago, Tabla de Referencia | Planillas en formato legacy | Conversion a formato de tabla legible |
Documento principal que establece los terminos y condiciones entre las partes.
Modificaciones o agregados al contrato original que alteran clausulas especificas.
Documentos complementarios con especificaciones tecnicas, planos o detalles adicionales.
Planillas con el detalle de avances y pagos realizados o pendientes.
Tablas con precios unitarios, itemizados o datos de referencia para valorizaciones.
Cualquier otro documento relevante al proyecto que no calce en las categorias anteriores.
La interfaz esta disenada para ser intuitiva y eficiente, organizando la informacion en paneles que el usuario puede mostrar, ocultar y redimensionar segun su flujo de trabajo.
Lista de todos los proyectos del usuario. Permite navegar entre proyectos y crear nuevos.
Lista de documentos del proyecto con indicador de estado, tipo y acciones (eliminar, mover a carpeta).
Area principal donde se interactua con la IA. Muestra mensajes, hallazgos y permite escribir preguntas.
Muestra los datos extraidos del contrato: partes, fechas, montos, jurisdiccion.
Muestra los criterios activos y permite seleccionar cuales aplicar al analisis.
Al hacer clic en un hallazgo, abre el PDF en las paginas relevantes para verificar el contexto original.
El sistema implementa multiples capas de seguridad para proteger el acceso y los datos:
Toda la comunicacion entre el navegador del usuario y el servidor esta cifrada con certificados SSL/TLS de Let's Encrypt. Esto impide que terceros intercepten la informacion transmitida.
El acceso al sistema requiere nombre de usuario y contrasena. Sin credenciales validas, no es posible ver ni interactuar con ningun contenido.
Si alguien intenta acceder por HTTP (no cifrado), el sistema automaticamente lo redirige a la version segura HTTPS.
Los documentos y datos se almacenan en el servidor propio, no en servicios de terceros. Solo las consultas a la IA salen del servidor (cifradas) para obtener el analisis.
Nota sobre privacidad: Los fragmentos de texto de los documentos son enviados a los proveedores de IA (Anthropic o Google) para generar el analisis. Estos proveedores tienen politicas de privacidad que impiden el uso de estos datos para entrenamiento de modelos, pero es importante que los usuarios lo tengan presente.
El sistema se ejecuta en un servidor virtual privado (VPS) con la siguiente arquitectura:
Cada vez que se sube un cambio al repositorio de codigo (rama principal en GitHub), un proceso automatizado se encarga de:
Resultado: Los cambios en el codigo se reflejan en produccion en cuestion de minutos, sin intervencion manual y sin interrumpir el servicio para los usuarios activos.
El sistema utiliza una tecnica llamada RAG (Retrieval-Augmented Generation), que combina la busqueda de informacion relevante con la generacion de texto por IA. A continuacion se explica de forma simple como funciona:
| Proveedor | Modelo | Caracteristicas |
|---|---|---|
| Anthropic (Claude) | Claude Opus 4.6 | Maxima capacidad de razonamiento. Ideal para analisis complejos |
| Claude Sonnet 4.6 / 4.5 | Buen balance entre capacidad y velocidad | |
| Claude Haiku 4.5 | Mas rapido y economico. Bueno para consultas simples | |
| Google (Gemini) | Gemini 2.5 Pro | Alta capacidad de razonamiento de Google |
| Gemini 2.5 Flash | Rapido y capaz, buena relacion costo-beneficio | |
| Gemini 2.0 Flash | Velocidad optimizada para respuestas rapidas |
Seleccion de modelo: El usuario puede elegir que modelo usar para cada consulta. Para analisis profundos y criticos se recomienda Claude Opus o Gemini Pro. Para consultas rapidas y exploratorias, Haiku o Flash ofrecen respuestas casi instantaneas a menor costo.
El MVP ha pasado por multiples fases de desarrollo, cada una agregando capacidades significativas:
Carga basica de PDFs y analisis con IA de un solo documento. Interfaz minima para prueba de concepto.
Incorporacion de archivos Excel para analizar estados de pago y tablas de referencia.
Organizacion en proyectos con multiples documentos, carpetas y tipos de archivo.
Capacidad de analizar y cruzar informacion entre todos los documentos de un proyecto simultaneamente.
Sistema de conversaciones multi-turno con historial persistente y compactacion automatica.
Respuestas en tiempo real (token por token) para mejor experiencia de usuario.
Extraccion automatica de metadatos del contrato: partes, fechas, montos, condiciones clave.
Version 0.3.0 — El sistema se encuentra desplegado y operativo en contratos.rstocker.dev con HTTPS, autenticacion, despliegue automatico y todas las funcionalidades descritas en este documento.