[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

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 PRUEBA/, 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.