Visión general¶
Producto¶
SchemaSafe NoSQL es una herramienta de apoyo a decisiones para evaluar, antes de una migración, el impacto de cambios estructurales sobre datos NoSQL existentes. Recibe evidencia de un recurso, interpreta una propuesta de cambio, ejecuta reglas explicables y entrega un reporte que indica qué puede verse afectado, con qué severidad y qué acción preventiva se recomienda.
SchemaSafe no ejecuta migraciones, no modifica índices, no altera validaciones y no promete equivalencia semántica entre motores. Su responsabilidad termina en producir evidencia reproducible para que una persona decida cómo proceder.
Usuarios y responsabilidades¶
| Actor | Necesidad | Responsabilidad dentro de SchemaSafe |
|---|---|---|
| Analista | Saber si un cambio es seguro antes de aplicarlo | Seleccionar recurso, definir propuesta, ejecutar análisis y revisar recomendaciones |
| Revisor técnico | Comparar evidencia y aprobar una decisión | Consultar reportes, historial, limitaciones y comparaciones |
| Administrador | Controlar el entorno y el acceso | Gestionar conexiones, usuarios, roles, configuración, auditoría y retención |
| Operador | Mantener disponible el servicio | Revisar health/readiness, logs, métricas, backups y fallos de conectividad |
Flujo principal¶
crear o seleccionar conexión de prueba
→ descubrir recursos y capacidades
→ obtener snapshot read-only
→ definir propuesta de cambio
→ validar compatibilidad de la propuesta
→ aplicar reglas comunes/específicas
→ calcular impacto y riesgo
→ revisar limitaciones y recomendaciones
→ conservar reporte y auditoría
→ comparar o exportar evidencia
La ruta crítica de seguridad es que ninguna etapa del análisis preventivo tenga una operación de escritura sobre la fuente. La ejecución de una migración sería otro producto o una capacidad posterior con autorización y diseño independientes.
Resultado demostrable¶
En el MVP una persona puede elegir MongoDB, CouchDB o Cassandra en fixture mode, ejecutar edad: número → texto, ver el total, afectados, porcentaje, hallazgos, riesgo, resultado general y recomendaciones, y consultar el reporte guardado. En la versión 1 podrá repetir ese flujo contra una conexión de prueba read-only, seleccionar un recurso real y comparar reportes compatibles.
Módulos del producto¶
- Catálogo de conexiones, motores, recursos y capacidades.
- Adaptadores NoSQL y normalización de evidencia.
- Modelo intermedio y validación de propuestas.
- Motor de reglas, severidades, métricas y recomendaciones.
- Reportes, historial, comparación y exportación.
- Identidad, autorización y auditoría.
- Frontend de análisis y revisión.
- Operación: configuración, health/readiness, logs, métricas y backups.
Principio de producto¶
El reporte siempre debe diferenciar entre una incompatibilidad observada, una capacidad no soportada y una métrica que no pudo obtenerse. No se permite convertir evidencia incompleta en una aprobación silenciosa.