vite-press init

docs/design/architecture.md

@@ -0,0 +1,54 @@
+# 系统架构
+
+OpenFlare 由 Server、Agent 与节点本地 OpenResty 组成。
+
+```text
+OpenFlare Server (Gin + SQLite/PostgreSQL + Web UI)
+        |
+        | HTTP API / Config Pull
+        v
+OpenFlare Agent (register / heartbeat / sync / apply / update)
+        |
+        v
+Local OpenResty or Docker OpenResty
+        |
+        v
+Origin
+```
+
+## Server
+
+`openflare_server` 是单体控制面：
+
+* Gin
+* GORM
+* SQLite / PostgreSQL
+* 现有登录与 Session 体系
+* 托管 `openflare_server/web` 静态构建产物
+
+Server 负责管理端 UI 与 API、Agent API、配置渲染、版本发布、数据存储与聚合查询。
+
+## Agent
+
+`openflare_agent` 是 Go 单体程序：
+
+* 单二进制
+* 节点本地执行
+* 优先使用 `openresty_path`
+* 未配置 `openresty_path` 时默认使用 Docker OpenResty
+
+Agent 负责首次注册、周期性心跳、配置同步、文件写入、`openresty -t`、reload、失败回滚、自更新与轻量采集。
+
+## Frontend
+
+`openflare_server/web` 是正式管理端前端：
+
+* Next.js App Router
+* React 19
+* TypeScript
+* Tailwind CSS
+* 静态导出后由 Go Server 托管
+
+## 核心对象
+
+当前有效实体包括 `proxy_routes`、`origins`、`config_versions`、`nodes`、`apply_logs`、`tls_certificates`、`managed_domains`、`node_request_reports`、`node_access_logs`、`node_metric_snapshots`、`traffic_analytics_rollups` 与 `node_health_events`。