# raijadaniyel045-creator/ancient-buildings architecture

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

- Interactive diagram: https://gitdiagram.com/raijadaniyel045-creator/ancient-buildings
- Repository: https://github.com/raijadaniyel045-creator/ancient-buildings

## Overview

This is a Nuxt application for exploring Chinese historic architecture, with additional AI tutoring, data dashboards, accounts, a forum, and social features. The principal user journey begins at the architectural showcase and branches into building discovery; account-backed features support forum and friend interactions. Sampled code confirms account/session behavior and some API requests, but most page implementations and the backend are unsampled, so their internal connections are left out or marked unverified.

Main entry points: [`app/stores/useAccountStore.ts`](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/stores/useAccountStore.ts) (Account session), [`app/pages/ai-tutor.vue`](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/ai-tutor.vue) (AI tutor), [`app/pages/buildings/index.vue`](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/buildings/index.vue) (Building catalog), [`app/stores/usePostStore.ts`](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/stores/usePostStore.ts) (Forum post store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_explore["Architecture exploration"]
  node_home["Architecture showcase<br/>[index.vue]"]
  node_building_list["Building catalog<br/>[index.vue]"]
  node_building_detail["Building details<br/>[&#91;hash&#93;.vue]"]
  node_building_name["Name lookup<br/>[&#91;name&#93;.vue]"]
  node_building_card["Building card"]
  node_action_pages["Heritage actions"]
  node_daily_story["Daily story<br/>[useDailyStory.ts]"]
end

subgraph group_insights["AI and insights"]
  node_ai_tutor["AI tutor<br/>[ai-tutor.vue]"]
  node_ai_chat["AI chat<br/>[AiChat.vue]"]
  node_ai_quiz["AI quiz<br/>[AiQuiz.vue]"]
  node_ai_route["AI route<br/>[AiRoute.vue]"]
  node_dashboard["Heritage dashboard<br/>[dashboard.vue]"]
  node_dashboard_views["Dashboard visualizations"]
  node_dashboard_api["Dashboard data routes"]
end

subgraph group_community["Community"]
  node_forum["Forum pages"]
  node_post_store["Forum post store<br/>[usePostStore.ts]"]
  node_friends["Friend features"]
  node_friend_search["Friend search<br/>[search.vue]"]
end

subgraph group_identity["Accounts"]
  node_account_pages["Authentication pages"]
  node_account_store["Account session<br/>[useAccountStore.ts]"]
  node_auth_plugin["Authenticated fetch"]
  node_auth_middleware["Route guard<br/>[auth.ts]"]
end

subgraph group_runtime["Application runtime"]
  node_api_types["API schemas<br/>[_types.ts]"]
  node_app_shell["Nuxt app shell<br/>[app.vue]"]
end

node_visitor(("Visitor"))
node_api_service{{"Application API"}}

node_visitor -.->|"opens"| node_home
node_home -.->|"links to"| node_building_list
node_building_list -.->|"opens"| node_building_detail
node_building_list -.->|"renders"| node_building_card
node_building_name -.->|"resolves to"| node_building_detail
node_visitor -.->|"opens"| node_ai_tutor
node_ai_tutor -.->|"uses"| node_ai_chat
node_ai_tutor -.->|"uses"| node_ai_quiz
node_ai_tutor -.->|"uses"| node_ai_route
node_dashboard -.->|"renders"| node_dashboard_views
node_dashboard -.->|"requests data"| node_dashboard_api
node_visitor -.->|"opens"| node_forum
node_forum -.->|"uses"| node_post_store
node_post_store -->|"fetches posts"| node_api_service
node_post_store -->|"fetches summary"| node_api_service
node_visitor -.->|"opens"| node_friends
node_friend_search -->|"searches accounts"| node_api_service
node_friend_search -->|"sends request"| node_api_service
node_visitor -.->|"opens"| node_account_pages
node_account_pages -.->|"uses"| node_account_store
node_auth_plugin -->|"restores session"| node_account_store
node_auth_plugin -->|"refreshes token"| node_account_store
node_auth_middleware -->|"checks session"| node_account_store
node_account_store -->|"authenticates"| node_api_service
node_account_store -->|"loads account"| node_api_service
node_app_shell -.->|"serves app"| node_visitor

click node_home "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/index.vue"
click node_building_list "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/buildings/index.vue"
click node_building_detail "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/buildings/%5Bhash%5D.vue"
click node_building_name "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/buildings/name/%5Bname%5D.vue"
click node_building_card "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/components/buildings/BuildingSlugCard.vue"
click node_action_pages "https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/pages/action"
click node_daily_story "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/composables/useDailyStory.ts"
click node_ai_tutor "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/ai-tutor.vue"
click node_ai_chat "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/components/ai/AiChat.vue"
click node_ai_quiz "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/components/ai/AiQuiz.vue"
click node_ai_route "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/components/ai/AiRoute.vue"
click node_dashboard "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/dashboard.vue"
click node_dashboard_views "https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/components/dashboard"
click node_dashboard_api "https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/server/api/dashboard"
click node_forum "https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/pages/forum"
click node_post_store "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/stores/usePostStore.ts"
click node_friends "https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/pages/friends"
click node_friend_search "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/friends/search.vue"
click node_account_pages "https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/pages/auth"
click node_account_store "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/stores/useAccountStore.ts"
click node_auth_plugin "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/plugins/auth-interceptor.client.ts"
click node_auth_middleware "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/middleware/auth.ts"
click node_api_types "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/types/_types.ts"
click node_app_shell "https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/app.vue"

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_home,node_building_list,node_building_detail,node_building_name,node_building_card,node_action_pages,node_daily_story toneBlue
class node_ai_tutor,node_ai_chat,node_ai_quiz,node_ai_route,node_dashboard,node_dashboard_views,node_dashboard_api toneAmber
class node_forum,node_post_store,node_friends,node_friend_search,node_api_service toneMint
class node_account_pages,node_account_store,node_auth_plugin,node_auth_middleware toneRose
class node_api_types,node_app_shell,node_visitor toneIndigo
```

## Components

### Architecture exploration

- [Architecture showcase](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/index.vue): `app/pages/index.vue`
- [Building catalog](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/buildings/index.vue): `app/pages/buildings/index.vue`
- [Building details](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/buildings/%5Bhash%5D.vue): `app/pages/buildings/[hash].vue`
- [Name lookup](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/buildings/name/%5Bname%5D.vue): `app/pages/buildings/name/[name].vue`
- [Building card](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/components/buildings/BuildingSlugCard.vue): `app/components/buildings/BuildingSlugCard.vue`
- [Heritage actions](https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/pages/action): `app/pages/action`
- [Daily story](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/composables/useDailyStory.ts): `app/composables/useDailyStory.ts`

### AI and insights

- [AI tutor](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/ai-tutor.vue): `app/pages/ai-tutor.vue`
- [AI chat](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/components/ai/AiChat.vue): `app/components/ai/AiChat.vue`
- [AI quiz](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/components/ai/AiQuiz.vue): `app/components/ai/AiQuiz.vue`
- [AI route](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/components/ai/AiRoute.vue): `app/components/ai/AiRoute.vue`
- [Heritage dashboard](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/dashboard.vue): `app/pages/dashboard.vue`
- [Dashboard visualizations](https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/components/dashboard): `app/components/dashboard`
- [Dashboard data routes](https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/server/api/dashboard): `server/api/dashboard`

### Community

- [Forum pages](https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/pages/forum): `app/pages/forum`
- [Forum post store](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/stores/usePostStore.ts): `app/stores/usePostStore.ts`
- [Friend features](https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/pages/friends): `app/pages/friends`
- [Friend search](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/pages/friends/search.vue): `app/pages/friends/search.vue`

### Accounts

- [Authentication pages](https://github.com/raijadaniyel045-creator/ancient-buildings/tree/master/app/pages/auth): `app/pages/auth`
- [Account session](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/stores/useAccountStore.ts): `app/stores/useAccountStore.ts`
- [Authenticated fetch](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/plugins/auth-interceptor.client.ts): `app/plugins/auth-interceptor.client.ts`
- [Route guard](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/middleware/auth.ts): `app/middleware/auth.ts`

### Application runtime

- [API schemas](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/types/_types.ts): `app/types/_types.ts`
- [Nuxt app shell](https://github.com/raijadaniyel045-creator/ancient-buildings/blob/master/app/app.vue): `app/app.vue`

### Other components

- **Visitor**
- **Application API**

## Connections

- Visitor → Architecture showcase: opens
- Architecture showcase → Building catalog: links to
- Building catalog → Building details: opens
- Building catalog → Building card: renders
- Name lookup → Building details: resolves to
- Visitor → AI tutor: opens
- AI tutor → AI chat: uses
- AI tutor → AI quiz: uses
- AI tutor → AI route: uses
- Heritage dashboard → Dashboard visualizations: renders
- Heritage dashboard → Dashboard data routes: requests data
- Visitor → Forum pages: opens
- Forum pages → Forum post store: uses
- Forum post store → Application API: fetches posts (evidence: `app/stores/usePostStore.ts`)
- Forum post store → Application API: fetches summary (evidence: `app/stores/usePostStore.ts`)
- Visitor → Friend features: opens
- Friend search → Application API: searches accounts (evidence: `app/pages/friends/search.vue`)
- Friend search → Application API: sends request (evidence: `app/pages/friends/search.vue`)
- Visitor → Authentication pages: opens
- Authentication pages → Account session: uses
- Authenticated fetch → Account session: restores session (evidence: `app/plugins/auth-interceptor.client.ts`)
- Authenticated fetch → Account session: refreshes token (evidence: `app/plugins/auth-interceptor.client.ts`)
- Route guard → Account session: checks session (evidence: `app/middleware/auth.ts`)
- Account session → Application API: authenticates (evidence: `app/stores/useAccountStore.ts`)
- Account session → Application API: loads account (evidence: `app/stores/useAccountStore.ts`)
- Nuxt app shell → Visitor: serves app
