docs: README, ARCHITECTURE, roadmap futuro y manual de QA del dashboard
- README.md: pitch, arquitectura, quickstart, demo guiada en 3 pasos, tabla de capacidades, estructura del repo, comandos de tests. - ARCHITECTURE.md: patrones (Strategy, config-over-code, fail-closed, trazabilidad), tabla de persistencia, patrón HITL, observabilidad, errores. - docs/futuro.md: roadmap post-MVP. - docs/manual_qa.md: checklist del smoke manual del dashboard (5 páginas + PII + persistencia). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,58 @@
|
||||
# Smoke manual del dashboard
|
||||
|
||||
> Esta lista cubre los flujos no automatizados (Streamlit). Ejecutar tras
|
||||
> cambios visuales o estructurales del dashboard.
|
||||
|
||||
## Setup
|
||||
|
||||
```bash
|
||||
cp .env.example .env
|
||||
docker compose up -d
|
||||
sleep 15
|
||||
```
|
||||
|
||||
Abrir [http://localhost:8501](http://localhost:8501).
|
||||
|
||||
## 1) Registro
|
||||
|
||||
- [ ] Aparece `incident_analyzer` en el desplegable.
|
||||
- [ ] Detalle muestra version, owner, propósito, guardrails, system_prompt.
|
||||
- [ ] Tabla de versiones lista `v1` y `v2`.
|
||||
- [ ] Diff `v1 → v2` muestra cambios coloreados.
|
||||
|
||||
## 2) Ejecutar
|
||||
|
||||
- [ ] Botones de escenarios cargan texto en el textarea.
|
||||
- [ ] Invocar `02_mos_degradation_pool_sbc` → status=`completed`, sin HITL,
|
||||
decision_path con 6 steps.
|
||||
- [ ] Invocar `01_sip_registration_drop` → status=`awaiting_approval`,
|
||||
banner amarillo redirige a Aprobaciones.
|
||||
|
||||
## 3) Aprobaciones
|
||||
|
||||
- [ ] La ejecución pendiente aparece en el desplegable.
|
||||
- [ ] Cada acción muestra risk_score con color, target y rollback_plan.
|
||||
- [ ] Aprobar acciones seleccionadas → status=`completed`.
|
||||
- [ ] Rechazo con razón → status=`failed`, error=`rejected_by_human`.
|
||||
|
||||
## 4) Historial
|
||||
|
||||
- [ ] Tab "Ejecuciones" lista todas las ejecuciones con summary.
|
||||
- [ ] Detalle muestra trace + violations.
|
||||
- [ ] Tab "Violaciones" filtrable por severity.
|
||||
|
||||
## 5) Politicas
|
||||
|
||||
- [ ] `default` aparece con sus validadores de input/output.
|
||||
- [ ] Cada validador expandible con su config.
|
||||
|
||||
## Bloqueo por PII (input)
|
||||
|
||||
- [ ] Pegar `El cliente con NIF 12345678Z reporta caída`.
|
||||
- [ ] Invocar → status=`blocked_by_guardrail`, violación `DetectPII`.
|
||||
|
||||
## Persistencia
|
||||
|
||||
- [ ] `docker compose down && docker compose up` → ejecuciones previas
|
||||
siguen accesibles vía Historial; aprobaciones pendientes siguen
|
||||
pendientes.
|
||||
Reference in New Issue
Block a user