CChC · Cámara Chilena de la Construcción

Compromiso PRO
Mapa completo del proyecto

Una comunidad digital donde los profesionales de la construcción hacen preguntas de su rubro, se responden entre ellos y reciben además una respuesta automática de un asistente de inteligencia artificial que cita documentos oficiales de la Cámara. Este documento explica, sin tecnicismos, qué es, quiénes participan y cómo viaja la información.

2webapps (portal y panel interno)
1cerebro central que conecta todo
8categorías de conversación
97documentos oficiales en la biblioteca
6agentes automáticos trabajando
01 · La idea

¿Qué es Compromiso PRO?

Piensa en un "foro de expertos de la construcción" con un bibliotecario robot.

Un usuario de la comunidad entra a la webapp del portal, escribe una pregunta (por ejemplo, sobre seguridad laboral, medio ambiente o productividad) y ocurren dos cosas en paralelo:

La comunidad responde

Otros miembros comentan, debaten en hilos de conversación, votan las mejores respuestas y guardan las preguntas que les interesan.

El asistente de IA responde

El Agente Bibliotecario busca en la biblioteca de documentos oficiales de la CChC y redacta una respuesta en vivo, citando las fuentes exactas (PDF, videos o enlaces) para que cualquiera pueda verificarlas.

Detrás de escena, el equipo administrador gestiona todo desde una webapp interna (el backoffice): quién puede entrar, qué documentos conoce el asistente, qué contenido se destaca y qué publicaciones requieren moderación. Todo el contenido pasa por un filtro automático de buenas prácticas antes de publicarse: si un texto o imagen es inapropiado, se rechaza con una explicación y el autor puede corregirlo.

02 · Los actores

Quiénes participan

Participan personas —usuarios de la comunidad y el equipo administrador— y también "agentes" automáticos que operan sin intervención humana.

Usuarios de la comunidad (portal)

Usuario No Socio

Miembro de la comunidad que aún no acredita su vínculo con la CChC. Puede preguntar, responder, votar, guardar publicaciones y administrar su perfil, pero el asistente no le revela el contenido de los documentos exclusivos para socios (le ofrece alternativas abiertas).

cuenta: usuario_socio · sin certificar

Socio

El miembro pleno: acreditó su vínculo y experiencia ante la CChC y porta el "Sello Pro", la insignia de credibilidad visible junto a su nombre. Accede al contenido completo de la biblioteca, incluido el material exclusivo para socios.

cuenta: usuario_socio · certificado

Equipo administrador (backoffice) — roles dinámicos y configurables

Roles a la medida

El backoffice completo es administración del cliente: permite crear cuantos roles se necesiten, definiendo para cada uno una matriz de permisos (ver, crear, editar, eliminar, exportar) módulo por módulo. Los tres roles siguientes son solo los ejemplos que vienen configurados de fábrica.

Moderador

Revisa las publicaciones rechazadas o reportadas y decide: dejar pasar, ocultar con amonestación ("strike") o suspender al autor.

rol de ejemplo: moderador

Administrador

Gestiona el día a día del panel interno según los permisos que su rol tenga asignados en la matriz.

rol de ejemplo: admin

Super Administrador

Control total: crea cuentas y roles, arma la matriz de permisos, cura la biblioteca del asistente de IA, prueba la IA y gestiona el contenido destacado.

rol de ejemplo: super_admin

Agentes (Sin intervención humana)

Agente de Contenido

Lee cada título, texto e imagen antes de publicarse. Si detecta lenguaje ofensivo, spam o imágenes inapropiadas, rechaza la pieza y explica el motivo campo por campo.

Agente de Redacción

Sugiere una versión mejor escrita de cada pregunta. El usuario elige: publicar su texto original o la versión sugerida.

Agente Bibliotecario

Ante cada consulta publicada, busca los documentos más pertinentes de la biblioteca CChC y redacta una respuesta con citas verificables.

Agente de Publicación

Cada 5 minutos revisa las publicaciones "en revisión": cuando todos sus archivos adjuntos fueron aprobados, las publica automáticamente y avisa al autor.

Agente de Imágenes

Analiza automáticamente cada foto o documento adjunto en busca de contenido inapropiado.

Agente de Series

Propone vínculos entre documentos de la biblioteca ("estos dos son ediciones del mismo informe"). Un administrador confirma o descarta cada propuesta.

03 · Las piezas

Las piezas del sistema

El proyecto está construido en 4 piezas de software propias más un conjunto de servicios externos contratados.

Webapp Portal "Compromiso PRO" para la comunidad

La webapp pública de la comunidad. Aquí viven el muro de preguntas, la creación de publicaciones con ayuda de IA, las respuestas, los votos, los guardados, las notificaciones y el perfil de cada usuario.

repositorio: cchc-portal

Webapp Panel interno (Backoffice) para el equipo administrador

La webapp de administración del cliente. Gestión de usuarios y roles dinámicos, biblioteca del asistente de IA, moderación de publicaciones, contenido destacado, categorías/etiquetas y un banco de pruebas de la IA.

repositorio: cchc-backoffice

El Cerebro (servicio central) invisible al público

Ninguna webapp guarda información por su cuenta: ambas le piden todo al Cerebro. Él verifica identidades, aplica los permisos, coordina a los agentes, guarda los datos, envía correos y avisa a quien corresponda.

repositorio: cchc-api-service

El plano de la base de datos herramienta de construcción

Un repositorio que define, paso a paso, la estructura del archivo central de datos (sus "archivadores" y "carpetas") y carga los datos iniciales: roles, categorías, cuentas del equipo y los 97 documentos de la biblioteca.

repositorio: cchc-db-migrate

Servicios externos contratados

Bodega de archivos Amazon S3

Guarda todas las fotos, PDF y documentos que se suben (adjuntos, avatares, biblioteca).

Cartero de correos Amazon SES

Envía los correos: recuperar contraseña, "tu pregunta fue publicada/rechazada", "tienes una nueva respuesta".

Revisor de imágenes Amazon Rekognition

El servicio que el Agente de Imágenes usa para detectar contenido inapropiado en los adjuntos.

Redactor inteligente Claude, de Anthropic

El motor de IA detrás de los agentes de contenido, redacción, bibliotecario y series: filtra, mejora la escritura, analiza documentos y redacta las respuestas con citas.

Huellas de texto OpenAI

Convierte cada fragmento de documento en una "huella numérica" que permite encontrar textos parecidos entre sí.

Lector de documentos LlamaParse

Transforma los PDF de la biblioteca en texto limpio que la IA puede entender.

Catálogo original Notion

La herramienta donde el equipo CChC mantiene su inventario de documentos; el sistema puede sincronizarlo hacia la biblioteca.

Memoria rápida Valkey

Recuerda quién tiene la sesión iniciada y los códigos temporales de recuperación de contraseña.

Alojamiento y despliegue Vercel + Bitbucket

Donde viven publicadas las dos webapps y el mecanismo que instala cada nueva versión.

04 · El ecosistema

El ecosistema Compromiso PRO y sus recorridos

El mapa de cómo se conectan las piezas. Elige un recorrido para ver, sobre el propio diagrama, el camino que sigue la información: los bloques que participan se iluminan con su número de orden y la explicación de cada paso queda a la izquierda, a la par del diagrama.

Selecciona un recorrido arriba para iluminar en el diagrama el camino que sigue la información y leer sus pasos al costado.

🅐 Un usuario publica una pregunta

Portal → Cerebro → agentes de contenido, imágenes, redacción y publicación

El usuario escribe su pregunta en el portal: título, categoría, texto, etiquetas y archivos adjuntos. El borrador se guarda solo en el módulo de Foro del Cerebro mientras escribe; si cierra el navegador, puede retomarlo después.
Al enviar, el Agente de Contenido revisa el texto. Si algo no cumple las normas, la pregunta vuelve con los motivos marcados y el usuario puede corregir. En paralelo, el Agente de Imágenes analiza los adjuntos.
Si el texto pasa el filtro, el Agente de Redacción ofrece una versión mejorada. El usuario compara lado a lado y elige: publicar su original o la sugerida.
Si los adjuntos siguen en análisis, la pregunta queda "en revisión" y el Agente de Publicación la publica en cuanto todo esté aprobado. La pregunta se archiva en el Foro y el autor recibe un aviso en la webapp y por correo.

🅑 El asistente responde con fuentes

Consulta publicada → biblioteca → respuesta citada

Publicada una consulta, el Agente Bibliotecario reformula la pregunta para entender bien qué se busca.
Compara la "huella" de la pregunta con las huellas de los 874 fragmentos de la biblioteca y rescata los más parecidos en significado.
Aplica las reglas de acceso: si un documento es exclusivo para socios y quien pregunta es un usuario no socio, lo menciona por nombre pero no revela su contenido, y ofrece una alternativa abierta si existe. También considera si hay una edición más reciente del mismo documento.
Redacta la respuesta en vivo (el usuario la ve aparecer mientras se escribe) y al final muestra las fuentes citadas: botones para abrir el PDF, ver el video o visitar el enlace. La respuesta queda guardada para futuras visitas.

🅒 Moderación: cuando algo no cumple las normas

Rechazo automático → aviso al equipo → decisión humana

El Agente de Contenido rechaza una publicación (o un usuario reporta algo). Se genera un aviso automático para el equipo de moderación.
En el panel interno, el moderador abre la cola de moderación: ve el contenido completo, el motivo del rechazo y el historial de amonestaciones del autor.
Decide: dejar pasar, amonestar (la publicación se oculta y el autor suma un "strike"), eliminar la publicación o suspender la cuenta del autor. Todo queda registrado en la bitácora de Operación.
La decisión se refleja de inmediato en el portal, y el autor recibe el aviso correspondiente en la webapp y por correo.

🅓 Alimentar la biblioteca del asistente

Notion / carga manual → procesamiento → conocimiento consultable

El equipo administrador mantiene su catálogo de documentos en Notion. Desde el panel interno puede sincronizarlo o cargar documentos y enlaces a mano, clasificándolos por eje, categoría, origen y nivel de acceso (solo socios o todos).
El lector de documentos convierte cada PDF en texto limpio, lo divide en fragmentos útiles y descarta el relleno (logos, encabezados repetidos).
Cada fragmento recibe su huella de texto y se archiva en la biblioteca, listo para ser encontrado por significado, no solo por palabras exactas.
El Agente de Series propone vínculos entre documentos ("estas son dos ediciones del mismo informe") y un administrador los confirma. Desde el banco de pruebas, el equipo puede simular preguntas y auditar exactamente qué consultó y respondió el asistente.
Webapp Portal Compromiso PROpara la comunidad
Muro de preguntasfiltros, orden, votos
Hacer una preguntaasistente en 2 pasos con IA
Respuesta del asistenteen vivo, con citas
Perfil y guardadosavisos y certificación
Usuario No Socio Socio
Webapp Panel internopara el equipo administrador
Usuarios y rolescuentas y permisos dinámicos
Biblioteca de la IAdocumentos y relaciones
Moderaciónrechazos, strikes, bloqueos
Contenido destacadoy prueba de la IA
Roles dinámicos ej: Super Admin · Admin · Moderador
El Cerebro — servicio centraltodo pasa por aquí: identidad, reglas, datos y agentes
Puerta de entradaverifica quién eres y qué puedes hacer
Usuarios y permisoscuentas, roles dinámicos, matriz de permisos
Foropreguntas, respuestas, votos, borradores, insignias
Biblioteca + Agente Bibliotecariodocumentos, búsqueda inteligente, respuestas con citas
Agentes de Contenido e Imágenesfiltran texto e imágenes antes de publicar
Moderaciónstrikes, ocultamientos, suspensiones
Avisosnotificaciones en la webapp y por correo
Archivosrecibe fotos y documentos y los envía a la bodega
Archivo central de datosbase de datos · 4 archivadores
Personascuentas, perfiles, roles y permisos
Foropreguntas, respuestas, votos, destacados
Bibliotecadocumentos, fragmentos y sus huellas de texto
Operaciónavisos, reportes, bitácora de la IA
Memoria rápidaValkey
Sesiones activasquién está conectado; se pueden cerrar a distancia
Códigos temporalesrecuperación de contraseña (expiran en 30 min)
Servicios externos contratadoscada uno cumple un oficio específico
Bodega de archivosAmazon S3
Cartero de correosAmazon SES
Revisor de imágenesAmazon Rekognition
Redactor inteligenteClaude (Anthropic)
Huellas de textoOpenAI
Lector de documentosLlamaParse
Catálogo originalNotion
acción iniciada por personas proceso automático rol quién usa cada webapp externo servicio contratado
05 · El lenguaje

Diccionario de conceptos

Los términos del proyecto, explicados en simple. Entre paréntesis, el nombre técnico con que aparecen en los sistemas. Puedes filtrar los conceptos según la webapp donde aparecen.

Usuario No Socio (usuario_socio, sin certificar)
Miembro de la comunidad que aún no acredita su vínculo con la CChC. Participa del foro, pero no accede al contenido exclusivo para socios.
Socio (certificado · Sello Pro)
Miembro pleno que acreditó su vínculo y experiencia ante la CChC. Porta la insignia "Sello Pro" y accede al contenido completo de la biblioteca.
Roles dinámicos (RBAC)
El equipo administrador puede crear cuantos roles necesite, definiendo módulo por módulo qué puede ver, crear, editar, eliminar o exportar cada uno. Moderador, Administrador y Super Administrador son los ejemplos de fábrica.
Publicación / Pregunta (post · consulta)
La unidad central del foro: una duda o tema que un usuario comparte con la comunidad. Hoy todas son del tipo "consulta"; los tipos "aporte" y "general" están diseñados para el futuro.
Estados de una publicación
Su ciclo de vida: borradoren revisiónpublicada. También puede quedar rechazada (corregible por el autor), oculta por amonestación o eliminada.
Agente de Contenido (guardrail)
Revisa automáticamente textos e imágenes antes de publicarse. Rechaza lo ofensivo o inapropiado explicando el motivo.
Agente de Redacción (mejora de escritura)
Sugiere una versión mejor escrita de cada pregunta; el autor decide si la usa.
Agente Bibliotecario (asistente RAG)
Responde consultas buscando primero en los documentos oficiales y citando sus fuentes, en lugar de inventar. La sigla técnica significa "generación aumentada por recuperación".
Agente de Publicación (auto-publicación)
Publica automáticamente las preguntas "en revisión" cuando todos sus adjuntos fueron aprobados, y avisa al autor.
Agente de Imágenes (análisis de adjuntos)
Analiza cada foto o documento adjunto en busca de contenido inapropiado.
Agente de Series (relaciones entre documentos)
Propone vínculos entre documentos de la biblioteca; un administrador confirma o descarta cada propuesta.
Strike (amonestación)
Tarjeta amarilla que un moderador aplica a una publicación: se oculta y el autor acumula una falta. Varias faltas pueden llevar a suspensión.
Biblioteca (base de conocimiento / KB)
La colección de documentos, informes y enlaces oficiales de la CChC que el asistente puede consultar y citar. Hoy: 97 documentos.
Huella de texto (embedding)
Una "huella digital" numérica de un texto. Dos textos que hablan de lo mismo tienen huellas parecidas, lo que permite buscar por significado.
Fragmento (chunk / nodo)
Trozo de un documento (unos párrafos). La biblioteca guarda 874 fragmentos con su huella, para citar el pasaje exacto y no el documento entero.
Respuesta en vivo (streaming / SSE)
La respuesta del asistente aparece a medida que se escribe, como si alguien tipeara, en lugar de esperar y verla completa.
Cita (citation)
La fuente exacta que respalda una respuesta del asistente: un PDF, un video o un enlace, con botón para abrirlo.
Nivel de acceso
Cada documento indica quién puede verlo: solo socios o todos. El asistente respeta esta regla al responder.
Serie de documentos (SAME_SERIES)
Vínculo entre ediciones del mismo informe (ej. versión 2024 y 2025). Permite al asistente recomendar siempre la más reciente.
Certificación / Sello Pro
Reconocimiento que la CChC otorga a quien acredita su vínculo y experiencia. Convierte a un Usuario No Socio en Socio, con insignia de credibilidad junto a su nombre.
Insignia (badge)
Medalla digital por logros en la comunidad, como "Certificado" o "Super Respondedor".
Voto (upvote / downvote)
Pulgar arriba o abajo sobre preguntas y respuestas. El puntaje ordena lo más valorado por la comunidad.
Guardado (bookmark)
Marcar una pregunta para encontrarla después en "Guardados".
Borrador (draft)
Una pregunta a medio escribir. Se guarda automáticamente para retomarla en cualquier momento y dispositivo.
Categorías
Los 8 temas del foro: Trabajadores · Seguridad y Salud Laboral · Comunidad · Medio Ambiente · Cadena de Valor · Productividad · Gobernanza · Innovación.
Etiquetas (tags)
Palabras clave libres (hasta 5 por pregunta). Es un vocabulario único: las mismas etiquetas clasifican preguntas del foro y documentos de la biblioteca.
Contenido destacado (promoted content)
Banners que el equipo administrador publica en el costado del portal: eventos, campañas, novedades.
Aviso (notificación)
Alerta en la campana de la webapp (y a veces por correo): nueva respuesta, publicación aprobada o rechazada, insignia ganada, hito de votos.
Banco de pruebas de la IA (playground)
Herramienta interna para simular preguntas y ver "el razonamiento" del asistente paso a paso, sin afectar el foro real.
Demandas
Nombre de negocio previsto para gestionar formalmente las inquietudes de los usuarios (clasificarlas y derivarlas). Reservado en el sistema de permisos, aún sin construir.
Maqueta (mock / dummy)
Pantalla ya diseñada y navegable pero con datos de ejemplo: muestra cómo se verá la función cuando se conecte de verdad.