CEM Q&A

Sistema Integral de Formacion Clinica y Evaluacion Medica. Centro de Estudios para profesionales de la salud - Preguntas y Respuestas.

CEM Q&A es una plataforma educativa para entrenamiento, evaluacion y seguimiento del aprendizaje en ciencias de la salud. El proyecto busca convertir bancos de preguntas curados en sesiones de practica medibles, con seleccion aleatoria de reactivos, filtros por areas del conocimiento y analitica longitudinal del progreso del usuario.

El alcance no se limita a medicos ni a una lista cerrada de profesiones. La arquitectura esta pensada para estudiantes, profesionales, docentes y equipos academicos de cualquier campo de las ciencias de la salud que pueda beneficiarse de evaluacion por preguntas, bancos curados y seguimiento de desempeno.

Vision

La meta del producto es ofrecer una experiencia de entrenamiento seria, rapida y trazable:

• practicar preguntas aleatorias de cualquier area o de campos seleccionados;
• reforzar temas especificos de anatomia, biociencias, fisiologia, patologia, farmacologia y clinica;
• clasificar preguntas por taxonomias abiertas, no por una sola especialidad fija;
• registrar intentos, tiempo, confianza y resultados;
• mostrar retroalimentacion con explicacion y punto de aprendizaje;
• medir avance general, por area, por tema, por dificultad y por tipo de razonamiento;
• detectar preguntas o distractores que requieren revision;
• separar con rigor el software publicable del banco privado de preguntas.

Estado Del Proyecto

El repositorio esta en fase inicial de maquetacion y migracion de datos.

• Producto: fase inicial de definicion, migracion de datos y preparacion publica.
• Base de datos de migracion: SQLite.
• Tecnologia de app: pendiente de decision formal.
• Arquitectura de despliegue web/mobile: pendiente de decision formal.
• Banco privado existente: Microsoft Access, no incluido en este repositorio.
• Dataset publico: solo ejemplos sinteticos o demostrativos.

Hook De Revision Para Diseno De App

Antes de iniciar diseno visual, frontend, backend, publicacion web o ruta mobile, el proyecto debe pasar por una revision formal de producto y arquitectura para decidir:

• tecnologia frontend;
• tecnologia backend;
• estrategia web, mobile o hibrida;
• arquitectura local, servidor o sincronizada;
• modelo de autenticacion;
• alcance del MVP visual;
• criterios de accesibilidad, seguridad y despliegue.

Este README no fija esas decisiones. SQLite queda definido solo como formato de migracion y persistencia inicial del banco estructurado.

Flujo De Datos Previsto

flowchart LR
    A[Banco privado Access] --> B[Exportacion privada]
    B --> C[Normalizador]
    C --> D[(SQLite privada)]
    E[Dataset demo sintetico] --> F[(SQLite demo)]
    D --> G[App por definir]
    F --> G
    G --> H[Dashboard de progreso]

Loading

Modelo De Preguntas

El modelo objetivo conserva la variabilidad del banco original:

• cada pregunta puede tener varias respuestas correctas equivalentes;
• cada pregunta puede tener un pool amplio de distractores plausibles;
• cada intento muestra una sola respuesta correcta y un subconjunto de distractores;
• la app registra exactamente que opciones vio el usuario en cada intento;
• los distractores pueden medirse como funcionales o no funcionales segun el comportamiento real.

La tabla clave para analitica es attempt_options, porque permite reconstruir el intento y saber que distractores fueron mostrados, seleccionados o ignorados.

Estructura Publicable

assets/                     Banner e imagenes publicables.
data/demo/                  Preguntas sinteticas para pruebas publicas.
schema/sqlite/              Schema SQLite versionado.
scripts/                    Utilidades de migracion y validacion.
README.md                   Descripcion publica del proyecto.
LICENSE                     Licencia MIT para el software.
NOTICE.md                   Alcance educativo y separacion publico/privado.

Material No Publicable

Este repositorio no debe incluir el banco real ni los activos comerciales:

• bases .accdb, .mdb, .sqlite, .db con preguntas reales;
• exportaciones privadas desde Access;
• preguntas comerciales completas;
• explicaciones curadas de valor comercial;
• fuentes protegidas, capturas o materiales sujetos a licencia;
• datos de usuarios reales;
• datos clinicos de pacientes.

Desarrollo Local

El proyecto todavia no tiene una app ejecutable. La primera fase tecnica es cerrar la migracion de datos y dejar preparada la base para decidir la arquitectura de la app con Maquetacion.

Orden recomendado:

1. validar el schema SQLite en schema/sqlite/001_initial_schema.sql;
2. migrar el Access privado hacia una SQLite privada local;
3. crear un dataset demo sintetico;
4. revisar el documento de texto con preguntas incompletas y pasarlas a staging draft;
5. ejecutar revision de producto y arquitectura para decidir tecnologia y diseno de app;
6. construir MVP segun las decisiones tomadas;
7. publicar solo codigo, schema, demo y documentacion publicable.

Licencia

El software publico se distribuye bajo licencia MIT. El banco real de preguntas, las explicaciones curadas, la marca CEM Q&A y las fuentes privadas no se licencian por MIT y permanecen excluidos del repositorio publico.

Aviso

CEM Q&A es un proyecto educativo. No es un dispositivo medico, no reemplaza criterio clinico, no emite diagnosticos ni recomienda tratamientos para pacientes individuales.