[优化] 目录调整

docs/design/architecture.md

@@ -82,6 +82,7 @@ OpenResty (Agent, TLS/WAF)
 * 包含配置编译器（Compiler），将数据库中的规则、证书与全局参数统一编译为不可变的配置快照及 OpenResty 物理配置文件文本。
 * 存储 Pages 部署 ZIP 包于本地 Artifacts 目录，并向 Agent 提供受控的下载接口。
 * 后台集成 Uptime Kuma 监控同步服务，自动为可用站点维护 HTTP 探测任务。
+* Go 物理结构采用 `cmd/server` 启动入口、`internal` 私有应用层与根级 `pkg` 共享能力包，跨组件协议类型统一放在 `pkg/protocol`。
 * *详细设计请参阅：[Agent 与发布模型设计](./agent-design.md) 以及 [Uptime Kuma 监控同步设计](./kuma-design.md)*
 
 ### 2. Agent (配置落地端)

docs/design/index.md

@@ -68,6 +68,7 @@ OpenFlare 适合需要统一管理多台 OpenResty 代理节点的团队，具
 | ---------------------- | ---------------------------------------------------- |
 | `openflare-server`     | Gin + GORM + SQLite/PostgreSQL 单体控制面            |
 | `openflare-server/web` | Next.js 15 App Router 管理端前端，由 Go Server 托管  |
+| `pkg`                  | 跨组件复用的协议类型与通用工具包                     |
 | `openflare-agent`      | Go 单体 Agent，运行在节点侧                          |
 | `openflare-relay`      | Tunnel 中继代理，运行在公网边缘管理 frps 进程        |
 | `openflared`           | Tunnel 客户端，运行在内网服务器侧管理 frpc 进程      |
@@ -77,21 +78,25 @@ OpenFlare 适合需要统一管理多台 OpenResty 代理节点的团队，具
 
 ### 1. Server 分层 (`openflare-server/`)
 
-| 目录          | 职责                                             |
-| ------------- | ------------------------------------------------ |
-| `controller/`  | 参数解析、调用 service、返回响应                                 |
-| `service/`     | 业务逻辑、校验、事务编排、配置渲染                               |
-| `model/`       | 纯净实体模型类定义、旧迁移框架兼容与上下文注入                   |
-| `model/goose/` | goose 迁移提供者、桥接逻辑、注册入口与具体迁移文件               |
-| `router/`      | 路由注册                                                         |
-| `middleware/`  | 认证、鉴权、限流、CORS、Turnstile 验证等横切逻辑                 |
-| `common/`      | 配置、全局状态与初始化入口                                       |
-| `utils/`       | 纯工具函数与通用 helper                                          |
-| `job/`         | 定时任务（各业务定时逻辑在独立文件中定义，cron.go 仅用于初始化调度） |
-| `upload/`      | 运行时本地临时文件上传目录（在 .gitignore 中忽略）               |
-| `logs/`        | 运行时本地日志输出目录（在 .gitignore 中忽略）                   |
-| `docs/`        | API 文档（Swagger）                                              |
-| `data/`        | 静态数据（如 GeoIP 数据库）                                      |
+| 目录                    | 职责                                             |
+| ----------------------- | ------------------------------------------------ |
+| `cmd/server/`           | Server 命令行启动入口及主函数                    |
+| `internal/controller/`  | 参数解析、调用 service、返回响应                 |
+| `internal/service/`     | 业务逻辑、校验、事务编排、配置渲染               |
+| `internal/model/`       | 纯净实体模型类定义、旧迁移框架兼容与上下文注入   |
+| `internal/model/goose/` | goose 迁移提供者、桥接逻辑、注册入口与具体迁移文件 |
+| `internal/router/`      | 路由注册                                         |
+| `internal/middleware/`  | 认证、鉴权、限流、CORS、Turnstile 验证等横切逻辑 |
+| `internal/common/`      | 配置、全局状态与初始化入口                       |
+| `internal/job/`         | 定时任务（各业务定时逻辑在独立文件中定义，cron.go 仅用于初始化调度） |
+| `internal/utils/`       | 仅 Server 内部使用的基础能力包，如 ACME、限流、验证码、邮件、安全校验等 |
+| `pkg/protocol/`         | Server、Relay、OpenFlared 之间共享的 HTTP/WS 协议结构 |
+| `pkg/utils/`            | 跨组件可复用的纯工具函数                         |
+| `pkg/geoip`、`pkg/render`、`pkg/wsclient` | 被多个组件复用的 GeoIP、OpenResty 配置渲染与 WebSocket 客户端能力 |
+| `upload/`               | 运行时本地临时文件上传目录（在 .gitignore 中忽略） |
+| `logs/`                 | 运行时本地日志输出目录（在 .gitignore 中忽略）   |
+| `docs/`                 | API 文档（Swagger）                              |
+| `data/`                 | 静态数据（如 GeoIP 数据库）                      |
 
 ### 2. Agent 模块 (`openflare-agent/`)