# anto34mtp/clashofclans architecture

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

- Interactive diagram: https://gitdiagram.com/anto34mtp/clashofclans
- Repository: https://github.com/anto34mtp/clashofclans

## Overview

CoC Tracker is a multi-user village progression and upgrade-planning site. Players register, create villages, import game state through pasted JSON or the official Clash of Clans API, then view catalog-based upgrade suggestions and track manually started timers. The graph separates account/village management, imports, planning, and persistence. Source excerpts show the JSON and planner paths; API endpoint internals and browser-side dispatch are not fully sampled, so those links rely on documented capabilities or are omitted where uncertain.

Main entry points: [`includes/functions.php`](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/functions.php) (Upgrade Planner), [`database/schema.sql`](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/database/schema.sql) (MySQL Store), [`village.php`](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/village.php) (Village View), [`api/start_upgrade.php`](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/api/start_upgrade.php) (Upgrade Actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and Villages"]
  node_account_pages["Account Pages<br/>[login.php]"]
  node_dashboard["Village Dashboard<br/>[dashboard.php]"]
  node_village["Village View<br/>[village.php]"]
end

subgraph group_imports["Village Imports"]
  node_import_form["Import Screen<br/>[import.php]"]
  node_json_parser["JSON Import<br/>[json_import.php]"]
  node_api_import["API Sync Endpoint<br/>[import_api.php]"]
  node_coc_api["CoC API Client<br/>[coc_api.php]"]
  node_building_map["Building ID Map"]
end

subgraph group_planning["Planning and Upgrades"]
  node_planner["Upgrade Planner<br/>[functions.php]"]
  node_upgrade_endpoints["Upgrade Actions<br/>[start_upgrade.php]"]
  node_upgrade_list["Upgrade Listing<br/>[list_upgrades.php]"]
  node_countdown["Live Countdown<br/>[countdown.js]"]
  node_catalog_data["Game Costs and Mapping<br/>[game_data.php]"]
end

subgraph group_runtime["Shared Runtime and Data"]
  node_auth["Authentication<br/>[auth.php]"]
  node_database[("MySQL Store<br/>[schema.sql]")]
  node_db_access["PDO Access<br/>[db.php]"]
  node_api_bootstrap["AJAX Bootstrap<br/>[bootstrap.php]"]
  node_csrf["CSRF Protection<br/>[csrf.php]"]
end

node_player(("Player"))
node_coc_service{{"Clash of Clans API"}}

node_player -->|"signs in"| node_account_pages
node_account_pages -->|"authenticates"| node_auth
node_player -->|"manages villages"| node_dashboard
node_dashboard -->|"requires login"| node_auth
node_dashboard -->|"creates and lists"| node_database
node_player -->|"views progress"| node_village
node_village -->|"builds suggestions"| node_planner
node_village -.->|"requests upgrades"| node_upgrade_list
node_player -->|"submits game data"| node_import_form
node_import_form -->|"parses and resolves"| node_json_parser
node_json_parser -->|"looks up IDs"| node_building_map
node_json_parser -->|"writes village state"| node_database
node_player -->|"requests API sync"| node_api_import
node_api_import -->|"uses client"| node_coc_api
node_coc_api -->|"fetches player data"| node_coc_service
node_api_import -->|"loads shared bootstrap"| node_api_bootstrap
node_planner -->|"reads village and catalog"| node_database
node_planner -.->|"uses costs and durations"| node_catalog_data
node_upgrade_endpoints -->|"loads shared bootstrap"| node_api_bootstrap
node_upgrade_endpoints -.->|"uses upgrade helpers"| node_planner
node_upgrade_endpoints -.->|"records upgrade state"| node_database
node_village -->|"loads timer script"| node_countdown
node_api_bootstrap -->|"loads protection"| node_csrf
node_db_access -->|"connects to"| node_database
node_auth -->|"queries accounts"| node_db_access
node_planner -->|"queries state"| node_db_access

click node_account_pages "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/login.php"
click node_auth "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/auth.php"
click node_dashboard "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/dashboard.php"
click node_village "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/village.php"
click node_import_form "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/import.php"
click node_json_parser "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/json_import.php"
click node_api_import "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/api/import_api.php"
click node_coc_api "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/coc_api.php"
click node_planner "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/functions.php"
click node_upgrade_endpoints "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/api/start_upgrade.php"
click node_upgrade_list "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/api/list_upgrades.php"
click node_countdown "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/assets/js/countdown.js"
click node_catalog_data "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/data/game_data.php"
click node_building_map "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/data/building_id_map.php"
click node_database "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/database/schema.sql"
click node_db_access "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/db.php"
click node_api_bootstrap "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/api/bootstrap.php"
click node_csrf "https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/csrf.php"

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_account_pages,node_dashboard,node_village toneBlue
class node_import_form,node_json_parser,node_api_import,node_coc_api,node_building_map toneAmber
class node_planner,node_upgrade_endpoints,node_upgrade_list,node_countdown,node_catalog_data,node_coc_service toneMint
class node_auth,node_database,node_db_access,node_api_bootstrap,node_csrf toneRose
class node_player toneIndigo
```

## Components

### Accounts and Villages

- [Account Pages](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/login.php): `login.php`
- [Village Dashboard](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/dashboard.php): `dashboard.php`
- [Village View](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/village.php): `village.php`

### Village Imports

- [Import Screen](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/import.php): `import.php`
- [JSON Import](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/json_import.php): `includes/json_import.php`
- [API Sync Endpoint](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/api/import_api.php): `api/import_api.php`
- [CoC API Client](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/coc_api.php): `includes/coc_api.php`
- [Building ID Map](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/data/building_id_map.php): `data/building_id_map.php`

### Planning and Upgrades

- [Upgrade Planner](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/functions.php): `includes/functions.php`
- [Upgrade Actions](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/api/start_upgrade.php): `api/start_upgrade.php`
- [Upgrade Listing](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/api/list_upgrades.php): `api/list_upgrades.php`
- [Live Countdown](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/assets/js/countdown.js): `assets/js/countdown.js`
- [Game Costs and Mapping](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/data/game_data.php): `data/game_data.php`

### Shared Runtime and Data

- [Authentication](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/auth.php): `includes/auth.php`
- [MySQL Store](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/database/schema.sql): `database/schema.sql`
- [PDO Access](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/db.php): `includes/db.php`
- [AJAX Bootstrap](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/api/bootstrap.php): `api/bootstrap.php`
- [CSRF Protection](https://github.com/anto34mtp/clashofclans/blob/claude/clash-of-clans-village-tracker-q27i59/includes/csrf.php): `includes/csrf.php`

### Other components

- **Player**
- **Clash of Clans API**

## Connections

- Player → Account Pages: signs in (evidence: `README.md`)
- Account Pages → Authentication: authenticates (evidence: `includes/auth.php`)
- Player → Village Dashboard: manages villages (evidence: `dashboard.php`)
- Village Dashboard → Authentication: requires login (evidence: `dashboard.php`)
- Village Dashboard → MySQL Store: creates and lists (evidence: `dashboard.php`)
- Player → Village View: views progress (evidence: `README.md`)
- Village View → Upgrade Planner: builds suggestions (evidence: `village.php`)
- Village View → Upgrade Listing: requests upgrades
- Player → Import Screen: submits game data (evidence: `import.php`)
- Import Screen → JSON Import: parses and resolves (evidence: `import.php`)
- JSON Import → Building ID Map: looks up IDs (evidence: `README.md`)
- JSON Import → MySQL Store: writes village state (evidence: `includes/json_import.php`)
- Player → API Sync Endpoint: requests API sync (evidence: `README.md`)
- API Sync Endpoint → CoC API Client: uses client (evidence: `api/import_api.php`)
- CoC API Client → Clash of Clans API: fetches player data (evidence: `README.md`)
- API Sync Endpoint → AJAX Bootstrap: loads shared bootstrap (evidence: `api/import_api.php`)
- Upgrade Planner → MySQL Store: reads village and catalog (evidence: `includes/functions.php`)
- Upgrade Planner → Game Costs and Mapping: uses costs and durations (evidence: `README.md`)
- Upgrade Actions → AJAX Bootstrap: loads shared bootstrap (evidence: `api/start_upgrade.php`)
- Upgrade Actions → Upgrade Planner: uses upgrade helpers
- Upgrade Actions → MySQL Store: records upgrade state
- Village View → Live Countdown: loads timer script (evidence: `village.php`)
- AJAX Bootstrap → CSRF Protection: loads protection (evidence: `api/bootstrap.php`)
- PDO Access → MySQL Store: connects to (evidence: `includes/db.php`)
- Authentication → PDO Access: queries accounts (evidence: `includes/auth.php`)
- Upgrade Planner → PDO Access: queries state (evidence: `includes/functions.php`)
