Repositorios

Cómo se integran los repositorios de COLFLUX: el sistema en ejecución (frontend + backend) y context como documentación del equipo alrededor. El detalle de cada repo está en la tabla más abajo.

Clic sobre el diagrama para ampliarlo a pantalla completa · Esc para cerrar.

%%{init: {
  "securityLevel": "loose",
  "theme": "base",
  "themeVariables": {
    "fontSize": "16px",
    "primaryColor": "#eaf4f1",
    "primaryBorderColor": "#198A77",
    "primaryTextColor": "#1a1a1a",
    "lineColor": "#57270F",
    "tertiaryColor": "#f5f5f5",
    "edgeLabelBackground": "#ffffff"
  },
  "flowchart": {
    "nodeSpacing": 45,
    "rankSpacing": 70,
    "curve": "basis"
  }
}}%%
flowchart TB
    usuario(["Usuario final / investigador"])
    equipo(["Equipo técnico"])

    subgraph frontend["frontend"]
        direction TB
        geoportal["Geoportal
        Mapas y visualización de datos"]
        wikiseccion["Wiki
        Conceptos y documentación"]
        chat["Chat
        Asistente conversacional"]
    end

    subgraph backend["backend"]
        direction TB
        api["API backend
        Django + PostGIS"]
        iafunctions["ia-functions
        Microservicios IA"]
        db[("DB
        PostgreSQL/PostGIS")]
    end

    context["context
    Docs del equipo (este repo)"]

    usuario -->|Usa| geoportal
    usuario -->|Consulta| wikiseccion
    usuario -->|Pregunta| chat
    equipo -->|Mantiene| context

    api -->|Sirve datos| geoportal
    api -->|Sirve contenido| wikiseccion
    iafunctions -->|Responde| chat
    api -->|Invoca| iafunctions
    api -->|Lee / escribe| db

    classDef person fill:#198A77,stroke:#0F5C4E,color:#fff
    classDef frontendNode fill:#8fc4b8,stroke:#198A77,color:#1a1a1a
    classDef backendNode fill:#3f7d9e,stroke:#2b5a71,color:#fff
    classDef extNode fill:#d9d9d9,stroke:#8a8a8a,color:#1a1a1a
    class usuario,equipo person
    class geoportal,wikiseccion,chat frontendNode
    class api,iafunctions,db backendNode
    class context extNode

    click geoportal "https://github.com/colflux/frontend" "Repo frontend" _blank
    click wikiseccion "https://github.com/colflux/frontend" "Repo frontend" _blank
    click chat "https://github.com/colflux/frontend" "Repo frontend" _blank
    click api "https://github.com/colflux/backend" "Repo backend" _blank
    click iafunctions "https://github.com/colflux/ia-functions" "Repo ia-functions" _blank
    click context "https://github.com/colflux/context" "Repo context" _blank

Repositorios

Inventario de los repositorios que conforman COLFLUX, según lo encontrado en la carpeta local colflux/ a fecha 2026-08-27.

Repositorio	URL	Propósito	Estado
backend	github.com/colflux/backend	API Django + PostGIS. Modela, ingiere (ETL Excel/CSV) y expone datos de flujo de gases de efecto invernadero (CO₂, CH₄, N₂O), catálogos geográficos (región/departamento/municipio/vereda) y geoportal en GeoJSON.	Activo
frontend	github.com/colflux/frontend	Geoportal web (React + TypeScript + Vite). Visualización de datos geoespaciales sobre MapLibre, drill-down geográfico, filtros y exportación a Excel.	Activo
context (este repo)	github.com/colflux/context	Documentación transversal del equipo (OE2): requisitos, arquitectura, gestión, marca. Sirve como contexto para trabajar con IA.	Activo
wiki	github.com/colflux/wiki	Wiki de cara al usuario final: datos y contexto del proyecto, explicación de los flujos de carbono, guías de uso. Distinto propósito de context (que es para el equipo).	Activo — pendiente revisar contenido y evaluar qué migrar/reorganizar respecto a context
ia-functions	github.com/colflux/ia-functions	Microservicios de IA, invocados por backend. Conceptualmente es parte del backend, pero vive en repo propio para desplegarse/escalar por separado. Sin commits todavía.	Inicial / vacío
ia	(sin repo en GitHub)	Carpeta local con notas de configuración (line-model.md). No es un repositorio git — evaluar si debe convertirse en uno o su contenido debe moverse a otro repo.	Sin versionar

Ver también: Diagrama C4 (misma información, en notación C4 formal).

Notas

• Todos los repos con remoto están bajo la organización colflux en GitHub.
• Esta tabla se actualiza a mano por ahora; si el equipo crece en número de repos, considerar generarla desde la API de GitHub.
• frontend integra tres secciones: Geoportal (mapas y datos), Wiki (conceptos y documentación de usuario final) y Chat (asistente conversacional). Geoportal y Wiki son servidas por la API del backend; Chat es respondido por ia-functions.
• ia-functions es conceptualmente parte del backend — microservicios de IA invocados por la API — pero vive en un repo propio porque se despliega/escala por separado.
• Pendiente de definir: de dónde saca su contenido la sección Wiki — si consulta una base de datos como fuente única de verdad, o si el contenido vive en otro lugar (posiblemente relacionado con el repo wiki, ver tabla arriba). Actualizar este diagrama cuando se decida.
• context no es parte del sistema en ejecución — es documentación del equipo. Se muestra aparte porque el equipo lo mantiene y consulta, pero no hay integración en tiempo de ejecución con frontend/backend.
• ia (carpeta local sin repo git) no aparece en el diagrama porque no es un sistema ni repositorio todavía.