# fengfengzhidao/ffzd_site architecture

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

- Interactive diagram: https://gitdiagram.com/fengfengzhidao/ffzd_site
- Repository: https://github.com/fengfengzhidao/ffzd_site

## Overview

这是一个 Go、SQLite 和服务端模板构建的单管理员博客。主要流程是访客浏览文章、分类/标签与专题页面，管理员登录后维护文章和封面；访客也可提交反馈。HTTP 层负责路由、鉴权和页面处理，Store 提供持久化能力，Markdown 渲染与静态管理界面支撑内容编辑。README 还列出 SEO 与访问统计。未展示的具体调用关系未作确定连线。

Main entry points: [`internal/app/http.go`](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go) (HTTP 应用与路由), [`internal/app/store.go`](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/store.go) (数据访问), [`cmd/blog/main.go`](https://github.com/fengfengzhidao/ffzd_site/blob/main/cmd/blog/main.go) (程序入口), [`internal/app/static/app.js`](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/static/app.js) (管理交互)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["运行与安全"]
  node_entry["程序入口<br/>[main.go]"]
  node_configuration["配置加载<br/>[config.go]"]
  node_http["HTTP 应用与路由<br/>[http.go]"]
  node_store["数据访问<br/>[store.go]"]
  node_database[("SQLite 数据库<br/>[store.go]")]
end

subgraph group_publishing["内容发布"]
  node_public["文章与归档页面<br/>[http.go]"]
  node_markdown["Markdown 渲染<br/>[markdown.go]"]
  node_public_templates["公开页面模板"]
  node_topics["专题与文档树<br/>[http.go]"]
end

subgraph group_engagement["访客功能"]
  node_feedback["访客反馈<br/>[http.go]"]
end

subgraph group_operations["管理运营"]
  node_admin_auth["管理员认证<br/>[http.go]"]
  node_authoring["文章管理<br/>[http.go]"]
  node_covers["封面与图片<br/>[http.go]"]
  node_analytics["访问统计<br/>[store.go]"]
  node_settings_seo["站点设置与 SEO<br/>[http.go]"]
  node_admin_ui["管理交互<br/>[app.js]"]
end

node_operator(("站点运营者"))
node_visitor(("访客"))

node_entry -->|"加载配置"| node_configuration
node_entry -->|"创建并启动"| node_http
node_operator -.->|"管理请求"| node_http
node_visitor -.->|"浏览与提交"| node_http
node_http -->|"初始化存储"| node_store
node_store -->|"读写数据"| node_database
node_http -->|"路由处理"| node_public
node_public -.->|"渲染页面"| node_public_templates
node_public -.->|"查询文章"| node_store
node_http -->|"路由处理"| node_topics
node_topics -.->|"读取专题"| node_store
node_http -->|"处理提交"| node_feedback
node_feedback -->|"保存反馈"| node_store
node_http -->|"路由与鉴权"| node_admin_auth
node_http -->|"后台路由"| node_authoring
node_authoring -->|"保存文章"| node_store
node_authoring -.->|"转换内容"| node_markdown
node_http -->|"后台路由"| node_covers
node_covers -->|"管理封面"| node_store
node_http -.->|"统计页面"| node_analytics
node_http -.->|"管理与生成"| node_settings_seo
node_admin_ui -.->|"提交表单"| node_http
node_admin_ui -.->|"上传交互"| node_covers

click node_entry "https://github.com/fengfengzhidao/ffzd_site/blob/main/cmd/blog/main.go"
click node_configuration "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/config.go"
click node_http "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go"
click node_store "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/store.go"
click node_database "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/store.go"
click node_public "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go"
click node_markdown "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/markdown.go"
click node_public_templates "https://github.com/fengfengzhidao/ffzd_site/tree/main/internal/app/templates"
click node_topics "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go"
click node_feedback "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go"
click node_admin_auth "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go"
click node_authoring "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go"
click node_covers "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go"
click node_analytics "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/store.go"
click node_settings_seo "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go"
click node_admin_ui "https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/static/app.js"

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_entry,node_configuration,node_http,node_store,node_database toneBlue
class node_public,node_markdown,node_public_templates,node_topics toneAmber
class node_feedback toneMint
class node_admin_auth,node_authoring,node_covers,node_analytics,node_settings_seo,node_admin_ui toneRose
class node_operator,node_visitor toneIndigo
```

## Components

### 运行与安全

- [程序入口](https://github.com/fengfengzhidao/ffzd_site/blob/main/cmd/blog/main.go): `cmd/blog/main.go`
- [配置加载](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/config.go): `internal/app/config.go`
- [HTTP 应用与路由](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go): `internal/app/http.go`
- [数据访问](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/store.go): `internal/app/store.go`
- [SQLite 数据库](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/store.go): `internal/app/store.go`

### 内容发布

- [文章与归档页面](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go): `internal/app/http.go`
- [Markdown 渲染](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/markdown.go): `internal/app/markdown.go`
- [公开页面模板](https://github.com/fengfengzhidao/ffzd_site/tree/main/internal/app/templates): `internal/app/templates`
- [专题与文档树](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go): `internal/app/http.go`

### 访客功能

- [访客反馈](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go): `internal/app/http.go`

### 管理运营

- [管理员认证](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go): `internal/app/http.go`
- [文章管理](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go): `internal/app/http.go`
- [封面与图片](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go): `internal/app/http.go`
- [访问统计](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/store.go): `internal/app/store.go`
- [站点设置与 SEO](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/http.go): `internal/app/http.go`
- [管理交互](https://github.com/fengfengzhidao/ffzd_site/blob/main/internal/app/static/app.js): `internal/app/static/app.js`

### Other components

- **站点运营者**
- **访客**

## Connections

- 程序入口 → 配置加载: 加载配置 (evidence: `cmd/blog/main.go`)
- 程序入口 → HTTP 应用与路由: 创建并启动 (evidence: `cmd/blog/main.go`)
- 站点运营者 → HTTP 应用与路由: 管理请求
- 访客 → HTTP 应用与路由: 浏览与提交
- HTTP 应用与路由 → 数据访问: 初始化存储 (evidence: `internal/app/http.go`)
- 数据访问 → SQLite 数据库: 读写数据 (evidence: `internal/app/store.go`)
- HTTP 应用与路由 → 文章与归档页面: 路由处理 (evidence: `internal/app/http.go`)
- 文章与归档页面 → 公开页面模板: 渲染页面
- 文章与归档页面 → 数据访问: 查询文章
- HTTP 应用与路由 → 专题与文档树: 路由处理 (evidence: `internal/app/http.go`)
- 专题与文档树 → 数据访问: 读取专题
- HTTP 应用与路由 → 访客反馈: 处理提交 (evidence: `internal/app/http.go`)
- 访客反馈 → 数据访问: 保存反馈 (evidence: `internal/app/http.go`)
- HTTP 应用与路由 → 管理员认证: 路由与鉴权 (evidence: `internal/app/http.go`)
- HTTP 应用与路由 → 文章管理: 后台路由 (evidence: `internal/app/http.go`)
- 文章管理 → 数据访问: 保存文章 (evidence: `internal/app/http.go`)
- 文章管理 → Markdown 渲染: 转换内容
- HTTP 应用与路由 → 封面与图片: 后台路由 (evidence: `internal/app/http.go`)
- 封面与图片 → 数据访问: 管理封面 (evidence: `internal/app/http.go`)
- HTTP 应用与路由 → 访问统计: 统计页面
- HTTP 应用与路由 → 站点设置与 SEO: 管理与生成 (evidence: `internal/app/http.go`)
- 管理交互 → HTTP 应用与路由: 提交表单
- 管理交互 → 封面与图片: 上传交互
