# PlanScope · Guía de entrega

## 1. Qué se entrega

Se entrega un prototipo funcional accesible por web y un paquete documental orientado a una validación rápida y reproducible.

### 1.1. Enlaces principales
- Landing: https://tests.codigo4d.com/planscope/
- App de consulta: https://tests.codigo4d.com/planscope/app/
- Alta de proyecto: https://tests.codigo4d.com/planscope/new/
- Vista pública de proyectos en Airtable: https://airtable.com/appDVyv7EyUWG2tFL/shrtr1i9mMhk4lHz8

### 1.2. Documentos incluidos
- `architecture.md`
- `testing-plan.md`
- `validation-checklist.md`
- `ANEXO_estructura-carpeta.md`
- `PlanScope_Paquete_de_Entrega.pdf`
- `architecture.pdf`
- `testing-plan.pdf`

## 2. Cómo revisar el prototipo en 10 minutos

1. Abrir la landing.
2. Entrar en la app de consulta.
3. Probar las 5 preguntas obligatorias de la prueba.
4. Lanzar una pregunta fuera de corpus.
5. Dar de alta un proyecto en `/new/` y consultarlo después.
6. Revisar trazabilidad mínima en `Logs`, si hay acceso a Airtable.

## 3. Alcance cubierto

### 3.1. Alcance mínimo solicitado
- asistente funcional,
- respuesta a preguntas específicas,
- comparaciones entre proyectos,
- indicación de falta de información suficiente,
- documento de arquitectura breve.

### 3.2. Mejoras añadidas dentro del plazo
Además del alcance mínimo, se añadieron:
- landing de acceso,
- alta web de proyectos,
- derivación automática de `ProjectSections`,
- indexación tras alta,
- tabla `Logs`,
- doble recuperación en Qdrant por proyectos y por secciones.

## 4. Criterio de lectura recomendado

- `architecture.md` para entender decisiones y trade-offs.
- `testing-plan.md` para validar comportamiento.
- `validation-checklist.md` como apoyo de revisión rápida.
- `ANEXO_estructura-carpeta.md` para navegar el despliegue y el código.

## 5. Nota de alcance

La solución está planteada como prototipo funcional. Se priorizan claridad de arquitectura, fiabilidad operativa y mantenibilidad sobre hardening completo de producción.