# zmikiz1423/esp32-cyd-survival-wiki-thai architecture

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

- Interactive diagram: https://gitdiagram.com/zmikiz1423/esp32-cyd-survival-wiki-thai
- Repository: https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai

## Overview

This is a Thai-language ESP32 survival wiki with a companion phone interface: users browse survival guidance on the device or over its Wi-Fi hotspot, and can use field GPS, maps, route tracking, and LoRa tools. Offline map packages can be selected on-device; companion scripts provide map preparation and phone-based map workflows. The graph includes documented capabilities and only source relationships visible in the excerpts or SOURCE INDEX; uninspected modules are not assigned speculative call paths.

Main entry points: [`firmware/src/main.cpp`](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/main.cpp) (Firmware runtime), [`firmware/src/web.cpp`](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/web.cpp) (Hotspot web service), [`scripts/polish_thai_wiki.py`](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/polish_thai_wiki.py) (Thai wiki editing), [`scripts/map-app/app.js`](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/map-app/app.js) (Phone map app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_firmware["Device firmware"]
  node_main["Firmware runtime<br/>[main.cpp]"]
  node_web["Hotspot web service<br/>[web.cpp]"]
  node_mesh["LoRa messaging<br/>[mesh.cpp]"]
  node_meshpage["Messaging page<br/>[meshpage.h]"]
  node_tools["Device tools page<br/>[toolspage.h]"]
  node_field["Field hardware<br/>[field_hardware.cpp]"]
end

subgraph group_maps["Maps and field navigation"]
  node_gps["GPS service<br/>[gps.cpp]"]
  node_tracks["GPX route tracking<br/>[field_tracks.cpp]"]
  node_offline["Offline map service<br/>[offline_maps.cpp]"]
  node_mapstorage[("Map package selection<br/>[map_storage.cpp]")]
  node_mappage["Phone map page<br/>[mappage.h]"]
end

subgraph group_content["Survival content"]
  node_doc["Wiki content access<br/>[doc.cpp]"]
  node_translate["Wiki translation<br/>[translate_wiki.py]"]
  node_polish["Thai wiki editing"]
  node_extra["Field topic content<br/>[thai_wiki_extra.py]"]
  node_hazards["Hazard topic content"]
  node_summaries["Article summaries"]
end

subgraph group_maptools["Map preparation tools"]
  node_mapapp["Phone map app<br/>[app.js]"]
  node_renderer["Vector tile renderer<br/>[renderer.js]"]
  node_mapbuilder["Offline map builder<br/>[builder.py]"]
end

node_user(("Device or phone user"))

node_user -->|"uses device"| node_main
node_user -->|"opens hotspot"| node_web
node_user -->|"uses map app"| node_mapapp
node_main -.->|"starts service"| node_web
node_main -->|"starts GPS"| node_gps
node_main -->|"uses field hardware"| node_field
node_main -->|"uses route tracking"| node_tracks
node_main -->|"uses map service"| node_offline
node_main -->|"uses map selection"| node_mapstorage
node_main -->|"uses messaging"| node_mesh
node_main -.->|"reads wiki"| node_doc
node_web -->|"dispatches messages"| node_mesh
node_web -->|"serves page"| node_meshpage
node_web -->|"serves page"| node_mappage
node_web -->|"checks map revision"| node_mapstorage
node_web -->|"serves track endpoint"| node_tracks
node_web -->|"serves page"| node_tools
node_mapapp -->|"renders tiles"| node_renderer
node_mapbuilder -.->|"supports map preparation"| node_mapapp
node_polish -->|"imports topics"| node_extra
node_polish -->|"imports topics"| node_hazards
node_polish -->|"imports summaries"| node_summaries
node_translate -.->|"precedes editing"| node_polish

click node_main "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/main.cpp"
click node_web "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/web.cpp"
click node_mesh "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/mesh.cpp"
click node_meshpage "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/meshpage.h"
click node_tools "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/toolspage.h"
click node_field "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/field_hardware.cpp"
click node_gps "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/gps.cpp"
click node_tracks "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/field_tracks.cpp"
click node_offline "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/offline_maps.cpp"
click node_mapstorage "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/map_storage.cpp"
click node_mappage "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/mappage.h"
click node_doc "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/doc.cpp"
click node_translate "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/translate_wiki.py"
click node_polish "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/polish_thai_wiki.py"
click node_extra "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/thai_wiki_extra.py"
click node_hazards "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/thai_wiki_hazards.py"
click node_summaries "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/thai_wiki_summaries.py"
click node_mapapp "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/map-app/app.js"
click node_renderer "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/map-app/renderer.js"
click node_mapbuilder "https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/offline_maps/builder.py"

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_main,node_web,node_mesh,node_meshpage,node_tools,node_field,node_user toneBlue
class node_gps,node_tracks,node_offline,node_mapstorage,node_mappage toneAmber
class node_doc,node_translate,node_polish,node_extra,node_hazards,node_summaries toneMint
class node_mapapp,node_renderer,node_mapbuilder toneRose
```

## Components

### Device firmware

- [Firmware runtime](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/main.cpp): `firmware/src/main.cpp`
- [Hotspot web service](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/web.cpp): `firmware/src/web.cpp`
- [LoRa messaging](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/mesh.cpp): `firmware/src/mesh.cpp`
- [Messaging page](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/meshpage.h): `firmware/src/meshpage.h`
- [Device tools page](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/toolspage.h): `firmware/src/toolspage.h`
- [Field hardware](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/field_hardware.cpp): `firmware/src/field_hardware.cpp`

### Maps and field navigation

- [GPS service](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/gps.cpp): `firmware/src/gps.cpp`
- [GPX route tracking](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/field_tracks.cpp): `firmware/src/field_tracks.cpp`
- [Offline map service](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/offline_maps.cpp): `firmware/src/offline_maps.cpp`
- [Map package selection](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/map_storage.cpp): `firmware/src/map_storage.cpp`
- [Phone map page](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/mappage.h): `firmware/src/mappage.h`

### Survival content

- [Wiki content access](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/firmware/src/doc.cpp): `firmware/src/doc.cpp`
- [Wiki translation](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/translate_wiki.py): `scripts/translate_wiki.py`
- [Thai wiki editing](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/polish_thai_wiki.py): `scripts/polish_thai_wiki.py`
- [Field topic content](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/thai_wiki_extra.py): `scripts/thai_wiki_extra.py`
- [Hazard topic content](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/thai_wiki_hazards.py): `scripts/thai_wiki_hazards.py`
- [Article summaries](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/thai_wiki_summaries.py): `scripts/thai_wiki_summaries.py`

### Map preparation tools

- [Phone map app](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/map-app/app.js): `scripts/map-app/app.js`
- [Vector tile renderer](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/map-app/renderer.js): `scripts/map-app/renderer.js`
- [Offline map builder](https://github.com/zmikiz1423/esp32-cyd-survival-wiki-thai/blob/main/scripts/offline_maps/builder.py): `scripts/offline_maps/builder.py`

### Other components

- **Device or phone user**

## Connections

- Device or phone user → Firmware runtime: uses device
- Device or phone user → Hotspot web service: opens hotspot
- Device or phone user → Phone map app: uses map app
- Firmware runtime → Hotspot web service: starts service
- Firmware runtime → GPS service: starts GPS (evidence: `firmware/src/main.cpp`)
- Firmware runtime → Field hardware: uses field hardware (evidence: `firmware/src/main.cpp`)
- Firmware runtime → GPX route tracking: uses route tracking (evidence: `firmware/src/main.cpp`)
- Firmware runtime → Offline map service: uses map service (evidence: `firmware/src/main.cpp`)
- Firmware runtime → Map package selection: uses map selection (evidence: `firmware/src/main.cpp`)
- Firmware runtime → LoRa messaging: uses messaging (evidence: `firmware/src/main.cpp`)
- Firmware runtime → Wiki content access: reads wiki
- Hotspot web service → LoRa messaging: dispatches messages (evidence: `firmware/src/web.cpp`)
- Hotspot web service → Messaging page: serves page (evidence: `firmware/src/web.cpp`)
- Hotspot web service → Phone map page: serves page (evidence: `firmware/src/web.cpp`)
- Hotspot web service → Map package selection: checks map revision (evidence: `firmware/src/web.cpp`)
- Hotspot web service → GPX route tracking: serves track endpoint (evidence: `firmware/src/web.cpp`)
- Hotspot web service → Device tools page: serves page (evidence: `firmware/src/web.cpp`)
- Phone map app → Vector tile renderer: renders tiles (evidence: `scripts/map-app/app.js`)
- Offline map builder → Phone map app: supports map preparation
- Thai wiki editing → Field topic content: imports topics (evidence: `scripts/polish_thai_wiki.py`)
- Thai wiki editing → Hazard topic content: imports topics (evidence: `scripts/polish_thai_wiki.py`)
- Thai wiki editing → Article summaries: imports summaries (evidence: `scripts/polish_thai_wiki.py`)
- Wiki translation → Thai wiki editing: precedes editing (evidence: `scripts/polish_thai_wiki.py`)
