# taleslpedrosa/app_recife_mca. architecture

> Architecture diagram of the GitHub repository taleslpedrosa/app_recife_mca., generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/taleslpedrosa/app_recife_mca.
- Repository: https://github.com/taleslpedrosa/app_recife_mca.

## Overview

Recife: Museu a Céu Aberto is a browser-based cultural heritage guide: visitors browse and filter a curated POI collection, explore it on a map, and use GPS-guided routes and a cultural passport. The app also supports multilingual audio, private field notes, local visitor profiles, curatorial analytics, remote collection refresh, and offline PWA use. The graph combines sampled bootstrap and module behavior with capabilities and relationships documented in the README; several UI, telemetry, sync, and data-wiring details are not fully shown in the excerpts.

Main entry points: [`js/app.js`](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/app.js) (App Bootstrap), [`js/ui.js`](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui.js) (UI Coordinator), [`js/sheets.js`](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/sheets.js) (Sheets Ingestion), [`js/map.js`](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/map.js) (Interactive Map)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coord["App Coordination"]
  node_app["App Bootstrap<br/>[app.js]"]
  node_ui["UI Coordinator<br/>[ui.js]"]
end

subgraph group_collection["Collection and Mapping"]
  node_poi["POI Catalog<br/>[dados.js]"]
  node_sheets["Sheets Ingestion<br/>[sheets.js]"]
  node_schema["Runtime Validation<br/>[schema.js]"]
  node_map["Interactive Map<br/>[map.js]"]
  node_routes["GPS Routes<br/>[routes.js]"]
end

subgraph group_visitor["Visitor Experience"]
  node_carousel["Image Carousel<br/>[carousel.js]"]
  node_audio["Audio Guide<br/>[audioguide.js]"]
  node_passport[("Cultural Passport<br/>[passport.js]")]
  node_notes[("Field Notes<br/>[notes.js]")]
  node_modals["Dialogs and Profile<br/>[modals.js]"]
  node_dashboard["Curatorial Dashboard<br/>[dashboard.js]"]
  node_gestures["Mobile Gestures<br/>[gestures.js]"]
end

subgraph group_state["Local State and Insight"]
  node_store[("Reactive Store<br/>[store.js]")]
  node_i18n["Languages<br/>[i18n.js]"]
  node_telemetry[("Local Telemetry<br/>[telemetry.js]")]
  node_sync[("Visitor Profile<br/>[sync.js]")]
end

subgraph group_offline["Offline Delivery"]
  node_sw[("Offline Cache<br/>[sw.js]")]
end

node_visitor(("Visitor"))
node_browsergps["Browser GPS"]
node_google["Google Sheets"]
node_speech["Device Speech"]
node_tiles["Map Tile Services"]

node_visitor -->|"opens"| node_app
node_app -->|"initializes"| node_map
node_app -->|"seeds POIs"| node_store
node_app -->|"loads local data"| node_poi
node_app -.->|"initializes filters"| node_ui
node_app -->|"starts refresh"| node_sheets
node_app -->|"starts GPS"| node_routes
node_app -->|"registers"| node_sw
node_app -->|"sets language"| node_i18n
node_app -->|"refreshes display"| node_passport
node_sheets -->|"fetches collection"| node_google
node_sheets -->|"validates records"| node_schema
node_sheets -.->|"updates data"| node_store
node_ui -.->|"displays POIs"| node_map
node_ui -->|"renders images"| node_carousel
node_ui -->|"opens guide"| node_audio
node_ui -->|"opens notes"| node_notes
node_ui -->|"manages visits"| node_passport
node_ui -->|"opens dialogs"| node_modals
node_ui -->|"opens analytics"| node_dashboard
node_ui -->|"enables gestures"| node_gestures
node_ui -->|"applies language"| node_i18n
node_routes -->|"reads location"| node_browsergps
node_routes -->|"draws routes"| node_map
node_routes -->|"records dwell"| node_telemetry
node_map -->|"requests tiles"| node_tiles
node_audio -->|"speaks locally"| node_speech
node_passport -->|"uses route POIs"| node_poi
node_dashboard -->|"reads metrics"| node_telemetry
node_modals -.->|"sets visitor profile"| node_sync
node_sw -->|"caches assets"| node_map
node_sw -->|"caches assets"| node_sheets

click node_app "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/app.js"
click node_ui "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui.js"
click node_poi "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/dados.js"
click node_sheets "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/sheets.js"
click node_schema "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/schema.js"
click node_map "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/map.js"
click node_routes "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/routes.js"
click node_store "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/store.js"
click node_i18n "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/i18n.js"
click node_telemetry "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/telemetry.js"
click node_sync "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/sync.js"
click node_carousel "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/carousel.js"
click node_audio "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/audioguide.js"
click node_passport "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/passport.js"
click node_notes "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/notes.js"
click node_modals "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/modals.js"
click node_dashboard "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/dashboard.js"
click node_gestures "https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/gestures.js"
click node_sw "https://github.com/taleslpedrosa/app_recife_mca./blob/main/sw.js"

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_app,node_ui,node_browsergps toneBlue
class node_poi,node_sheets,node_schema,node_map,node_routes toneAmber
class node_carousel,node_audio,node_passport,node_notes,node_modals,node_dashboard,node_gestures toneMint
class node_store,node_i18n,node_telemetry,node_sync toneRose
class node_sw,node_visitor,node_google,node_speech,node_tiles toneIndigo
```

## Components

### App Coordination

- [App Bootstrap](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/app.js): `js/app.js`
- [UI Coordinator](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui.js): `js/ui.js`

### Collection and Mapping

- [POI Catalog](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/dados.js): `js/dados.js`
- [Sheets Ingestion](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/sheets.js): `js/sheets.js`
- [Runtime Validation](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/schema.js): `js/schema.js`
- [Interactive Map](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/map.js): `js/map.js`
- [GPS Routes](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/routes.js): `js/routes.js`

### Visitor Experience

- [Image Carousel](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/carousel.js): `js/ui/carousel.js`
- [Audio Guide](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/audioguide.js): `js/ui/audioguide.js`
- [Cultural Passport](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/passport.js): `js/ui/passport.js`
- [Field Notes](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/notes.js): `js/ui/notes.js`
- [Dialogs and Profile](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/modals.js): `js/ui/modals.js`
- [Curatorial Dashboard](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/dashboard.js): `js/ui/dashboard.js`
- [Mobile Gestures](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/ui/gestures.js): `js/ui/gestures.js`

### Local State and Insight

- [Reactive Store](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/store.js): `js/store.js`
- [Languages](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/i18n.js): `js/i18n.js`
- [Local Telemetry](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/telemetry.js): `js/telemetry.js`
- [Visitor Profile](https://github.com/taleslpedrosa/app_recife_mca./blob/main/js/sync.js): `js/sync.js`

### Offline Delivery

- [Offline Cache](https://github.com/taleslpedrosa/app_recife_mca./blob/main/sw.js): `sw.js`

### Other components

- **Visitor**
- **Browser GPS**
- **Google Sheets**
- **Device Speech**
- **Map Tile Services**

## Connections

- Visitor → App Bootstrap: opens (evidence: `js/app.js`)
- App Bootstrap → Interactive Map: initializes (evidence: `js/app.js`)
- App Bootstrap → Reactive Store: seeds POIs (evidence: `js/app.js`)
- App Bootstrap → POI Catalog: loads local data (evidence: `js/app.js`)
- App Bootstrap → UI Coordinator: initializes filters
- App Bootstrap → Sheets Ingestion: starts refresh (evidence: `js/app.js`)
- App Bootstrap → GPS Routes: starts GPS (evidence: `js/app.js`)
- App Bootstrap → Offline Cache: registers (evidence: `js/app.js`)
- App Bootstrap → Languages: sets language (evidence: `js/app.js`)
- App Bootstrap → Cultural Passport: refreshes display (evidence: `js/app.js`)
- Sheets Ingestion → Google Sheets: fetches collection (evidence: `README.md`)
- Sheets Ingestion → Runtime Validation: validates records (evidence: `README.md`)
- Sheets Ingestion → Reactive Store: updates data
- UI Coordinator → Interactive Map: displays POIs
- UI Coordinator → Image Carousel: renders images (evidence: `README.md`)
- UI Coordinator → Audio Guide: opens guide (evidence: `README.md`)
- UI Coordinator → Field Notes: opens notes (evidence: `README.md`)
- UI Coordinator → Cultural Passport: manages visits (evidence: `README.md`)
- UI Coordinator → Dialogs and Profile: opens dialogs (evidence: `README.md`)
- UI Coordinator → Curatorial Dashboard: opens analytics (evidence: `README.md`)
- UI Coordinator → Mobile Gestures: enables gestures (evidence: `README.md`)
- UI Coordinator → Languages: applies language (evidence: `README.md`)
- GPS Routes → Browser GPS: reads location (evidence: `README.md`)
- GPS Routes → Interactive Map: draws routes (evidence: `js/routes.js`)
- GPS Routes → Local Telemetry: records dwell (evidence: `js/routes.js`)
- Interactive Map → Map Tile Services: requests tiles (evidence: `README.md`)
- Audio Guide → Device Speech: speaks locally (evidence: `README.md`)
- Cultural Passport → POI Catalog: uses route POIs (evidence: `README.md`)
- Curatorial Dashboard → Local Telemetry: reads metrics (evidence: `README.md`)
- Dialogs and Profile → Visitor Profile: sets visitor profile
- Offline Cache → Interactive Map: caches assets (evidence: `sw.js`)
- Offline Cache → Sheets Ingestion: caches assets (evidence: `sw.js`)
