# [ANEXO] Estructura de carpeta y navegación por código ## 1. Propósito Este anexo describe la estructura real del proyecto de trabajo, no solo la carpeta desplegada en el hosting. Su objetivo es facilitar la revisión técnica completa y permitir localizar con rapidez materiales de acceso, documentación, base de datos, automatizaciones y código publicado. ## 2. Puntos de referencia ### 2.1. Rutas web publicadas - `/planscope/` - landing principal del proyecto - `/planscope/app/` - asistente de consulta - `/planscope/new/` - alta de nuevos proyectos - `/planscope/data/` - vista de datos operativos - `/planscope/docs/` - índice documental publicado ### 2.2. Endpoints publicados - `/planscope/api/ask.php` - endpoint backend para consultas del asistente - `/planscope/api/create-project.php` - endpoint backend para creación de proyectos - `/planscope/api/config.php` - configuración común del backend ### 2.3. Documentación principal del proyecto - `DOCUMENTACIÓN/Prueba Tecnica - Arquitecto Producto IA - CINK.pdf` - `DOCUMENTACIÓN/hoja de ruta v0.md` - `DOCUMENTACIÓN/Projects.xlsx` - `DOCUMENTACIÓN/projectsSection_ej.xlsx` - `DOCUMENTACIÓN/ENTREGABLE/00. Guia_Entrega.md` - `DOCUMENTACIÓN/ENTREGABLE/01. PlanScope_Paquete_de_Entrega.pdf` - `DOCUMENTACIÓN/ENTREGABLE/02. Architecture.pdf` - `DOCUMENTACIÓN/ENTREGABLE/03. Testing_Plan.pdf` - `DOCUMENTACIÓN/ENTREGABLE/04. Validation_Checklist.md` - `DOCUMENTACIÓN/ENTREGABLE/05. Anexo_Estructura_Carpeta.md` ## 3. Estructura real de carpetas del proyecto ```text PRUEBA/ ├── ACCESOS/ │ ├── airtable-token-planscope.txt │ ├── openai-api_key_planscope_indexer.txt │ ├── qdrant-planscope-cluster_api_key.txt │ └── qdrant-planscope-cluster_url_endpoint.txt ├── BASE DE DATOS AIRTABLE/ │ ├── tabla_Projects.ods │ └── tabla_ProjectSections.ods ├── DOCUMENTACIÓN/ │ ├── ENTREGABLE/ │ │ ├── 00. Guia_Entrega.md │ │ ├── 01. PlanScope_Paquete_de_Entrega.pdf │ │ ├── 02. Architecture.pdf │ │ ├── 03. Testing_Plan.pdf │ │ ├── 04. Validation_Checklist.md │ │ └── 05. Anexo_Estructura_Carpeta.md │ ├── hoja de ruta v0.md │ ├── Projects.xlsx │ ├── projectsSection_ej.xlsx │ └── Prueba Tecnica - Arquitecto Producto IA - CINK.pdf ├── ESCENARIOS MAKE/ │ ├── PLANSCOPE_ASK.blueprint.json │ └── PLANSCOPE_INDEX_SECTIONS_TO_QDRANT.blueprint.json └── FTP/ └── planscope/ ├── api/ │ ├── ask.php │ ├── create-project.php │ └── config.php ├── app/ │ ├── styles.css │ ├── index.html │ └── app.js ├── assets/ │ ├── og-image.jpg │ ├── estructura-carpeta.png │ └── favicon.svg ├── data/ │ └── index.html ├── docs/ │ ├── 05. Anexo_Estructura_Carpeta.md │ ├── index.html │ ├── 00. Guia_Entrega.md │ ├── 03. Testing_Plan.pdf │ ├── 02. Architecture.pdf │ ├── 01. PlanScope_Paquete_de_Entrega.pdf │ └── 04. Validation_Checklist.md ├── new/ │ ├── styles.css │ ├── index.html │ └── app.js ├── .htaccess └── index.html ```` ## 4. Lectura recomendada por tipo de revisión ### 4.1. Contexto del reto y alcance * `DOCUMENTACIÓN/Prueba Tecnica - Arquitecto Producto IA - CINK.pdf` - enunciado original de la prueba * `DOCUMENTACIÓN/hoja de ruta v0.md` - secuencia de trabajo y roadmap operativo ### 4.2. Modelado y estructura de datos * `BASE DE DATOS AIRTABLE/tabla_Projects.ods` - estructura de la tabla `Projects` * `BASE DE DATOS AIRTABLE/tabla_ProjectSections.ods` - estructura de la tabla `ProjectSections` * `DOCUMENTACIÓN/Projects.xlsx` - dataset de proyectos * `DOCUMENTACIÓN/projectsSection_ej.xlsx` - ejemplo de secciones derivadas ### 4.3. Entrega final * `DOCUMENTACIÓN/ENTREGABLE/00. Guia_Entrega.md` - guía de lectura * `DOCUMENTACIÓN/ENTREGABLE/01. PlanScope_Paquete_de_Entrega.pdf` - documento principal de entrega * `DOCUMENTACIÓN/ENTREGABLE/02. Architecture.pdf` - arquitectura resumida * `DOCUMENTACIÓN/ENTREGABLE/03. Testing_Plan.pdf` - plan de pruebas * `DOCUMENTACIÓN/ENTREGABLE/04. Validation_Checklist.md` - checklist de validación * `DOCUMENTACIÓN/ENTREGABLE/05. Anexo_Estructura_Carpeta.md` - este anexo ### 4.4. Automatización y lógica de orquestación * `ESCENARIOS MAKE/PLANSCOPE_ASK.blueprint.json` - escenario de consulta * `ESCENARIOS MAKE/PLANSCOPE_INDEX_SECTIONS_TO_QDRANT.blueprint.json` - escenario de indexación ### 4.5. Código desplegado * `FTP/planscope/index.html` - landing principal publicada * `FTP/planscope/app/index.html` - interfaz del asistente * `FTP/planscope/new/index.html` - formulario de alta * `FTP/planscope/data/index.html` - vista de datos * `FTP/planscope/docs/index.html` - índice documental publicado * `FTP/planscope/api/ask.php` - backend de consulta * `FTP/planscope/api/create-project.php` - backend de alta * `FTP/planscope/api/config.php` - configuración compartida ## 5. Correspondencia entre carpetas y responsabilidades ### 5.1. `ACCESOS/` Contiene credenciales y datos de conexión necesarios para operar Airtable, OpenAI y Qdrant durante el desarrollo y la configuración del prototipo. ### 5.2. `BASE DE DATOS AIRTABLE/` Agrupa los esquemas de referencia de las tablas principales usadas en la solución: `Projects` y `ProjectSections`. ### 5.3. `DOCUMENTACIÓN/` Centraliza el contexto funcional del reto, la hoja de ruta, los datasets de apoyo y los entregables preparados para revisión. ### 5.4. `DOCUMENTACIÓN/ENTREGABLE/` Contiene el paquete final preparado para evaluación: guía, arquitectura, plan de pruebas, checklist y anexo estructural. ### 5.5. `ESCENARIOS MAKE/` Incluye los blueprints exportados de Make con la lógica de indexación y consulta del sistema. ### 5.6. `FTP/` Agrupa la versión preparada para despliegue web. Dentro de esta carpeta, `planscope/` representa el contenido publicado en el hosting. ### 5.7. `FTP/planscope/api/` Contiene los endpoints PHP y la configuración compartida del backend ligero. ### 5.8. `FTP/planscope/app/` Contiene la interfaz web del asistente conversacional: HTML, CSS y JavaScript. ### 5.9. `FTP/planscope/new/` Contiene la interfaz para registrar nuevos proyectos. ### 5.10. `FTP/planscope/data/` Expone la vista web de datos operativos y soporte de validación. ### 5.11. `FTP/planscope/docs/` Contiene la documentación publicada y su índice web de navegación. ### 5.12. `FTP/planscope/assets/` Almacena recursos estáticos compartidos del despliegue web. ## 6. Nota de revisión La estructura correcta del proyecto es la del directorio de trabajo creado para desplegar la `PRUEBA TÉCNICA/`, que incluye materiales de acceso, documentación, automatizaciones, base de datos y despliegue. La carpeta `FTP/planscope/` representa solo la parte publicada en web y no debe confundirse con la estructura completa del proyecto. [Ver imagen de la estructura de carpeta](https://tests.codigo4d.com/planscope/assets/estructura-carpeta.png?v=2026040801)