# dave0428/tandaapplication architecture

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

- Interactive diagram: https://gitdiagram.com/dave0428/tandaapplication
- Repository: https://github.com/dave0428/tandaapplication

## Overview

TANDA is an offline-friendly bilingual guides-and-games app for Filipino seniors. Users browse or play on the phone, with read-aloud and voice controls; signed-in users can sync progress to an account, while the optional AI helper answers questions. The server also provides account and admin APIs. The graph includes the documented local-first sync and offline behavior. Frontend wiring beyond the shown excerpts is based on README descriptions; native plugin integration is not established by the sampled source.

Main entry points: [`public/js/events.js`](https://github.com/dave0428/tandaapplication/blob/main/public/js/events.js) (Tap and voice actions), [`server/server.js`](https://github.com/dave0428/tandaapplication/blob/main/server/server.js) (HTTP server), [`public/js/ui.js`](https://github.com/dave0428/tandaapplication/blob/main/public/js/ui.js) (Screens), [`public/index.html`](https://github.com/dave0428/tandaapplication/blob/main/public/index.html) (TANDA app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_phone_app["Phone app"]
  node_app["TANDA app<br/>[index.html]"]
  node_ui["Screens<br/>[ui.js]"]
  node_events["Tap and voice actions<br/>[events.js]"]
  node_language["English and Tagalog<br/>[i18n.js]"]
  node_voice["Read-aloud voice<br/>[voice.js]"]
  node_local_state["Local progress<br/>[state.js]"]
  node_offline["Offline cache<br/>[sw.js]"]
end

subgraph group_learning["Guides and games"]
  node_guides["Phone guides<br/>[tutorials.js]"]
  node_games["Five games<br/>[games.js]"]
  node_ai_client["AI engine choice<br/>[ai.js]"]
  node_ai_prompt["AI guidance<br/>[ai-glue.js]"]
end

subgraph group_server_api["Server API"]
  node_api_client["API client<br/>[api.js]"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth["Accounts and auth<br/>[auth.js]"]
  node_progress["Progress and game results<br/>[progress.js]"]
  node_ai_route["AI proxy<br/>[ai.js]"]
  node_admin_ui["Admin dashboard<br/>[admin.html]"]
  node_admin_api["Admin management<br/>[admin.js]"]
end

subgraph group_persistence["Persistence"]
  node_db_layer["Database adapter<br/>[db.js]"]
  node_database[("Account and activity data")]
end

subgraph group_integrations["External services"]
  node_anthropic["Anthropic API"]
  node_claude["Claude artifact"]
  node_native["Phone platform"]
end

node_senior(("Senior user"))

node_senior -->|"opens"| node_app
node_app -->|"loads screens"| node_ui
node_app -->|"loads actions"| node_events
node_senior -->|"taps or speaks"| node_events
node_events -->|"updates screens"| node_ui
node_ui -->|"shows guides"| node_guides
node_ui -->|"shows games"| node_games
node_ui -->|"uses translations"| node_language
node_events -->|"controls speech"| node_voice
node_events -->|"saves changes"| node_local_state
node_local_state -->|"requests sync"| node_api_client
node_app -->|"caches app files"| node_offline
node_events -->|"sends questions"| node_ai_client
node_ai_client -->|"uses instructions"| node_ai_prompt
node_ai_client -.->|"uses when available"| node_claude
node_ai_client -->|"uses server option"| node_api_client
node_api_client -->|"calls API"| node_server
node_server -->|"mounts routes"| node_auth
node_server -->|"mounts routes"| node_progress
node_server -->|"mounts routes"| node_ai_route
node_server -->|"mounts routes"| node_admin_api
node_auth -->|"reads and writes"| node_db_layer
node_progress -->|"reads and writes"| node_db_layer
node_admin_api -->|"reads and writes"| node_db_layer
node_db_layer -->|"persists records"| node_database
node_ai_route -->|"requests answers"| node_anthropic
node_admin_ui -->|"uses admin API"| node_admin_api
node_events -.->|"may invoke device actions"| node_native

click node_app "https://github.com/dave0428/tandaapplication/blob/main/public/index.html"
click node_ui "https://github.com/dave0428/tandaapplication/blob/main/public/js/ui.js"
click node_events "https://github.com/dave0428/tandaapplication/blob/main/public/js/events.js"
click node_language "https://github.com/dave0428/tandaapplication/blob/main/public/js/i18n.js"
click node_voice "https://github.com/dave0428/tandaapplication/blob/main/public/js/voice.js"
click node_local_state "https://github.com/dave0428/tandaapplication/blob/main/public/js/state.js"
click node_offline "https://github.com/dave0428/tandaapplication/blob/main/public/sw.js"
click node_guides "https://github.com/dave0428/tandaapplication/blob/main/public/js/tutorials.js"
click node_games "https://github.com/dave0428/tandaapplication/blob/main/public/js/games.js"
click node_ai_client "https://github.com/dave0428/tandaapplication/blob/main/public/js/ai.js"
click node_ai_prompt "https://github.com/dave0428/tandaapplication/blob/main/public/js/ai-glue.js"
click node_api_client "https://github.com/dave0428/tandaapplication/blob/main/public/js/api.js"
click node_server "https://github.com/dave0428/tandaapplication/blob/main/server/server.js"
click node_auth "https://github.com/dave0428/tandaapplication/blob/main/server/routes/auth.js"
click node_progress "https://github.com/dave0428/tandaapplication/blob/main/server/routes/progress.js"
click node_ai_route "https://github.com/dave0428/tandaapplication/blob/main/server/routes/ai.js"
click node_admin_ui "https://github.com/dave0428/tandaapplication/blob/main/public/admin.html"
click node_admin_api "https://github.com/dave0428/tandaapplication/blob/main/server/routes/admin.js"
click node_db_layer "https://github.com/dave0428/tandaapplication/blob/main/server/db.js"
click node_database "https://github.com/dave0428/tandaapplication/tree/main/server/migrations"

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_events,node_language,node_voice,node_local_state,node_offline,node_senior toneBlue
class node_guides,node_games,node_ai_client,node_ai_prompt toneAmber
class node_api_client,node_server,node_auth,node_progress,node_ai_route,node_admin_ui,node_admin_api toneMint
class node_db_layer,node_database toneRose
class node_anthropic,node_claude,node_native toneIndigo
```

## Components

### Phone app

- [TANDA app](https://github.com/dave0428/tandaapplication/blob/main/public/index.html): `public/index.html`
- [Screens](https://github.com/dave0428/tandaapplication/blob/main/public/js/ui.js): `public/js/ui.js`
- [Tap and voice actions](https://github.com/dave0428/tandaapplication/blob/main/public/js/events.js): `public/js/events.js`
- [English and Tagalog](https://github.com/dave0428/tandaapplication/blob/main/public/js/i18n.js): `public/js/i18n.js`
- [Read-aloud voice](https://github.com/dave0428/tandaapplication/blob/main/public/js/voice.js): `public/js/voice.js`
- [Local progress](https://github.com/dave0428/tandaapplication/blob/main/public/js/state.js): `public/js/state.js`
- [Offline cache](https://github.com/dave0428/tandaapplication/blob/main/public/sw.js): `public/sw.js`

### Guides and games

- [Phone guides](https://github.com/dave0428/tandaapplication/blob/main/public/js/tutorials.js): `public/js/tutorials.js`
- [Five games](https://github.com/dave0428/tandaapplication/blob/main/public/js/games.js): `public/js/games.js`
- [AI engine choice](https://github.com/dave0428/tandaapplication/blob/main/public/js/ai.js): `public/js/ai.js`
- [AI guidance](https://github.com/dave0428/tandaapplication/blob/main/public/js/ai-glue.js): `public/js/ai-glue.js`

### Server API

- [API client](https://github.com/dave0428/tandaapplication/blob/main/public/js/api.js): `public/js/api.js`
- [HTTP server](https://github.com/dave0428/tandaapplication/blob/main/server/server.js): `server/server.js`
- [Accounts and auth](https://github.com/dave0428/tandaapplication/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Progress and game results](https://github.com/dave0428/tandaapplication/blob/main/server/routes/progress.js): `server/routes/progress.js`
- [AI proxy](https://github.com/dave0428/tandaapplication/blob/main/server/routes/ai.js): `server/routes/ai.js`
- [Admin dashboard](https://github.com/dave0428/tandaapplication/blob/main/public/admin.html): `public/admin.html`
- [Admin management](https://github.com/dave0428/tandaapplication/blob/main/server/routes/admin.js): `server/routes/admin.js`

### Persistence

- [Database adapter](https://github.com/dave0428/tandaapplication/blob/main/server/db.js): `server/db.js`
- [Account and activity data](https://github.com/dave0428/tandaapplication/tree/main/server/migrations): `server/migrations`

### External services

- **Anthropic API**
- **Claude artifact**
- **Phone platform**

### Other components

- **Senior user**

## Connections

- Senior user → TANDA app: opens (evidence: `README.md`)
- TANDA app → Screens: loads screens (evidence: `README.md`)
- TANDA app → Tap and voice actions: loads actions (evidence: `README.md`)
- Senior user → Tap and voice actions: taps or speaks (evidence: `public/js/events.js`)
- Tap and voice actions → Screens: updates screens (evidence: `public/js/events.js`)
- Screens → Phone guides: shows guides (evidence: `README.md`)
- Screens → Five games: shows games (evidence: `public/js/games.js`)
- Screens → English and Tagalog: uses translations (evidence: `README.md`)
- Tap and voice actions → Read-aloud voice: controls speech (evidence: `public/js/events.js`)
- Tap and voice actions → Local progress: saves changes (evidence: `README.md`)
- Local progress → API client: requests sync (evidence: `README.md`)
- TANDA app → Offline cache: caches app files (evidence: `public/sw.js`)
- Tap and voice actions → AI engine choice: sends questions (evidence: `public/js/events.js`)
- AI engine choice → AI guidance: uses instructions (evidence: `README.md`)
- AI engine choice → Claude artifact: uses when available (evidence: `README.md`)
- AI engine choice → API client: uses server option (evidence: `README.md`)
- API client → HTTP server: calls API (evidence: `README.md`)
- HTTP server → Accounts and auth: mounts routes (evidence: `server/server.js`)
- HTTP server → Progress and game results: mounts routes (evidence: `server/server.js`)
- HTTP server → AI proxy: mounts routes (evidence: `server/server.js`)
- HTTP server → Admin management: mounts routes (evidence: `server/server.js`)
- Accounts and auth → Database adapter: reads and writes (evidence: `server/routes/auth.js`)
- Progress and game results → Database adapter: reads and writes (evidence: `server/routes/progress.js`)
- Admin management → Database adapter: reads and writes (evidence: `server/routes/admin.js`)
- Database adapter → Account and activity data: persists records (evidence: `server/db.js`)
- AI proxy → Anthropic API: requests answers (evidence: `server/routes/ai.js`)
- Admin dashboard → Admin management: uses admin API (evidence: `README.md`)
- Tap and voice actions → Phone platform: may invoke device actions
