ADR-001：管理后台采用 Refine

Date

2026-10-29

Status

Accepted。依据用户对整稿评审包的明确确认，见批准记录（本地资料，未发布）。

Context

web 已限定 Next.js App Router，core 独占认证、授权与业务规则；当前需要资源型管理页面，优先使用成熟框架。Refine、React-admin、Ant Design Pro 的比较见选型。

Decision

采用 Refine CORE 5.x、官方 Next.js 路由适配、官方 Ant Design UI 适配与 Ant Design 5.x。复用资源界面、表格、表单和导航；provider 只适配 core 契约，web 不引入第二套身份服务或权限引擎。

已验证的实验组合为 core 5.0.12、路由适配 7.0.5、UI 适配 6.0.3、Ant Design 5.29.3、Next.js 16.4.3、React 19.3.1。它是实验快照，正式构建配置建立后才是项目精确依赖版本的权威，主分支版本不得代替发布版本。

Consequences

需要编写契约适配、资源页面装配及 core 业务规则；不能称为零开发账户系统。真实服务端权限、会话、注册、缓存隔离和部署仍需实现与测试。实际分发依赖的许可信息按锁文件和镜像核实，见兼容报告（本地资料，未发布）。

Reverts

撤销或更换框架须新增 ADR，并按宪法 §7 同步技术基线与相关规范，不回改本记录。