mirror of https://gitee.com/zoujingli/ThinkAdmin.git synced 2026-06-06 20:18:10 +08:00

Anyon 6f4056f64d docs(architecture): 完善 v8 架构与迁移说明

补充 v8 重构后的架构文档、组件说明和迁移记录，方便后续维护者理解插件边界。

主要内容：

- 更新根 README，说明 v8 插件分层、系统模块、交付命令和验证流程。

- 新增组件明细、插件边界、路由分发、软删除和稳定性文档。

- 记录 Storage 合并到 System、旧 View 移除和 Helper 并入 System 的决策。

- 补充文档注释报告和后续重构计划，便于持续演进。

2026-05-08 15:31:22 +08:00

2.1 KiB

Raw Blame History

Stability Status

当前结论

截至当前代码状态，系统整体稳定性判断为：

架构稳定性：中高
核心认证链路：中高
运行时回归保障：中高

这表示项目已经适合继续作为当前主线架构推进，关键链路已经具备稳定的自动化回归保护。

已稳定的部分

1. 认证主线已收敛

后台与业务账号都统一到显式 Token
请求级令牌识别已收敛到统一入口
Authorization 与 Cookie 的优先级已经明确
旧 api-token 已从项目实现层移除

2. 登录态承载已切换

标准 Session 不再承载后台和 API 登录态
Token Session 已切到 sid + CacheSession
注销、续期、过期判断已经围绕 sid 工作

3. 插件边界更清晰

ThinkLibrary 负责运行时、认证协议、执行协议
System、Account、Wuma 的认证场景已能区分
开发型命令已从 ThinkLibrary 迁出到 Helper

当前主要风险

1. 设备认证仍是独立分支

wuma 仍使用独立设备 token
它没有复用通用账号 JWT 和 Token Session
这不是错误，但会增加长期维护成本

如果未来设备域扩张，这条分支会成为额外复杂度来源。

跨域场景仍依赖 setcookie、CORS、credentials 配置
如果前后端部署策略变化，最先出问题的通常是 Cookie 回退链路

因此默认仍建议优先走 Authorization。

当前建议

优先级 P1

继续补齐剩余控制器和事件链的 SQLite 集成回归
把“认证成功 / 失效 / 续期 / Cookie 回退”继续保持在固定回归脚本内

优先级 P2

继续统一文档入口，避免 README 各写各的
继续收紧插件目录和描述边界，避免旧命名回流

优先级 P3

评估 wuma 是否继续保留独立设备认证
如果设备端会长期存在，再考虑抽成标准设备认证层

当前可接受判断

如果以“当前主线开发是否可继续”为标准，答案是可以。

2.1 KiB Raw Blame History