OpenFlare/docs/reference/repository.md

仓库结构

路径	职责
openflare_server	Gin + GORM + SQLite/PostgreSQL 单体控制面
openflare_server/web	Next.js 15 App Router 管理端前端，静态导出后由 Go Server 托管
openflare_agent	Go 单体 Agent，运行在节点侧
scripts	Agent 安装、卸载等辅助脚本
docs	VitePress 文档站、设计基线、开发规范、部署与配置文档

Server 分层

目录	职责
controller/	参数解析、调用 service、返回响应
service/	业务逻辑、校验、事务编排、配置渲染
model/	模型定义、数据库版本与迁移
router/	路由注册
middleware/	认证、鉴权、限流等横切逻辑
common/	配置、全局状态与初始化入口
utils/	纯工具函数与通用 helper

Agent 模块

模块	职责
config	配置读取与默认值
heartbeat	心跳与版本摘要判断
sync	配置拉取与应用编排
nginx / openresty	OpenResty 文件写入、校验、reload 与 Docker 模式管理
state	本地状态与观测补报缓冲
httpclient	Server 通信
protocol	Agent API 协议类型
internal/updater	Agent 自更新

Frontend 分层

目录	职责
app/	路由、布局、页面组装
features/	按业务域组织模块
components/	跨 feature 复用组件
lib/	请求客户端、环境变量、工具函数、常量
store/	少量跨页面 UI 状态
types/	共享类型定义