xiaoshu-app/docs/migration/admin-migration-status.md

Angular 管理后台与云函数迁移状态

已确认的迁移基线

• 旧 Web 交付物是 ASP.NET Core 发布包，没有 .sln、.csproj 与原始 Razor 管理页面源码。
• ZoomLaCMS.dll 可恢复 79 个后台控制器、至少 1,042 个公开动作；详细清单见 legacy-admin-inventory.generated.md。
• 线上 Parse 应用为 7pIbDBJmKx_main，当前可见 109 个 Schema，其中 96 个为 SQL Server 规范化迁移目标类。
• 核心数据已存在：CommonModel 92,435、VocabularyWord 89,620、NodeAuth 5,935、PracticeRecord 816、CourseAppointment 345、DailyStudyRecord 108、LessonRecord 82。
• 迁移开始前 Function 表为空；本阶段已部署 8 个云函数。

本阶段已实现

• Angular 18 独立管理端路由 /admin，包含独立登录、后台布局、概览、动态 Schema 表格、动态编辑表单、分页、搜索、软删除和迁移状态页。
• Parse 登录只在浏览器保存当前 sessionToken；masterKey 只在部署进程中使用。
• 云函数网关强制校验管理员身份、company 帐套、类白名单、字段白名单和敏感字段过滤。
• _Session 不开放，Function 源码不开放通用查询或编辑；用户密码只允许专用重置操作。
• 8 个线上函数均验证未认证请求返回 401；临时帐套管理员完成真实只读冒烟测试后已删除。

SQL 视图 / 函数替代状态

旧对象	云函数替代	状态	说明
ZL_StripeHtmlTag、ZL_StripeTrimstr	cms.content-normalizer	已实现	保守转换为纯文本，覆盖脚本、样式、实体和空白
ZL_EX_UserView	cms.users.extended	已实现	过滤密码、哈希、会话、Token 与 Secret
ZL_Exam_ClassView	cms.exams.classes	已实现基础投影	当前目标类缺少可证明的学校/年级 Pointer 时不伪造关联
ZL_Guest_BarView	cms.guest.bar	已实现基础投影	支持帐套与分页
ZL_SearchView	cms.search	已实现	搜索 CommonModel 并清理输出 HTML
ZL_User_PlatView	cms.users.platform	已实现	使用合并进 _User 的 legacy 平台资料
ZL_User_WXView	cms.users.wechat	已实现	使用合并进 _User 的微信资料并过滤密钥
ZL_CartProView	—	数据阻塞	目标 Schema 无购物车类，且迁移登记没有可用行
ZL_Order_PayedView	—	数据阻塞	目标 Schema 无订单/支付明细类
ZL_Order_ProSaleView	—	数据阻塞	目标 Schema 无订单商品明细类
ZL_Order_ShareView	—	数据阻塞	目标 Schema 无订单分享关系类
ZL_Plat_BlogView	—	数据阻塞	目标 Schema 无博客正文/回复类

仍需逐页专用迁移

动态 Schema CRUD 覆盖的是规范化业务数据管理能力，不代表旧后台 1,042 个动作已逐页复刻。考试组卷、微信配置、订单支付、模板编辑、数据库备份、站点集群、PowerShell、文件管理等必须逐项判断：

1. 有目标业务类且仍属当前产品范围：新增专用 Angular 页面和专用云函数。
2. 需要第三方密钥或基础设施权限：取得新系统凭据后再实现，前端不得存储密钥。
3. 依赖未迁移表、IIS、Windows 文件系统或旧 Zoomla 运行时：列入最终无法迁移清单，不以空成功响应代替。

管理员启用前置条件

线上 435 个 _User 在核验时没有任何 isAdmin=true、role=admin 或 adminRoleKey 管理员。系统因此默认不可登录管理端。上线前必须由持有 Parse masterKey 的部署人员为明确指定的现有用户设置：

• isAdmin: true
• roles: ["admin"]
• company: Pointer<Company>

跨帐套管理员才可设置 adminRoleKey: "super-admin"；不允许从浏览器执行管理员提权。