# ftw-git-away/tuklas-pinas-data-platform architecture

> Architecture diagram of the GitHub repository ftw-git-away/tuklas-pinas-data-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ftw-git-away/tuklas-pinas-data-platform
- Repository: https://github.com/ftw-git-away/tuklas-pinas-data-platform

## Overview

Tuklas Pinas is a proposed public tourism and local-economy data platform, not yet an operational pipeline or portal. Its intended workflow brings approved public datasets through ingestion and layered data processing, then serves curated indicators for public exploration. The repository also identifies analytics and data-quality work as distinct areas. The README documents the broad pipeline-to-website flow, while the tree supplies the numbered implementation areas; source excerpts were unavailable, so internal calls and more specific subsystem wiring are not asserted.

Main entry points: [`dashboard`](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/dashboard) (Public Website), [`src/01-ingestion`](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/01-ingestion) (Ingestion), [`src/02-bronze`](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/02-bronze) (Bronze Data), [`src/03-silver`](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/03-silver) (Silver Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sources["Data Sources"]
  node_agencies(("DOT, PSA, PSGC"))
end

subgraph group_pipeline["Data Pipeline"]
  node_ingestion["Ingestion"]
  node_bronze[("Bronze Data")]
  node_silver[("Silver Data")]
  node_gold[("Gold Marts")]
end

subgraph group_quality["Quality and Analytics"]
  node_quality["Data Quality"]
  node_analytics["Analytics"]
end

subgraph group_experience["Public Experience"]
  node_query{{"Read-only Query API"}}
  node_dashboard["Public Website"]
  node_exploration["Filters, Charts, Maps, Tables, Downloads"]
end

node_visitor(("Public Visitor"))

node_agencies -->|"provides data"| node_ingestion
node_ingestion -->|"loads raw data"| node_bronze
node_bronze -->|"cleans data"| node_silver
node_silver -->|"curates marts"| node_gold
node_gold -->|"serves indicators"| node_query
node_query -->|"returns data"| node_dashboard
node_visitor -->|"visits"| node_dashboard
node_dashboard -->|"presents data"| node_exploration

click node_ingestion "https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/01-ingestion"
click node_bronze "https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/02-bronze"
click node_silver "https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/03-silver"
click node_gold "https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/04-gold"
click node_quality "https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/06-data-quality"
click node_analytics "https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/05-analytics"
click node_dashboard "https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/dashboard"
click node_exploration "https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/dashboard"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_agencies toneBlue
class node_ingestion,node_bronze,node_silver,node_gold toneAmber
class node_quality,node_analytics toneMint
class node_query,node_dashboard,node_exploration toneRose
class node_visitor toneIndigo
```

## Components

### Data Sources

- **DOT, PSA, PSGC**

### Data Pipeline

- [Ingestion](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/01-ingestion): `src/01-ingestion`
- [Bronze Data](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/02-bronze): `src/02-bronze`
- [Silver Data](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/03-silver): `src/03-silver`
- [Gold Marts](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/04-gold): `src/04-gold`

### Quality and Analytics

- [Data Quality](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/06-data-quality): `src/06-data-quality`
- [Analytics](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/src/05-analytics): `src/05-analytics`

### Public Experience

- **Read-only Query API**
- [Public Website](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/dashboard): `dashboard`
- [Filters, Charts, Maps, Tables, Downloads](https://github.com/ftw-git-away/tuklas-pinas-data-platform/tree/main/dashboard): `dashboard`

### Other components

- **Public Visitor**

## Connections

- DOT, PSA, PSGC → Ingestion: provides data
- Ingestion → Bronze Data: loads raw data
- Bronze Data → Silver Data: cleans data
- Silver Data → Gold Marts: curates marts
- Gold Marts → Read-only Query API: serves indicators
- Read-only Query API → Public Website: returns data
- Public Visitor → Public Website: visits
- Public Website → Filters, Charts, Maps, Tables, Downloads: presents data