架构决策记录(ADR)
格式与规则见 设计文档 06 §6。编号只增不改;被取代的记录保留并标注。
| 编号 | 标题 | 状态 |
|---|---|---|
| 0001 | 前后端分离,Go 启动器一键运行 | 已接受 |
| 0002 | Go 模块化单体:chi + Huma,不用 Kratos | 已接受 |
| 0003 | ent 建模,Atlas 生成迁移,goose 执行 | 已接受 |
| 0004 | Next.js 渲染策略:公开页 SSR,不依赖 ISR,不用 Module Federation | 已接受 |
| 0005 | 插件标准:TypeScript + JS 沙箱(QuickJS-NG/WASM) | 已接受 |
| 0006 | 热加载模型:配置版本号 + 原子替换 + SSE | 已接受 |
| 0007 | 插件存储不开放宿主原始 SQL(已被 0049 部分更新:Tier 2 原生插件支持隔离 SQL 库) | 已接受 |
| 0008 | 项目命名:SkinLoom · 云织 | 已接受 |
| 0009 | 发行包由脚本构建,前端依赖扁平化 | 已接受 |
| 0010 | 可信代理、路径规范化与快速关闭 | 已接受 |
| 0011 | 包管理器 bun(回退 pnpm / npm),Node.js 24 | 已接受 |
| 0012 | 账号、会话与首次安装 | 已接受 |
| 0013 | 默认端口、部署清单与发布渠道 | 已接受 |
| 0014 | 注册与验证码 | 已接受 |
| 0015 | 后台任务队列与邮件 | 已接受 |
| 0016 | 个人资料、设备管理、注销与后台用户管理 | 已接受 |
| 0017 | 材质、文件存储与积分流水 | 已接受 |
| 0018 | 角色、UUID 与游戏皮肤接口 | 已接受 |
| 0019 | 收藏、材质编辑与删除、签到与用户中心 | 已接受 |
| 0020 | 举报、后台概览与后台角色、衣柜管理 | 已接受 |
| 0021 | 渲染器、站内通知与 S3 兼容存储 | 已接受 |
| 0022 | Yggdrasil 外置登录(authlib-injector) | 已接受 |
| 0023 | OAuth 2.0 提供方、个人访问令牌与 Blessing Skin 兼容资源 API | 已接受 |
| 0024 | 兼容 Blessing Skin 的管理类资源 API | 已接受 |
| 0025 | 社交登录(GitHub、Microsoft、OpenID Connect) | 已接受 |
| 0026 | 事务的加锁顺序(防死锁) | 已接受 |
| 0027 | 事务里的判断放在加锁之后,加锁层级扩展到角色与删号 | 已接受 |
| 0028 | 领域事件经任务队列投递,审计记录与变更同事务 | 已接受 |
| 0029 | M4 的拆分;设置中心:声明式校验与只写的密钥 | 已接受 |
| 0030 | 外观:主题切换、区块目录与自定义 CSS | 已接受 |
| 0031 | 翻译覆盖放在设置里;系统状态页 | 已接受 |
| 0032 | CDN 刷新跟随领域事件;backup / restore 命令 | 已接受 |
| 0033 | 系统服务命令、Helm Chart 与部署冒烟测试 | 已接受 |
| 0034 | M4 全量审查的修正:恢复先检查后写入、设置保存串行化、密钥跟随去处 | 已接受 |
| 0035 | M5 的拆分;BS 导入器(核心数据) | 已接受 |
| 0036 | BS 导入器:站点设置、翻译、OAuth 应用与签名密钥 | 已接受 |
| 0037 | 契约测试:黄金文件、authlib-injector 端到端、渲染快照与站点对比 | 已接受 |
| 0038 | 压测:k6 场景、百万材质的种子数据与压测发现的修正 | 已接受 |
| 0039 | 安全自查:内容安全策略与自定义 JavaScript,以及 ADR 0034 的遗留问题 | 已接受 |
| 0040 | 1.0 收尾:目录分层(modules / platform)、统一的事务工具、按读者组织的文档 | 已接受 |
| 0041 | 终端日志:给人看的格式与 NOTICE 级别 | 已接受 |
| 0042 | 前端设计系统与组件库:shadcn/ui(Base UI)、lucide、TanStack Query、OFL 字体 | 已接受 |
| 0043 | 本地主题目录与主题清单扩展 | 已接受(P4 实现) |
| 0044 | 交互式安装向导与 Pre-Core 启动模式 | 已接受 |
| 0045 | 插件存储预置槽位与 jsrt 沙箱实例池设计 | 已接受 |
| 0046 | 插件全量宿主扩展点、单源类型生成与 SDK/CLI 工具链 | 已接受 |
| 0047 | 前端插件运行时、20 处插槽挂载与主题 Level ⑤ 组件覆盖 | 已接受 |
| 0048 | .slp 扩展包签名校验、热升级与多副本聚类同步 | 已接受 |
| 0049 | 双层插件架构(QuickJS 沙箱 + Native Go 独立子进程、双向 gRPC、流式代理与隔离 SQL 数据库) | 已接受 |
| 0050 | 基于 GitOps 的静态签名插件与主题市场、多源容灾、五维兼容过滤与多架构 .slp 分发 | 已接受 |