update wiki

Home.md

@@ -1,6 +1,6 @@
 # 明序校园综合服务平台说明书
 
-本 Wiki 是“明序校园综合服务平台”的使用、部署和开发说明。平台面向普通高校，覆盖基础数据、教学运行、学生服务、成绩考试、学籍毕业、体育健康、校园事务与运维审计等业务；后端为 ASP.NET Core 10 / EF Core 10，前端为 Vue 3 / TypeScript / Element Plus。
+本 Wiki 是“明序校园综合服务平台”的使用、部署和开发说明。平台面向普通高校，覆盖基础数据、教学运行、学生服务、成绩考试、学籍毕业、体育健康、校园事务与运维审计等业务；后端为 ASP.NET Core 10 / EF Core 10，正式发布前端为 Vue 3 / TypeScript / Element Plus。仓库中的 React / Ant Design 前端正在并行迁移和联调，完成发布切换前不替代现有前端。
 
 > 学校名称、平台名称与定位语统一维护在 `src/Jiaowu.Api/appsettings.json` 的 `Branding` 节；面向其他学校部署时无需修改业务代码。
 
@@ -25,10 +25,10 @@
 3. [[教学运行与排课]]：基础数据、课程、培养方案、教学任务、校历、排课课表和实验教学。
 4. [[选课与教学服务]]：选课批次、候补递补、调停课、教室预约与考勤。
 5. [[教师工作台]]：授课申报、课表、名单、点名、成绩和评价。
-6. [[学生服务指南]]：选课、课表、成绩、学业预警、规划、申请、证明和移动端。
+6. [[学生服务指南]]：选课、课表、成绩、体质健康、学业预警、规划、申请、证明和移动端。
 7. [[成绩考试与统计]]：成绩全流程、实验成绩、其他考试、考试安排和分析报表。
 8. [[学籍毕业与学位]]：异动、预警、毕业审核、学位授予和离校。
-9. [[系统管理与运维]]：账号权限、通知、教室报修、审计、备份、性能、App 更新与 Swagger。
+9. [[系统管理与运维]]：账号权限、插件中心、通知、教室报修、审计、备份、性能、App 更新与 Swagger。
 10. [[部署指南]]：本地运行、生产配置、MySQL、Docker、systemd 与升级。
 11. [[开发指南与架构]]：项目结构、接口约定、构建测试和扩展原则。
 

学生服务指南.md

@@ -30,6 +30,12 @@
 
 “其他考试成绩”用于查看学校录入的独立外部考试成绩及历史。课程成绩更正、免修、缓考、课程替代等事项通过“审批中心”按业务规则申请和跟踪，不能直接修改成绩记录。
 
+## 体质健康
+
+“我的体测”只展示已经发布且属于本人的体质健康记录。学生可按学年查看身高、体重、肺活量、50 米跑、坐位体前屈、立定跳远、力量和耐力等单项成绩，以及标准分、附加分、综合得分和等级；缺测、缓测、免测等特殊状态会显示学校登记的原因。
+
+体测结果由管理人员依据批次采用的标准版本统一计分和发布，学生不能在页面自行修改。管理人员更正记录后，批次会回到草稿状态，学生应以重新发布后的最新结果为准。对原始测量值、特殊情况或身份归属有异议时，联系体育管理部门复核，不要仅以页面截图作为更正依据。
+
 ## 考试、学籍与毕业
 
 - 在“考试安排”“补考安排”查看本人考试时间、地点、座位等正式安排，提前核对证件与考场规则。

开发指南与架构.md

@@ -6,12 +6,17 @@
 | --- | --- |
 | `src/Jiaowu.Api` | ASP.NET Core API、EF Core 实体、业务服务、迁移、鉴权和后台任务。 |
 | `web` | Vue 3、TypeScript、Vite、Element Plus 前端及 Capacitor 工程/脚本。 |
+| `web-react` | React、TypeScript、Vite、React Router、Ant Design 并行迁移工程；当前仅用于联调验收。 |
+| `src/Jiaowu.Plugin.Abstractions` | 插件 SDK 合同、清单和宿主扩展接口。 |
+| `samples/Jiaowu.SamplePlugin` | 可构建、打包和签名的示例插件。 |
 | `tests` | 单元与集成测试。 |
 | `deploy` | systemd、部署等运行环境资源。 |
 | `scripts` | 开发、发布和辅助脚本。 |
 | `versions.props` | 后端、前端和 Swagger 产品版本的集中来源。 |
 
-后端使用 ASP.NET Core 10、EF Core 10；前端使用 Vue 3、TypeScript、Vite 与 Element Plus。`web` 的构建产物进入 API 的静态资源目录，单服务模式由 API 同时提供 `/api` 和前端路由回退。
+后端使用 ASP.NET Core 10、EF Core 10；正式前端使用 Vue 3、TypeScript、Vite 与 Element Plus。`web` 的构建产物进入 API 的静态资源目录，单服务模式由 API 同时提供 `/api` 和前端路由回退。
+
+`web-react` 是并行迁移工程，可通过 `http://127.0.0.1:5174/next/` 联调，并复用现有 API 合同和会话兼容约定。迁移矩阵中处于 `verification` 的页面表示已实现、仍需正常/空数据/异常/无权限/移动端联调，不等于已成为生产默认前端；当前生产构建和 Capacitor 仍以 `web` 为准。
 
 ## 启动与验证
 
@@ -23,6 +28,14 @@ npm install
 npm run build
 ```
 
+需要验证 React 迁移工程时，在 `web-react` 目录独立执行：
+
+```powershell
+Set-Location web-react
+npm install
+npm run build
+```
+
 后端可使用 `dotnet build Jiaowu.slnx`、`dotnet test Jiaowu.slnx` 或针对具体项目的命令。修改包含 API、数据库或页面的完整功能时，至少验证编译、相关测试和实际 UI/API 链路；不要把“构建成功”误认为业务已验收。
 
 ## 接口与鉴权约定
@@ -47,6 +60,14 @@ npm run build
 
 Android 原生模板位于 `web/native/android`；运行 `npm run cap:sync` 后同步至被 Git 忽略的 `web/android`。仅修改前端资源时可按 OTA 流程发布；修改原生模板、插件、权限或版本时需要重新构建原生 App。
 
+## 插件开发与装载边界
+
+插件项目面向 `net10.0`，引用 `src/Jiaowu.Plugin.Abstractions`，入口实现 `IJiaowuPluginModule`。插件控制器统一使用 `/api/plugin-extensions/{pluginId}` 前缀，并自行声明 `[Authorize]`、角色和数据范围校验；插件启用状态只控制可用性，不能充当授权。
+
+插件包根目录包含 `plugin.json`，后端程序集放在 `backend/`。宿主支持插件服务、控制器、幂等数据库迁移、后台任务和事件处理器；迁移只能操作插件自有表，不能修改或删除 Identity、成绩、学籍等核心业务数据。上传的 ZIP 和 SIG 经签名、路径、大小、清单及 Host API 校验后先进入暂存区，激活或回滚请求在下次重启时生效。
+
+完整合同、发布者密钥配置和打包命令以 `docs/plugin-sdk.md` 为准。调试插件时应同时验证插件禁用、无权限、迁移失败、任务异常和版本回滚路径，不能只验证菜单出现。
+
 ## 配置、可观测性与版本
 
 不得把数据库密码、JWT、SSO 客户端密钥写入 `appsettings`、前端代码、测试快照或 Wiki 示例。使用 `.env.example` 作为公开配置模板。