# tud8951/grudge-board architecture

> Architecture diagram of the GitHub repository tud8951/grudge-board, 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/tud8951/grudge-board
- Repository: https://github.com/tud8951/grudge-board

## Overview

Grudge Board is a Chinese-language list application: visitors view ordered entries grouped by tags, while an administrator signs in and manages entries, tags, ordering, bulk imports, and theme settings. Cloudflare Pages Functions expose the API, signed sessions protect administrative operations, and D1 stores application data. The README documents the user-facing capabilities and API routes; sampled handlers confirm several authentication and database interactions, while the HTML and some handlers were not sampled, so those links are limited to documented or dashed relationships.

Main entry points: [`public/admin/index.html`](https://github.com/tud8951/grudge-board/blob/main/public/admin/index.html) (Admin panel), [`functions/_lib/auth.js`](https://github.com/tud8951/grudge-board/blob/main/functions/_lib/auth.js) (Session and access checks), [`schema.sql`](https://github.com/tud8951/grudge-board/blob/main/schema.sql) (D1 database), [`functions/api/public.js`](https://github.com/tud8951/grudge-board/blob/main/functions/api/public.js) (Public data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Web interfaces"]
  node_public_ui["Public page<br/>[index.html]"]
  node_admin_ui["Admin panel<br/>[index.html]"]
end

subgraph group_api["API workflows"]
  node_public_api["Public data<br/>[public.js]"]
  node_login["Login<br/>[login.js]"]
  node_logout["Logout<br/>[logout.js]"]
  node_session_status["Session status<br/>[session.js]"]
  node_entry_ops["Entry editing and order<br/>[entries.js]"]
  node_entry_detail["Entry update and deletion<br/>[&#91;id&#93;.js]"]
  node_bulk_import["Bulk import<br/>[bulk.js]"]
  node_tag_ops["Tag creation and order<br/>[tags.js]"]
  node_tag_assignment["Bulk tag assignment<br/>[entry-tags.js]"]
  node_theme_ops["Theme settings<br/>[settings.js]"]
  node_theme_reset["Theme reset<br/>[reset.js]"]
end

subgraph group_security["Authentication"]
  node_auth["Session and access checks<br/>[auth.js]"]
  node_http["HTTP validation and responses<br/>[http.js]"]
end

subgraph group_data["Application data"]
  node_d1[("D1 database<br/>[schema.sql]")]
end

node_visitor(("Visitor"))
node_admin(("Administrator"))

node_visitor -->|"views"| node_public_ui
node_public_ui -.->|"requests data"| node_public_api
node_public_api -->|"reads settings, tags, entries"| node_d1
node_admin -->|"manages"| node_admin_ui
node_admin_ui -.->|"submits credentials"| node_login
node_admin_ui -.->|"ends session"| node_logout
node_admin_ui -.->|"checks session"| node_session_status
node_admin_ui -.->|"manages entries"| node_entry_ops
node_admin_ui -.->|"edits entries"| node_entry_detail
node_admin_ui -.->|"imports entries"| node_bulk_import
node_admin_ui -.->|"manages tags"| node_tag_ops
node_admin_ui -.->|"assigns tags"| node_tag_assignment
node_admin_ui -.->|"saves theme"| node_theme_ops
node_admin_ui -.->|"resets theme"| node_theme_reset
node_login -->|"verifies and creates session"| node_auth
node_logout -->|"checks and clears session"| node_auth
node_session_status -->|"checks session"| node_auth
node_entry_ops -->|"requires admin"| node_auth
node_entry_detail -->|"requires admin"| node_auth
node_bulk_import -->|"requires admin"| node_auth
node_tag_ops -->|"requires admin"| node_auth
node_tag_assignment -->|"requires admin"| node_auth
node_theme_ops -->|"requires admin"| node_auth
node_theme_reset -->|"requires admin"| node_auth
node_auth -->|"builds auth response"| node_http
node_entry_ops -->|"creates and orders entries"| node_d1
node_entry_detail -->|"updates and deletes entries"| node_d1
node_bulk_import -->|"inserts entries"| node_d1
node_tag_assignment -->|"updates entry tags"| node_d1
node_tag_ops -->|"manages tags"| node_d1
node_theme_ops -->|"saves settings"| node_d1
node_theme_reset -->|"restores defaults"| node_d1
node_public_api -->|"formats response"| node_http

click node_public_ui "https://github.com/tud8951/grudge-board/blob/main/public/index.html"
click node_admin_ui "https://github.com/tud8951/grudge-board/blob/main/public/admin/index.html"
click node_public_api "https://github.com/tud8951/grudge-board/blob/main/functions/api/public.js"
click node_login "https://github.com/tud8951/grudge-board/blob/main/functions/api/login.js"
click node_logout "https://github.com/tud8951/grudge-board/blob/main/functions/api/logout.js"
click node_session_status "https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/session.js"
click node_entry_ops "https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/entries.js"
click node_entry_detail "https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/entries/%5Bid%5D.js"
click node_bulk_import "https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/bulk.js"
click node_tag_ops "https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/tags.js"
click node_tag_assignment "https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/entry-tags.js"
click node_theme_ops "https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/settings.js"
click node_theme_reset "https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/settings/reset.js"
click node_auth "https://github.com/tud8951/grudge-board/blob/main/functions/_lib/auth.js"
click node_http "https://github.com/tud8951/grudge-board/blob/main/functions/_lib/http.js"
click node_d1 "https://github.com/tud8951/grudge-board/blob/main/schema.sql"

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_public_ui,node_admin_ui toneBlue
class node_public_api,node_login,node_logout,node_session_status,node_entry_ops,node_entry_detail,node_bulk_import,node_tag_ops,node_tag_assignment,node_theme_ops,node_theme_reset toneAmber
class node_auth,node_http toneMint
class node_d1 toneRose
class node_visitor,node_admin toneIndigo
```

## Components

### Web interfaces

- [Public page](https://github.com/tud8951/grudge-board/blob/main/public/index.html): `public/index.html`
- [Admin panel](https://github.com/tud8951/grudge-board/blob/main/public/admin/index.html): `public/admin/index.html`

### API workflows

- [Public data](https://github.com/tud8951/grudge-board/blob/main/functions/api/public.js): `functions/api/public.js`
- [Login](https://github.com/tud8951/grudge-board/blob/main/functions/api/login.js): `functions/api/login.js`
- [Logout](https://github.com/tud8951/grudge-board/blob/main/functions/api/logout.js): `functions/api/logout.js`
- [Session status](https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/session.js): `functions/api/admin/session.js`
- [Entry editing and order](https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/entries.js): `functions/api/admin/entries.js`
- [Entry update and deletion](https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/entries/%5Bid%5D.js): `functions/api/admin/entries/[id].js`
- [Bulk import](https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/bulk.js): `functions/api/admin/bulk.js`
- [Tag creation and order](https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/tags.js): `functions/api/admin/tags.js`
- [Bulk tag assignment](https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/entry-tags.js): `functions/api/admin/entry-tags.js`
- [Theme settings](https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/settings.js): `functions/api/admin/settings.js`
- [Theme reset](https://github.com/tud8951/grudge-board/blob/main/functions/api/admin/settings/reset.js): `functions/api/admin/settings/reset.js`

### Authentication

- [Session and access checks](https://github.com/tud8951/grudge-board/blob/main/functions/_lib/auth.js): `functions/_lib/auth.js`
- [HTTP validation and responses](https://github.com/tud8951/grudge-board/blob/main/functions/_lib/http.js): `functions/_lib/http.js`

### Application data

- [D1 database](https://github.com/tud8951/grudge-board/blob/main/schema.sql): `schema.sql`

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Public page: views (evidence: `README.md`)
- Public page → Public data: requests data
- Public data → D1 database: reads settings, tags, entries (evidence: `functions/api/public.js`)
- Administrator → Admin panel: manages (evidence: `README.md`)
- Admin panel → Login: submits credentials
- Admin panel → Logout: ends session
- Admin panel → Session status: checks session
- Admin panel → Entry editing and order: manages entries
- Admin panel → Entry update and deletion: edits entries
- Admin panel → Bulk import: imports entries
- Admin panel → Tag creation and order: manages tags
- Admin panel → Bulk tag assignment: assigns tags
- Admin panel → Theme settings: saves theme
- Admin panel → Theme reset: resets theme
- Login → Session and access checks: verifies and creates session (evidence: `functions/api/login.js`)
- Logout → Session and access checks: checks and clears session (evidence: `functions/api/logout.js`)
- Session status → Session and access checks: checks session (evidence: `functions/api/admin/session.js`)
- Entry editing and order → Session and access checks: requires admin (evidence: `functions/api/admin/entries.js`)
- Entry update and deletion → Session and access checks: requires admin (evidence: `functions/api/admin/entries/[id].js`)
- Bulk import → Session and access checks: requires admin (evidence: `functions/api/admin/bulk.js`)
- Tag creation and order → Session and access checks: requires admin (evidence: `functions/api/admin/tags.js`)
- Bulk tag assignment → Session and access checks: requires admin (evidence: `functions/api/admin/entry-tags.js`)
- Theme settings → Session and access checks: requires admin (evidence: `functions/api/admin/settings.js`)
- Theme reset → Session and access checks: requires admin (evidence: `functions/api/admin/settings/reset.js`)
- Session and access checks → HTTP validation and responses: builds auth response (evidence: `functions/_lib/auth.js`)
- Entry editing and order → D1 database: creates and orders entries (evidence: `functions/api/admin/entries.js`)
- Entry update and deletion → D1 database: updates and deletes entries (evidence: `functions/api/admin/entries/[id].js`)
- Bulk import → D1 database: inserts entries (evidence: `functions/api/admin/bulk.js`)
- Bulk tag assignment → D1 database: updates entry tags (evidence: `functions/api/admin/entry-tags.js`)
- Tag creation and order → D1 database: manages tags (evidence: `README.md`)
- Theme settings → D1 database: saves settings (evidence: `functions/api/admin/settings.js`)
- Theme reset → D1 database: restores defaults (evidence: `functions/api/admin/settings/reset.js`)
- Public data → HTTP validation and responses: formats response (evidence: `functions/api/public.js`)
