架构决策记录 / ADR
重大技术决策的留痕。每篇一页：状态、背景、决策、后果。 决策可以被推翻，但必须新增一篇 ADR 说明推翻理由，禁止原地修改历史记录。
| 编号 | 决策 | 状态 |
|---|---|---|
| 0001 | 设计器画布迁移至 ReactFlow | 已接受 |
| 0002 | 后端升级路径：先 Boot 2.7，后 3.x 独立里程碑 | 已接受 |
| 0003 | 文档发布体系选型 Docusaurus | 已接受 |
| 0004 | 维持 MIT 许可证 | 已接受 |
| 0005 | UI 架构：antd 守 CRUD，设计器域自研 | 已接受 |
| 0006 | 多库逆向 Dialect SPI（P0 四库 + Generic 兜底） | 已接受 |
| 0007 | 项目只读分享链接 | 已接受 |
| 0008 | 数据源与 projectJSON 隔离（不落 profile.dbs） | 已接受 |
| 0009 | 协作 Presence：后端 SocketIO + 短票 | 已接受 |
| 0010 | 暗色模式延期（不阻塞 P2） | 已接受 |
| 0011 | 复合 FK 暂不改为 fields[]（允许约束元数据加法） | 已接受 |
| 0012 | 升级为「AI 时代的数据结构平台」（Git+Figma+agent 事实源） | 已接受 · B |
| 0013 | 公开 API / MCP（鉴权·限流·scope） | 🚧 进行中（切片 1–5 + write REST/MCP + Redis + OAuth A+B + client/PAT 管理 UI ✅；余同意页） |
| 0014 | @ant-design/pro-components Strangler 摘除（依赖已移除） | ✅ 已落地 · B |
| 0015 | Boot 3 提高 max-http-request-header-size（JWT 头溢出→HTML 400） | 已接受 |
| 0016 | 体验优先：「敢分享的美图」主线（ICP 混合） | 已接受 |
| 0017 | 多关系图 + 实体编辑器（含图内分组 Frame） | 已接受 · 分阶段 |
| 0018 | 托管拓扑：GitHub + Cloudflare 免费档，不买生产 VPS | 已接受 |
| 0019 | 官方 Demo 运行时：Railway-only（真 MySQL 8）；拒三厂商；Zeabur 为 CN 备选 | 已接受 |
| 0020 | 单一业务库 erd（取消 martin/erd 双库）；init schema-only；种子走 Flyway | 已接受 |
| 0021 | 第三方登录 IdP 联邦（GitHub + Google OIDC + 微信开放平台扫码） | ✅ 已接受 · MVP |
| 0022 | 双层一致性（工作区↔版本↔实库）；禁止自动双向同步 | ✅ 已接受 |
| 0023 | i18n 奠基：默认 zh-CN；英文优先 ≠ 切默认；B 层后一个切片 | 已接受 |
| 0024 | 数据源凭证落库加密（AES-256-GCM，ERD_DB_CONFIG_SECRET） | 已接受 |
| 0025 | OG / 社交展开卡片 | 已接受 |
| 0026 | 精密工具站视觉语言（营销深色 + 工作台浅色精密化；≠ 全局暗色） | 已接受 |
| 0027 | 产品 Chrome IA（全站 Theme + 状态仪器盘 + 单一项目浏览 + 表设计层级） | 已接受 |
| 0028 | 官 方模板广场（Open VSX；浏览/安装/评分/发布审核；MCP 四工具） | ✅ 已接受 · MVP |
| 0029 | 设计器只读查询（探库）设计简报：改名为「表数据预览」+ 驱动管理（核心层 + 部署期扩展包，不阻塞建模者） | 提议中 · 设计简报 |
| 0030 | DDL 模板引擎（Freemarker 终态；BE 权威；Pebble+Translator 过渡；拒 Handlebars 终态） | 已接受 |
| 0031 | DDL 生成 API 与版本 API 分域（ProjectDdlController / /projectDdl/*；拒并入 Connector） | ✅ 已实施 |
| 0032 | 字段库 data_dict（平台/团队/个人；copy-on-apply；含库管理 UI） | ✅ 已接受 · MVP |
| 0033 | 应用主体批量 i18n 工程约定（模块内 locales/、getIntl()、硬编码中文只减不增门禁） | 已接受 |
| 0034 | locale 路由只做营销页 /en/*，应用内页不做 | 已接受 |
| 0035 | 发布适配器：Markdown 一次填入 vs 原生编辑器逐块（按编辑器能力选，共享 block IR） | 已接受 |