# 仿飞书应用-23班6组

**Repository Path**: grade24-fullstack-class2/fang-feishu-app-class2-group6

## Basic Information

- **Project Name**: 仿飞书应用-23班6组
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 7
- **Created**: 2026-07-02
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 仿飞书应用-2班6组

## 当前交付状态（以此节为准）

**当前没有可部署、可分发或可视为最终交付的 release。** `release/` 中的 Windows、Android、小程序、服务端目录及其证据属于 2026-07-19 的历史 V0020 测试产物，已经被当前 V0021/V0022 源码和跨端修复取代。它们不得上传、同步到官网、部署到服务器或作为本次交付证据。

- 当前本地目标：完成 Android、Windows、PC Web、Mobile H5、微信小程序和后端的同一套 API 契约、全量回归及真实设备验收。
- 允许顺序：先跑不改写产物的源代码门禁；再构建仅用于验收的私有候选包；完成 Android USB、Windows 清洁安装、微信开发者工具/真机验收并记录；最后才生成正式 release 和服务器交付包。
- 禁止顺序：在上述步骤完成前，不得运行正式同步、官网分发、服务器迁移、Caddy 更新、服务重启或部署命令。
- 当前 API/网站地址仅作为现有历史测试环境，不证明当前本地源码已经上线。完整的历史清单和当前门禁见 [release/FINAL_DELIVERY_MANIFEST.md](release/FINAL_DELIVERY_MANIFEST.md)。

> 下方带日期的阶段记录均为历史开发证据，不能覆盖本节的当前交付状态。

## 2026-07-09 历史验收基线：后端可替换边界

当前项目已经推进到“可替换 Mock 后端基础”阶段：`backend/mock-api/runtime/backend-runtime.js` 统一创建 data source、session store、permission provider 和 repository registry，`backend/mock-api/runtime/data-sources/mock-json-data-source.js` 单独承接 Mock JSON data source adapter，`backend/mock-api/runtime/session-stores/session-store-adapter.js` 单独承接 Mock/Redis/JWT session provider adapter，`backend/mock-api/runtime/permission-providers/permission-provider-adapter.js` 单独承接静态角色矩阵和外部 RBAC provider adapter，`backend/mock-api/runtime/repositories/repository-registry-adapter.js` 单独承接默认 Mock repository registry、外部 registry provider 与未来 repository factory adapter，`server.js` 与各 controller/service 不再直接绑定一份不可替换的静态 Mock 数据。`GET /health` 会在统一 `{ code, message, data, traceId }` 响应内返回 `backendMode`、业务数据 driver、session driver、permission provider、repository registry/stores 和 schema 状态，便于后续替换 PostgreSQL、Redis session、真实 RBAC provider 或 .NET/Node repository。

当前仍然不是生产完成态：Mock JSON store 只证明后端分层、接口契约、权限语义、待办状态流和多端 API 调用链已经具备可继续替换的边界；它不等同真实 PostgreSQL/EF Core 迁移、生产 JWT/refresh token、SSO/MFA、完整 RBAC、WebSocket IM、对象存储、Android APK、Windows 安装包、微信开发者工具真机验收或生产级审计中心已经完成。

最新验收范围以运行命令为准：后端启动、`/health`、登录 token/session、未登录 `401`、无权限 `403`、统一待办列表/完成/退回、核心维护隔离，以及 PC Web、Mobile H5、Mobile App、小程序预览、PC Client 壳通过 API 获取工作台/待办/联系人/IM/企业/核心数据，均由 `test:mock-api`、`smoke:mock-api`、`smoke:frontend-api`、`smoke:core-sdk-e2e` 和 `check` 继续验证。新增 repository registry adapter 后，运行时可通过默认 Mock registry、注入式 registry provider 或 repository factory 生成每次请求的 repositories；新增 service dependency resolver 后，当前使用 repositories/stores 的业务 service 已统一优先消费注入式 repositories/services，再兼容旧 stores，最后才落回 Mock store factory；`check:architecture` 也会防止 runtime 和这些 service 重新退回内联仓库创建逻辑或恢复局部 `resolveDependency()` helper。
# 2026-07-09 PC Web / Mobile H5 浏览器级 API 验收

本轮补充真实浏览器级联调证据：复用默认 Mock API `http://127.0.0.1:5086`，启动 PC Web `http://127.0.0.1:5186` 与 Mobile H5 `http://127.0.0.1:5286` 后，在浏览器中实际提交登录表单并观察页面渲染。PC Web 员工端从 `#/login` 登录后进入 `#/employee`，页面展示后端返回的 `Contract Profile User`、`QR-LQ-2026`、联系人、IM 未读、账号安全中心等数据；PC Web 企业端使用隔离 origin `http://localhost:5186` 登录后进入 `#/enterprise`，页面展示企业工作台、员工数 `8`、后端待办 `5`、审批模板、工作台卡片和安全中心。

Mobile H5 员工端登录后显示 `sdkLoaded=true`、`sdkRequests=21`、`fallbackRequests=0`，页面展示移动工作台、后端待办、应用、二维码、假勤、通讯录、IM 会话和账号安全中心；Mobile H5 企业端使用 `http://localhost:5286` 隔离存储后登录，显示 `sdkLoaded=true`、`sdkRequests=11`、`fallbackRequests=0`，页面展示企业工作台、员工总数 `8`、后端待办 `7`、应用数量 `6`、工作台卡片 `6`、假勤规则和企业风险。H5 退出后尝试 `core@fang.cn` 登录仍停留在认证页，不出现员工/企业移动端壳，证明核心账号没有进入移动客户端。

该验收补强了“前端 UI 真实通过 API 渲染”的证据，但仍不等同自动化 Playwright 回归、Android 真机包、Windows 安装包、微信开发者工具真机调试、真实 PostgreSQL 部署或生产级 JWT/RBAC/SSO 完成。

本轮同时给 PC Web 请求层补充运行时诊断：`frontend/pc-web/core/api.js` 会维护 `window.__fangPcWebDiagnostics`，并同步 `document.documentElement.dataset.pcWebApiRequests`、`pcWebSdkRequests`、`pcWebFallbackRequests`、`pcWebDesktopBridgeRequests`、`pcWebFailedRequests`。诊断会记录最近 20 条后端路径和使用的适配器（shared SDK / fetch fallback / desktop bridge），后续浏览器验收可直接证明 PC Web 页面是否真实请求 `/api/v1`，而不是只看 DOM 文案。当前验证：`npm.cmd run test:pc-web-core` 166/166 通过。

# 2026-07-09 PC Client 桥接 API 扩展

本轮继续把 PC Client 壳从“只桥接登录、资料和待办”推进到更完整的后端 API 桥：`frontend/pc-client/bridge-api.js` 新增用户会话、二维码、安全中心、登录审计、应用中心、工作台卡片、联系人、联系人申请、企业通讯录、IM 会话/消息/成员/已读/发送、企业员工/风险/审批、核心租户/发布/策略/运维告警/工单等读取方法，并保留 `request(path, options)` 作为统一 `/api/v1` 请求入口。桌面桥新增 `executeAction(action, token, body)`，只执行后端返回的完整 action 契约，不在客户端根据资源 id 或状态推导路径；动态 IM 路径会做 path segment 编码，绝对 URL 仍会在桥层被拒绝。
该能力仍是 Electron 壳体 Mock API 桥，不等同 Windows `.exe` 安装包、真实系统通知、文件拖拽上传、设备合规、生产自动更新或离线缓存；它的价值是让 PC Client 渲染层也能统一通过后端能力获取工作台、联系人、IM、企业和核心维护数据，而不是在桌面壳里保留另一套静态业务模型。当前验证：`npm.cmd run test:pc-client` 18/18 通过，新增覆盖桌面桥读取工作台/通讯录/IM/企业/核心 API、通用后端 action 执行、动态路径编码和 preload 暴露方法。

# 2026-07-09 小程序认证入口 API 化

本轮继续把微信小程序从“只允许预设账号登录，注册/找回/邀请提示去 PC Web”的静态入口推进为后端认证 API 驱动：`frontend/mini-program/utils/core-sdk.js` 新增 `registerAccount()`、`resetPassword()`、`acceptInvite()`，分别调用 `POST /api/v1/auth/register`、`POST /api/v1/auth/password/reset`、`POST /api/v1/auth/invite/accept`；注册和邀请成功后复用同一 `hydrateSession()`，继续从后端拉取用户资料、二维码、账号安全中心、登录审计、工作台、统一待办、IM 和企业管理数据。`frontend/mini-program/app.js` 只作为薄 facade 暴露认证方法，`pages/login/login.js` / `login.wxml` 改为登录、注册、找回、邀请入企四个认证模式，页面不再把这些能力降级成“去 PC 操作”的提示。
该能力仍是 Mock API 预览，不等同生产级短信/邮件验证码、微信授权登录、OAuth/SSO、风控、人机校验、正式小程序审核发布或真机验收；它的价值是让小程序端也遵守“未登录只能进入认证页，认证和角色分流由后端返回”的前后端分离边界。当前验证：`npm.cmd run test:mini-program` 26/26 通过，新增覆盖小程序 SDK 注册/重置/邀请码入企请求体、小程序登录页四类认证模式，以及核心账号继续不能进入小程序客户端。

# 2026-07-09 IM Store 收口

本轮继续把 IM 会话、消息、群成员、已读、撤回、联系人接受后的直聊创建，以及统一待办里的群邀请接受/拒绝从 `im-service` / `contacts-service` / `todo-service` 私有逻辑推进到可替换 store 边界：新增 `backend/mock-api/stores/im-store.js`，统一负责 `chats` / `chatMessages` 集合初始化、会话可见性、消息列表读取并清零当前账号未读、发送文本/文件消息时生成消息 ID 和时间戳、维护 `lastMessage/updatedAt/unreadByAccount`、创建群聊默认字段和系统消息、群成员加入、直聊会话复用/创建、已读回执、本人消息撤回，以及群邀请接受/拒绝时更新 pending/accepted/rejected/member 列表和系统消息。`im-service` 现在主要保留同企业成员过滤、账号资料补全和响应 contract shape；`contacts-service` 接受联系人申请后的直聊创建也调用同一 `im-store`；`todo-service` 处理 `im_group_invite` 待办时不再直接维护会话源数组。
该能力仍是 Mock IM store，不等同生产级 WebSocket、长连接推送、离线消息投递、多端同步、消息 ACK、群主管理、群公告、群权限、消息审计、敏感词/风控或真实文件传输；它的价值是让会话和消息状态具备明确 repository 边界，后续迁移真实数据库、消息队列或 .NET repository 时，不需要把消息未读、撤回、群成员和群邀请状态流散落在多个 service 私有逻辑里。当前验证：局部 IM/联系人/待办联动状态 30/30，`npm.cmd run test:mock-api` 198/198，`npm.cmd run check`、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run smoke:mock-api` 和 `npm.cmd run smoke:core-sdk-e2e` 均通过。

# 2026-07-09 联系人 Store 收口

本轮继续把联系人列表、联系人申请、扫码申请、接受/拒绝申请和双向联系人关系从 `contacts-service` / `todo-service` 私有逻辑推进到可替换 store 边界：新增 `backend/mock-api/stores/contacts-store.js`，统一负责 `contacts` / `contactRequests` 集合初始化、联系人列表和申请列表按时间排序并返回副本、重复联系人判断、待处理申请复用、扫码申请默认字段生成、接受申请时写入 `ACCEPTED/handledAt` 并创建双向联系人关系、拒绝申请时写入 `REJECTED/handledAt/result`。`contacts-service` 现在主要保留账号资料补全、响应 contract shape、企业目录和接受后临时直聊创建；`todo-service` 处理联系人申请待办完成/退回时也回到同一 `contacts-store` 状态流，不再直接维护联系人申请源数组。
该能力仍是 Mock 联系人 store，不等同生产级通讯录权限、好友关系审计、反骚扰/风控、联系人分组、外部联系人管理、组织架构同步或完整 IM 会话 repository；它的价值是让联系人申请和联系人关系具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把扫码申请默认值、联系人双向关系和待办回写散落在 service 私有逻辑里。当前验证：局部联系人/待办联动状态 23/23，`npm.cmd run test:mock-api` 189/189，`npm.cmd run check`、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run smoke:mock-api` 和 `npm.cmd run smoke:core-sdk-e2e` 均通过；直聊会话和 IM 消息集合仍由后续 IM store 继续收口。

# 2026-07-09 核心维护 Store 收口

本轮继续把核心租户、发布任务、核心策略、运维告警、支持工单，以及统一待办里的核心运维告警回写从 `core-service` / `todo-service` 私有逻辑推进到可替换 store 边界：新增 `backend/mock-api/stores/core-store.js`，统一负责 `coreTenants` / `releases` / `corePolicies` / `coreOpsAlerts` / `supportTickets` 集合初始化、核心维护列表读取副本、创建发布任务时生成 `version/type/coverage/status` 后端默认值，以及核心运维告警完成时写入 `resolvedAt/resolvedBy`。`core-service` 现在主要保留响应 contract shape 和账号审计写入；`todo-service` 处理 `core_ops_alert` 待办时也回到同一 `core-store` 状态流，不再直接维护核心告警源数组。
该能力仍是 Mock 核心维护 store，不等同生产级租户管理、灰度发布平台、策略中心、运维告警中心、工单系统、任务队列、发布审计或真实核心运维权限系统；它的价值是让核心维护端事实具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把核心发布默认值、核心列表读取和核心告警回写散落在 service 私有逻辑里。当前验证：局部核心/待办联动状态 19/19，`npm.cmd run test:mock-api` 182/182，`npm.cmd run check`、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run smoke:mock-api` 和 `npm.cmd run smoke:core-sdk-e2e` 均通过。

# 2026-07-09 企业管理 Store 收口

本轮继续把企业员工列表、员工占位创建、企业风险列表，以及统一待办里的入职、离职和系统安全风险回写从 `enterprise-service` / `todo-service` 私有逻辑推进到可替换 store 边界：新增 `backend/mock-api/stores/enterprise-store.js`，统一负责 `enterpriseEmployees` / `enterpriseRisks` 集合初始化、企业显式归属过滤、缺失企业字段时按关联账号回退判断归属、创建员工时生成 `id/name/department/status/portal/enterprise` 后端默认值、入职完成/退回、离职确认/恢复和安全风险确认时间戳写入。`enterprise-service` 现在主要保留响应 contract shape，`todo-service` 处理企业入职/离职和安全风险待办时也回到同一 `enterprise-store` 状态流，不再直接维护企业员工或风险源数组。
该能力仍是 Mock 企业管理 store，不等同生产级组织架构、HR 入转调离流程、真实 RBAC、账号生命周期、资产交接、安全风控引擎或生产级审计；它的价值是让企业员工和企业风险这类后端事实具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把企业隔离、员工默认值、入职/离职状态流和风险处理散落在 service 私有逻辑里。当前验证：局部企业/待办联动状态 23/23，`npm.cmd run test:mock-api` 177/177，`npm.cmd run check`、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run smoke:mock-api` 和 `npm.cmd run smoke:core-sdk-e2e` 均通过。

# 2026-07-09 假勤 Store 收口

本轮继续把员工打卡状态、上下班状态流、企业假勤规则默认值和假勤待办联动从 `attendance-service` 私有逻辑推进到可替换 store 边界：新增 `backend/mock-api/stores/attendance-store.js`，统一负责 `attendanceByAccount` / `attendanceRules` 集合初始化、缺失员工打卡状态默认值、上班打卡写入 `checkedIn/checkInAt/checkOutAt`、下班打卡写入 `checkedOut/checkOutAt`、无上班记录时补齐 `checkInAt`，以及企业规则缺失时生成标准班次、机器人提醒、异常审批和机器人渠道配置。`attendance-service` 现在主要保留响应 contract shape 和账号审计写入，不再直接维护 `data.attendanceByAccount` / `data.attendanceRules` 的状态流；统一待办仍从 `todo-store` 聚合未下班打卡状态，完成假勤待办时通过 `attendance-service.checkOut()` 回到同一 store 状态流。
该能力仍是 Mock 假勤 store，不等同真实定位校验、Wi-Fi/蓝牙围栏、排班系统、补卡流程、异常审批引擎、假勤报表或生产级考勤合规；它的价值是让打卡事实和企业假勤规则具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把打卡状态流、规则默认值和待办回写散落在 service 私有逻辑里。当前验证：局部假勤/待办联动状态 20/20，`npm.cmd run test:mock-api` 170/170，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-09 审批 Store 收口

本轮继续把审批模板、审批实例列表、提交审批、企业审核和统一待办里的审批回写从 `approvals-service` / `todo-service` 私有逻辑推进到可替换 store 边界：新增 `backend/mock-api/stores/approvals-store.js`，统一负责 `approvals` / `approvalInstances` 集合初始化、员工与企业账号的模板可见范围、企业审批配置范围、审批实例按申请人/企业范围可见、按创建时间排序、提交审批时生成 `id/templateId/applicantAccount/title/status/amount/startAt/endAt/createdAt/reviewedAt/reviewerAccount/comment`，以及审核时写回 `APPROVED/REJECTED`、`reviewedAt/reviewerAccount/comment`。`approvals-service` 现在主要保留参数错误、HTTP 业务错误、响应 contract shape 和后端 action 描述；`todo-service` 处理审批待办完成/退回时也调用同一 `approvals-store.reviewInstance()`，不再单独手写审批实例状态流。
该能力仍是 Mock 审批 store，不等同真实 BPM 流程引擎、自定义表单、加签/转交/撤回、多级审批、审批权限策略或生产级审计；它的价值是让审批模板和审批实例状态具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把模板可见性、企业审核范围和待办回写散落在多个 service 私有逻辑里。当前验证：局部审批/待办联动状态 24/24，`npm.cmd run test:mock-api` 164/164，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-09 日程会议 Store 收口

本轮继续把日历事件列表、新建日程、会议预约、会议加入和会议同步日历状态从 `calendar-service` / `meetings-service` 直接读写 Mock 集合推进到可替换 store 边界：新增 `backend/mock-api/stores/calendar-store.js` 与 `backend/mock-api/stores/meetings-store.js`，统一负责 `calendarEvents` / `meetings` 集合初始化、按账号参与关系过滤可见日程和会议、按开始时间排序、创建日程时生成 `id/type/startAt/endAt/location/ownerAccount/participantAccounts/source/status`，创建会议时生成 `id/hostAccount/participantAccounts/durationMinutes/room/status/recordingEnabled/joinedAccounts` 并同步生成会议日历事件，加入会议时写回会议 `LIVE` 状态并同步会议日历事件状态。`calendar-service` 和 `meetings-service` 现在主要保留标题参数错误、HTTP 业务错误、响应 contract shape 和账号审计写入，不再直接维护 `data.calendarEvents` / `data.meetings` 的状态流。
该能力仍是 Mock 日程/会议 store，不等同真实重复日程、共享日历、提醒策略、会议室资源预订、音视频会议 SDK、录制文件、会议权限或生产级日历同步；它的价值是让日程和会议状态具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把参与人过滤、会议日历同步和加入状态回写散落在 service 私有逻辑里。当前验证：局部日程/会议状态 12/12，`npm.cmd run test:mock-api` 159/159，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-09 云文档 Store 收口

本轮继续把云文档列表、创建、正文保存、版本历史和评论从 `docs-service` 直接读写 Mock 集合推进到可替换 store 边界：新增 `backend/mock-api/stores/docs-store.js`，统一负责 `docs`、`docVersions`、`docComments` 集合初始化、按账号/企业/成员关系过滤可见文档、按更新时间排序、创建文档时生成 `id/ownerAccount/enterprise/space/status/version/updatedAt/memberAccounts/content` 和初始版本记录、正文保存时递增版本并写入版本历史、评论写入和评论排序。`docs-service` 现在主要保留标题/正文/评论参数错误、HTTP 业务错误、响应 contract shape、默认展示正文兜底和账号审计写入，不再直接维护 `data.docs` / `data.docVersions` / `data.docComments` 的状态流。

该能力仍是 Mock 云文档 store，不等同真实富文本编辑器、多人实时协作、冲突合并、权限继承、文档空间管理、评论线程或审计留痕；它的价值是让文档元数据、正文版本和评论状态具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把版本递增、评论写入和可见范围散落在 service 私有逻辑里。当前验证：局部云文档状态 8/8，`npm.cmd run test:mock-api` 151/151，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-09 云盘 Store 收口

本轮继续把云盘文件列表、上传默认值、访问校验、分享和下载元数据从 `drive-service` 直接读写 Mock 集合推进到可替换 store 边界：新增 `backend/mock-api/stores/drive-store.js`，统一负责 `driveFiles` 集合初始化、按账号/企业/共享关系过滤可见文件、按更新时间排序、上传时生成 `id/type/size/ownerAccount/enterprise/permission/sharedAccounts/updatedAt/previewText` 后端默认字段、分享时写入 `sharedAccounts/permission/updatedAt`，以及详情和下载前的访问校验。`drive-service` 现在主要保留文件名参数错误、分享目标账号同企业校验、HTTP 业务错误、响应 contract shape 和账号审计写入，不再直接维护 `data.driveFiles` 的可见性和状态流。

该能力仍是 Mock 云盘 store，不等同真实对象存储、二进制上传、下载签名、病毒扫描、文件版本、空间配额或企业级权限模型；它的价值是让云盘文件元数据、可见范围和分享状态具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把文件可见性、上传默认值和分享回写散落在 service 私有逻辑里。当前验证：局部云盘文件状态 7/7，`npm.cmd run test:mock-api` 145/145，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-09 通知 Store 收口

本轮继续把消息通知列表、摘要、发送和已读状态从 `notifications-service` 直接读写 Mock 集合推进到可替换 store 边界：新增 `backend/mock-api/stores/notifications-store.js`，统一负责 `notifications` 集合初始化、按收件账号过滤和时间排序、发送通知时的 `id/channel/category/status/createdAt/readAt/actionText` 后端默认值、单条已读状态写入、全部已读批量状态写入，以及摘要里的总数、未读数和渠道统计。`notifications-service` 现在主要保留同企业收件人校验、参数错误、响应 contract shape 和账号审计写入，不再直接维护 `data.notifications` 的列表、状态流和摘要统计。

该能力仍是 Mock 通知 store，不等同真实邮件/短信网关、移动推送、站内信投递服务、失败重试、投递回执或通知偏好中心；它的价值是让通知状态和统计口径具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把未读统计、已读回写和发送默认值散落在 service 私有逻辑里。当前验证：局部通知状态 8/8，`npm.cmd run test:mock-api` 140/140，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-09 开放平台 Store 收口

本轮继续把开放平台自建应用、Webhook 和投递日志从 `open-platform-service` 直接读写 Mock 集合推进到可替换 store 边界：新增 `backend/mock-api/stores/open-platform-store.js`，统一负责 `openPlatformApps`、`webhooks`、`webhookDeliveries` 集合初始化、企业范围过滤、自建应用密钥和默认启用状态生成、Webhook 默认投递状态、轮换密钥时间戳、测试投递记录创建，以及 Webhook 最后投递状态回写。`open-platform-service` 现在主要保留 OpenAPI 目录、参数校验、HTTP 业务错误、响应 contract shape 和操作日志写入，不再直接维护开放平台资源集合。

该能力仍是 Mock 开放平台 store，不等同生产级 OAuth/OpenAPI 网关、真实应用市场、Webhook 签名验签、投递重试队列、应用审核或多租户开发者平台；它的价值是让自建应用凭证、Webhook 配置和投递日志这类后端事实具备明确 repository 边界，后续迁移真实数据库和 .NET repository 时，不需要把密钥生成、投递状态回写和企业隔离散落在 service 私有逻辑里。当前验证：局部开放平台资源 10/10，`npm.cmd run test:mock-api` 134/134，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-09 应用中心 / 工作台 Store 收口

本轮继续把应用中心和工作台配置从 `apps-service` 直接读写 Mock 集合推进到可替换 store 边界：新增 `backend/mock-api/stores/apps-store.js`，统一负责 `apps` 与 `workbenchCards` 集合初始化、企业/员工账号可见范围过滤、员工端只看已上架应用、员工端只看已启用且应用已上架的工作台卡片、企业端状态更新时的后端时间戳写入，以及工作台卡片按 `sortOrder` 排序和应用状态补充。`apps-service` 现在主要保留参数校验、HTTP 业务错误、响应 contract shape 和操作日志写入，不再直接维护 `data.apps` / `data.workbenchCards` 的筛选与更新规则。

该能力仍是 Mock 应用配置 store，不等同真实应用市场、插件运行时、企业级应用分发、灰度发布或生产级多租户配置中心；它的价值是让应用目录和工作台卡片这类后端配置事实具备明确 repository 边界，后续替换真实数据库表或 .NET repository 时，不需要把员工端/企业端可见性规则散落在客户端或 service 私有逻辑里。当前验证：局部应用/工作台配置 8/8，`npm.cmd run test:mock-api` 127/127，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-09 管理后台配置 Store 收口

本轮继续把管理后台从 service 直接读写 Mock 集合推进到可替换 store 边界：新增 `backend/mock-api/stores/admin-store.js`，统一负责 `adminRoles` 和 `dataDictionaries` 集合初始化、角色列表读取、数据字典排序、重复值校验、字典项创建默认字段和排序号递增。`admin-service` 现在只负责当前企业管理员权限语义、参数错误、响应 shape 和操作日志，不再直接维护 `data.adminRoles` / `data.dataDictionaries` 的业务规则。

该能力仍是 Mock 管理配置 store，不等同生产 RBAC 权限表、数据字典管理后台、审批发布流程或多租户配置中心已经完成；它的价值是让角色/字典这类管理配置数据具备明确 repository 边界，后续可迁移到真实数据库表和 .NET repository。当前验证：局部管理后台配置 10/10，`npm.cmd run test:mock-api` 122/122，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-09 账号审计写入 Store 收口

本轮继续把后端账号审计事实收回到可替换 store 边界：`attendance-service`、`docs-service`、`drive-service`、`calendar-service`、`meetings-service`、`notifications-service` 和 `core-service` 原来各自手写的 `loginAudits.unshift(...).slice(0, 12)` 已统一改为调用 `stores/account-store.js#appendLoginAudit()`。打卡、云文档创建/保存/评论、云盘上传/分享、日历新建、会议预约/加入、通知发送和核心发布现在使用同一套 Mock 登录/操作审计字段：`id/loginIp/deviceName/loginResult/createdAt`。

这一步仍是 Mock 账号审计边界，不等同生产安全审计、设备指纹、登录地点识别或不可篡改审计中心；它的价值是让账号侧审计写入集中在 `account-store`，后续替换真实数据库账号表、登录审计表或安全事件表时，不需要逐个改协作业务 service。当前验证：局部审计链路 22/22，`npm.cmd run test:mock-api` 116/116，`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `node --test tests/e2e/contract.test.cjs` 均通过。

# 2026-07-08 Mock 数据 schema 元信息与迁移边界

本轮继续把 Mock 后端往“以后可替换真实数据库/真实仓储层”的方向推进：`backend/mock-api/stores/schema-registry.js` 新增非业务 metadata 字段 `__mockMeta`，记录当前 `schemaVersion=2026-07-08.mock-db.v1`、存储类型、初始化来源、创建/更新时间和迁移历史。`createMockDataStore()` 现在会在 seed 初始化、reset、文件持久化加载时统一套用 `initializeSchemaData()`；如果读取到旧版持久化 JSON 文件且没有 metadata，会自动写入 `legacy -> 2026-07-08.mock-db.v1` 迁移记录，并把补齐后的 schema 边界落回文件。

`GET /health` 的 `schema` 现在除了集合总数、记录数和集合状态，也返回 `metadata.status/current/initializedFrom/migrations`，运行级 smoke 可以确认 Mock 数据文件不仅可读写，也带有可检查的 schema 元信息。该能力仍然只证明 Mock JSON store 的边界、迁移记录和自检能力，不代表真实 PostgreSQL/EF Core 迁移、事务、生产级 JWT/RBAC/SSO 或生产部署已经完成。

# 2026-07-08 多端身份与安全默认值收口

本轮继续把“前端不得生成后端业务事实”落到多端 shape 层：`shared/core-sdk/src/shapes.js` 不再为缺失的姓名、职位、企业、部门、联系人来源、登录 IP、登录结果、角色文案、可信设备数、假勤班次/提醒/异常/机器人规则等字段生成默认业务值；缺失字段保留空值或 `null`，由 PC Web、Mobile H5 和微信小程序展示“等待后端同步”类提示。PC Web `auth` 归一化、`portal-shapers`、Mobile H5 fallback、小程序 SDK 同步收紧，避免某一端继续把缺失后端字段伪装成“未命名企业 / 企业员工 / SUCCESS / 127.0.0.1 / 0 台设备”。
企业端“一键新增员工”也从前端生成姓名和部门改为只调用 `POST /api/v1/enterprise/employees`，员工占位档案的姓名、部门、状态、端类型和企业归属继续由 `enterprise-service` 生成。当前验证：`node --test backend/mock-api/services/tests/enterprise-service.test.cjs frontend/pc-web/core/tests/portal-actions.test.js frontend/mobile-h5/tests/auth.test.cjs shared/core-sdk/tests/shapes.test.js frontend/mini-program/utils/tests/core-sdk.test.cjs` 68/68，`npm.cmd run test:pc-web-core` 163/163，`npm.cmd run test:mobile-h5` 15/15，`npm.cmd run test:mini-program` 18/18。

# 2026-07-08 账号安全会话中心后端闭环

本轮继续把账号安全中心从前端展示推进到后端 Mock API 业务能力：新增 `GET /api/v1/users/me/security/sessions` 查询当前账号的后端活跃会话，新增 `POST /api/v1/users/me/security/sessions/revoke-others` 撤销同账号其他端会话，路由分别使用 `user.self:read` 与 `user.self:write` 权限。会话列表只返回脱敏 `sessionId`、账号、角色、客户端类型、创建时间、过期时间、是否当前会话和状态，不把原始 Bearer token 暴露给客户端；撤销后只保留当前 token，并把账号安全中心的可信设备数更新为后端活跃会话数。

共享 SDK 新增 `user.getSecuritySessions(token)` 与 `user.revokeOtherSecuritySessions(token)`，`hydrate()` 会把 `securitySessions` 写入会话。PC Web 员工端设置页与企业端安全页已通过 `portal-loaders` 请求该接口，并只通过后端 POST 执行“撤销其他会话”；页面不再只展示本地静态安全信息。该能力仍是 Mock session 基线，不等同生产 JWT、刷新令牌、SSO、真实设备指纹、完整登录地点识别或生产级账号保护策略。

本轮继续把“账号保护”从展示开关推进为后端认证规则：`auth-service` 在开启 `accountProtection` 时记录连续错误密码次数，达到 3 次后写入 `security.failedLoginAttempts / lockedUntil / lastFailedLoginAt`，锁定期内即使密码正确也返回 HTTP `403`、业务码 `40303`；锁定过期后成功登录会由后端清零失败计数。该状态由 `account-store` 维护，文件型 Mock 模式会在失败响应中落盘，`smoke:mock-api` 已验证注册账号、连续失败、锁定、标准响应包络和重启后安全中心状态仍可读取。该能力仍是 Mock 风控基线，不等同生产设备指纹、短信/邮箱验证、MFA 挑战、风控模型或真实安全审计中心已完成。

当前验证：`npm.cmd run test:mock-api` 100/100，`npm.cmd run smoke:mock-api` 通过并输出 `openapiPaths=73`、`securitySessions=revoked 1`，`npm.cmd run smoke:core-sdk-e2e` 2/2，`node --test tests/e2e/contract.test.cjs` 通过，PC Web 账号安全会话相关单测 53/53 通过。

# 2026-07-08 OpenAPI 权限元数据补齐
本轮继续把路由层权限契约同步到 `/openapi.json`：`backend/mock-api/contracts/openapi-spec.js` 现在会从真实注册路由读取 `public` 与 `permission`，为公开接口写入 `security: []` 和 `x-public=true`，为受保护接口写入 `security: [{ bearerAuth: [] }]` 和对应 `x-permission`，同时在 `components.securitySchemes.bearerAuth` 声明 Mock Bearer 会话。新增 OpenAPI 测试逐条比对路由权限与文档权限，确保登录/注册/OAuth token 等公开接口不伪装成受保护接口，待办、用户中心、企业管理、核心维护等受保护接口都能在契约里看到后端 permission。当前验证：`npm.cmd run test:mock-api` 90/90、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e`、`npm.cmd run check` 均通过。

# 2026-07-08 路由层权限契约显式化
本轮继续把“权限和角色必须由后端控制”往路由注册层收紧：所有受保护的 Mock API 路由现在都在 `backend/mock-api/routes/*-routes.js` 显式声明 `permission`，`dispatchLayeredRoute()` 会在调用 controller 前先执行 route-level permission 校验；controller/service 原有的 `requirePermission()` 仍保留，形成路由入口和业务入口两层后端防线。公开接口如登录、注册、找回密码、邀请码入企和开放平台 OAuth token 交换继续标记为 `public` 且不声明 permission。`permission-middleware.test.cjs` 新增全量路由扫描，保证 87 条注册路由中每条受保护 API 都声明合法后端权限，并验证 `POST /api/v1/auth/logout` 这类会话写接口必须先通过路由层权限。当前验证：`npm.cmd run test:mock-api` 90/90、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e`、`npm.cmd run check` 均通过。

# 2026-07-08 OpenAPI 契约模块分层
本轮继续把 HTTP 入口里的接口契约下沉到 contracts 层：`backend/mock-api/server.js` 不再内联 OpenAPI 对象，而是通过 `backend/mock-api/contracts/openapi-spec.js` 输出 `openApiSpec`，入口只在 `/openapi.json` 时返回该契约。`backend/mock-api/contracts/tests/openapi-spec.test.cjs` 已覆盖 OpenAPI 元信息、登录/注册、用户中心、统一待办、通讯录、IM、假勤、工作台、企业管理、管理后台和核心维护等关键路径，以及待办完成/退回、管理后台状态更新、假勤打卡、核心发布等写入方法声明；本轮继续新增“注册路由 method/path 与 OpenAPI paths 全量一致”测试，防止后续新增 API 只改路由或只改文档导致契约漂移。`npm.cmd run smoke:mock-api` 现在也会真实请求 `/openapi.json`，验证该契约对外可访问并包含关键路径，本轮输出 `openapiPaths=70`。当前验证：`npm.cmd run test:mock-api` 90/90、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e`、`npm.cmd run check` 均通过。

# 2026-07-08 Mock API 入口瘦身与 seed 数据分层
本轮继续把后端入口从“大文件堆数据”往真实分层推进：`backend/mock-api/server.js` 不再内联 500 多行 Mock seed 和建模 helper，入口只保留 HTTP 启动、鉴权、路由分发、测试 reset 和持久化提交；基础账号、企业、IM、假勤、工作台、审批、核心维护等初始数据已抽到 `backend/mock-api/stores/seed-data.js`，作为 store 层的可替换 seed 模块。新增 `backend/mock-api/stores/tests/seed-data.test.cjs` 验证员工/企业/核心三类账号、假勤规则、核心策略和运维告警等后端基线数据可初始化 `createMockDataStore()`。当前验证：`npm.cmd run test:mock-api` 90/90、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e`、`node --test tests/e2e/contract.test.cjs`、`npm.cmd run check` 均通过。

# 2026-07-08 Mock API 可选文件持久化基准
本轮把 Mock API 从纯内存运行推进到可选文件持久化：`backend/mock-api/stores/mock-data-store.js` 支持通过 `FANG_MOCK_DATA_FILE` 从 JSON 文件恢复业务数据并在成功写请求后落盘，`backend/mock-api/stores/session-store.js` 支持通过 `FANG_MOCK_SESSION_FILE` 持久化 Bearer session。默认不设置环境变量时仍是内存模式，不污染单测，也不把当前阶段伪装成真实数据库；它只是为后续替换真实数据库、真实仓储层和生产级认证系统预留稳定边界。`backend/mock-api/server.js` 已在非 GET 成功请求后统一提交业务数据，注册账号、资料修改、待办处理、打卡、消息、企业管理等 Mock 写入可以在本地重启后保留。`npm.cmd run smoke:mock-api` 现在会临时启用数据文件和 session 文件，完成待办/管理后台写操作后重启 Mock API，并用原 token 验证状态仍可读取；当前验证：`npm.cmd run test:mock-api` 90/90、`npm.cmd run smoke:mock-api` 通过，smoke 输出包含 `persistence=verified after restart`。
# 2026-07-08 前端审批/应用状态展示去默认业务值
本轮继续清理前端展示层的本地业务推导：PC Web `portal-shapers.shapeApprovalRow()` 只在后端明确返回 `PUBLISHED/DRAFT` 时显示“已发布/草稿”，缺状态审批配置保留空值，不再把缺字段伪装成草稿；PC Web `appStatusLabel()` 也只把明确 `DRAFT` 显示为草稿，未知状态直接展示后端原值。Mobile App 员工页 `firstApprovalTemplate` 不再在没有已发布模板时退回选择第一条模板，缺状态或草稿模板不会触发“提交审批”轻操作，而是提示等待后端返回已发布模板。当前验证：`node --test frontend/pc-web/core/tests/shapes.test.js frontend/pc-web/core/tests/portal-shapers.test.js frontend/pc-web/core/tests/enterprise-pages.test.js` 27/27、`node --test frontend/mobile-app/utils/tests/pages.test.cjs` 7/7 通过。

# 2026-07-08 管理/通讯录/企业/会议契约继续去默认值
本轮继续把后端契约层的隐式业务默认值收回 service：Mock API `admin-contract.shapeAdminUser()` 不再把缺失 `status/portal/role` 补成在岗、员工端或员工角色，账号安全开关缺失时保留 `null`；`shapeAdminRole()` 不再补 `ENABLED`，`shapeDictionary()` 不再把缺失 `enabled` 补成 `false`，缺 `method` 的管理后台 action 会被丢弃。`contacts-contract.shapeDirectoryEntry()` 不再补 `portal=employee`；`enterprise-contract.shapeEnterpriseEmployee()` / `shapeEnterpriseApproval()` 不再补 `待激活/employee/DRAFT`；`meetings-contract.shapeActions()` 不再给半截 action 补 `POST`；`open-platform-contract.shapeOpenApi()` 不再把缺失目录方法补成 `GET`。创建字典、新增员工、创建会议、创建开放平台资源等默认值仍由后端 service 显式写入。当前验证：`npm.cmd run test:mock-api` 76/76、`npm.cmd --prefix shared/core-sdk test` 47/47、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `git diff --check` 均通过。

# 2026-07-08 通知缺状态后端契约去默认值
本轮继续收紧通知状态边界：Mock API `notifications-contract.shapeNotification()` 不再把缺失 `status` 补成 `UNREAD`，`notificationActions()` 也只会在后端明确返回 `UNREAD` 时生成 `mark-read` action；`notifications-service` 的摘要未读数和 `readAll()` 也只处理显式未读通知，缺状态旧数据保留为空状态、不会被统计为未读，也不会被“全部已读”改写。当前验证：`npm.cmd run test:mock-api` 63/63 通过。

# 2026-07-08 日历事件状态后端契约去默认值
本轮继续收紧日历事件状态边界：Mock API `calendar-contract.shapeCalendarEvent()` 不再把缺失 `status` 补成 `SCHEDULED`，缺状态日历事件保留为空值；`calendar-service.create()` 新建日程时仍由后端明确写入真实 `SCHEDULED`，会议预约同步日历也仍由后端写入状态。新增 `calendar-service` 单测覆盖缺状态旧事件不被 contract 伪造成已预约，以及新建日程默认状态由后端生成。当前验证：`npm.cmd run test:mock-api` 65/65 通过。

# 2026-07-08 云文档状态后端契约去默认值
本轮继续收紧云文档状态边界：Mock API `docs-contract.shapeDoc()` 不再把缺失 `status` 补成“协作中”，缺状态文档在列表和详情中都保留为空值；`docs-service.create()` 新建文档时仍由后端明确写入真实“协作中”，保存正文、评论和版本流转仍由后端维护。新增 `docs-service` 单测覆盖缺状态旧文档不被 contract 伪造成协作中，以及新建文档默认状态由后端生成。当前验证：`npm.cmd run test:mock-api` 67/67 通过。

# 2026-07-08 应用中心与工作台后端契约去默认值
本轮继续收紧应用中心/工作台状态边界：Mock API `apps-contract.shapeApp()` 不再把缺失 `status` 补成 `DRAFT`，缺状态应用不会自动获得 `publish` action；`shapeWorkbenchCard()` 不再把缺失 `appStatus/portal/enabled` 补成 `DRAFT/employee/false`，缺开关卡片不会自动获得启停 action。`shapeAction()` 也不再为缺 `method` 的不完整 action 补 `POST`，避免旧数据被伪造成可执行后端动作。共享 SDK 与 Mobile H5 fallback 同步移除工作台 `portal=employee` 默认值。当前验证：`npm.cmd run test:mock-api` 68/68、`npm.cmd --prefix shared/core-sdk test` 47/47、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `git diff --check` 均通过。

# 2026-07-08 会议状态与加入动作去后端契约默认值
本轮继续收紧会议状态和加入动作边界：Mock API `meetings-contract.shapeMeeting()` 不再把缺失 `status` 补成 `SCHEDULED`，缺状态会议保留为空值；`join` action 也不再仅凭会议 id 生成，必须基于后端明确的会议状态。`meetings` service 新建会议时仍负责写入真实 `SCHEDULED`，加入会议时写回 `LIVE` 并同步日历事件。当前验证：`npm.cmd run test:mock-api` 63/63、`npm.cmd --prefix shared/core-sdk test` 47/47 通过。

# 2026-07-08 审批状态后端契约去默认值
本轮继续补齐审批流程的后端契约边界：Mock API `approvals-contract.shapeApprovalTemplate()` 不再把缺失 `status` 补成 `PUBLISHED`，`shapeApprovalInstance()` 不再把缺失 `status` 补成 `PENDING`；新建审批实例时仍由 `approvals` service 明确生成真实 `PENDING`，审核流转由 service 写回 `APPROVED/REJECTED`。这样缺状态旧数据不会被 contract 伪造成已发布模板或待审批实例，也不会得到审核 action。当前验证：`npm.cmd run test:mock-api` 63/63、`npm.cmd --prefix shared/core-sdk test` 47/47 通过。

# 2026-07-08 联系人申请后端契约去默认状态
本轮补齐联系人申请的后端契约边界：Mock API `contacts-contract.shapeContactRequest()` 不再把缺失的 `status` 补成 `PENDING`，缺字段会原样保留为空值；新建扫码申请时仍由 `contacts` service 明确写入真实 `PENDING`。这样后端 contract 不会把旧数据或缺字段响应伪造成待处理申请，前端仍只展示后端状态和完整 `actions[]`。当前验证：`npm.cmd run test:mock-api` 62/62、`npm.cmd --prefix shared/core-sdk test` 47/47 通过。

# 2026-07-08 企业风险等级去前端默认值
本轮继续把企业风险等级收回后端：`shared/core-sdk.shapeEnterpriseRisk()`、Mock API `enterprise-contract` 和微信小程序适配层不再把缺失的 `level` 补成 `MEDIUM`；PC Web、Mobile H5 和 Mobile App 展示层遇到缺等级风险时显示等待后端风险等级同步，而不是伪装成中优先级或待处理。高风险待办仍由后端 `todo-store` 基于明确的 `level=HIGH` 派生，客户端只消费后端返回的风险事实和待办 action。当前验证：`npm.cmd --prefix shared/core-sdk test` 47/47、`npm.cmd run test:mock-api` 61/61、`npm.cmd run test:pc-web-core` 162/162、`npm.cmd run test:mini-program` 17/17、`npm.cmd run test:mobile-h5` 13/13、`npm.cmd run test:mobile-app` 35/35 通过。

# 2026-07-08 会议录制开关去前端默认值
本轮继续把会议配置事实收回后端：`shared/core-sdk.shapeMeeting()` 和 Mock API `meetings-contract` 不再把缺失的 `recordingEnabled` 补成 `false`，缺字段保留为 `null`；Mobile App 预约会议也不再在用户未明确选择录制时提交 `recordingEnabled=false`，由后端 service 负责创建默认值。会议加入按钮仍只消费后端返回的完整 `actions[]`。当前验证：`npm.cmd --prefix shared/core-sdk test` 47/47、`npm.cmd run test:mock-api` 60/60、`npm.cmd run test:mobile-app` 35/35 通过。

# 2026-07-08 管理后台权限声明去前端默认值
本轮继续收紧企业管理后台权限字段：`shared/core-sdk.shapeAdminUser()` 不再把后端缺失的 `canChangeStatus` 补成 `false`，而是保留为 `null`；后端明确返回 `true/false` 时才展示为明确权限事实。用户冻结/恢复按钮仍只根据后端完整 `actions[].code/method/apiPath/body` 渲染和提交，缺少 action 时不执行任何状态流。当前验证：`npm.cmd --prefix shared/core-sdk test` 47/47 通过。

# 2026-07-08 Mobile H5 待办来源兜底去前端默认值
本轮继续收紧 Mobile H5 离线 fallback：`frontend/mobile-h5/app.js#shapeTodoRow()` 不再在共享 SDK 未加载时把缺失的待办 `sourceType` 补成 `system`，也不再把缺失的 `priority` 补成 `NORMAL`；页面缺少来源时显示“等待后端来源同步”，缺少优先级时继续显示“等待后端优先级同步”。这样即使 H5 处在 fallback 模式，也不会把后端未返回的待办来源和优先级伪造成系统待办或普通优先级。当前验证：`npm.cmd run test:mobile-h5` 13/13 通过。

# 2026-07-08 账号安全与打卡布尔状态去前端默认值
本轮继续把账号安全开关和员工打卡状态从客户端默认值中收回：`shared/core-sdk.shapeSecurity()`、`shapeAttendance()`、`shapeAdminUser()` 不再在后端缺少 `accountProtection/deviceApproval/loginAlert/abnormalLoginGuard/mfaEnabled/checkedIn/checkedOut` 时补成 `false`，而是保留为 `null`。PC Web、Mobile H5、Mobile App 预览和微信小程序遇到缺字段时显示“等待后端状态同步 / 等待后端打卡状态同步”，只有后端明确返回 `true/false` 时才展示开启、关闭、已打卡或未打卡；设置表单和管理动作仍会把用户明确选择提交给后端。当前验证：`npm.cmd --prefix shared/core-sdk test` 47/47、`npm.cmd run test:pc-web-core` 162/162、`npm.cmd run test:mobile-h5` 13/13、`npm.cmd run test:mini-program` 17/17、`npm.cmd run test:mobile-app` 35/35、`npm.cmd run test:mock-api` 60/60、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 均通过。

# 2026-07-08 启停开关展示去前端默认值
本轮继续把后端配置开关从客户端默认值中收回：`shared/core-sdk.shapeAttendanceReminder()`、`shapeAttendanceException()`、`shapeWorkbenchCard()` 和 `shapeDictionary()` 不再在后端缺少 `enabled` 时默认成启用或停用，而是保留为 `null`；PC Web 企业假勤规则、工作台配置、企业后台数据字典以及 Mobile H5/微信小程序工作台适配层遇到缺开关字段时显示或保留“等待后端状态同步”。企业侧边栏统计也只把后端明确返回 `enabled=false` 的工作台卡片计入待发布/停用数量，不再把缺字段算作停用。当前验证：`npm.cmd --prefix shared/core-sdk test` 47/47、PC Web 企业页/企业后台/侧边栏相关测试 21/21、`npm.cmd run test:mobile-h5` 13/13、`npm.cmd run test:mini-program` 17/17 通过。

# 2026-07-08 协作流程状态展示去前端默认值
本轮继续把通知、云文档、日程会议、审批、应用中心、工作台卡片和假勤班次的业务状态收回后端：`shared/core-sdk.shapeNotification()`、`shapeDoc()`、`shapeCalendarEvent()`、`shapeMeeting()`、`shapeApprovalTemplate()`、`shapeApprovalInstance()`、`shapeApp()`、`shapeWorkbenchCard()` 和 `shapeAttendanceShift()` 不再在后端缺少状态字段时补成 `UNREAD/协作中/SCHEDULED/PUBLISHED/PENDING/DRAFT/ENABLED`。PC Web 员工协作页和企业管理页遇到缺状态时统一显示“等待后端状态同步”，不再把缺字段伪装成已读、协作中、待加入、待审批、草稿或启用。当前验证：`npm.cmd --prefix shared/core-sdk test` 47/47、`npm.cmd run test:pc-web-core` 162/162、`npm.cmd run test:mobile-h5` 13/13、`npm.cmd run test:mini-program` 17/17、`npm.cmd run test:mobile-app` 34/34 通过。

# 2026-07-08 联系人申请状态展示去前端默认值
本轮继续收紧联系人申请请求流：`shared/core-sdk.shapeContactRequest()` 不再在后端缺少 `status` 时补成 `PENDING`；PC Web、Mobile H5、Mobile App 预览和微信小程序工作台遇到缺状态联系人申请时显示等待后端状态同步，不再默认为“待处理”或空白。联系人申请的通过按钮仍只来自后端返回的完整 `actions[].code/method/apiPath/resultField/defaultComment`，前端不再根据 `direction/status` 推导操作。当前验证：`npm.cmd --prefix shared/core-sdk test` 46/46、`npm.cmd run test:pc-web-core` 162/162、`npm.cmd run test:mobile-h5` 13/13、`npm.cmd run test:mini-program` 17/17、`npm.cmd run test:mobile-app` 34/34 通过。

# 2026-07-08 统一待办状态展示去前端默认值
本轮继续把统一待办的业务状态收回后端：`shared/core-sdk.shapeTodo()` 不再在后端缺少 `sourceType/priority/status` 时补成 `system/NORMAL/PENDING`；PC Web 员工端与企业端、Mobile H5、Mobile App 预览和微信小程序适配层也不再把缺失待办状态显示成“待处理”或把缺失优先级显示成“普通/NORMAL”。缺字段时端侧只显示等待后端状态或优先级同步，待办按钮仍只来自后端返回的完整 `actions[]`。当前验证：`npm.cmd --prefix shared/core-sdk test` 46/46、`npm.cmd run test:pc-web-core` 162/162、`npm.cmd run test:mobile-h5` 13/13、`npm.cmd run test:mini-program` 17/17、`npm.cmd run test:mobile-app` 34/34 通过。

# 2026-07-08 管理后台与核心维护状态展示去前端默认值
本轮继续收紧管理后台和核心维护端的业务状态边界：`shared/core-sdk.shapeAdminUser()` 不再把缺失的 `status/portal` 补成 `在岗/employee`，`shapeAdminRole()` 不再把缺失的角色 `scope/status` 补成 `企业端/ENABLED`，`shapeTenant()`、`shapePolicy()`、`shapeOpsAlert()`、`shapeSupportTicket()` 也不再为缺失的租户、策略、告警或工单状态补默认业务值。PC Web 企业管理后台和核心维护页遇到缺失状态时统一显示“等待后端状态同步”，避免客户端把未返回字段伪造成启用、待激活或处理中。当前验证：`npm.cmd --prefix shared/core-sdk test` 46/46、`npm.cmd run test:pc-web-core` 162/162 通过。

# 2026-07-08 企业员工与核心发布状态展示去前端默认值
本轮继续收紧“后端拥有业务状态”的展示边界：`shared/core-sdk.shapeEnterpriseEmployee()` 不再把缺失的 `status/portal` 补成 `待激活/employee`，`shapeRelease()` 不再把缺失的发布 `status` 补成 `进行中`；PC Web 企业员工表、核心发布页、Mobile H5 企业员工 shape 和小程序企业员工 shape 均改为保留后端返回结果，缺字段时显示等待后端同步。创建员工和创建发布任务时的默认状态仍由 Mock API 后端生成，前端只展示后端实际返回。当前验证：`npm.cmd --prefix shared/core-sdk test` 46/46、PC Web 相关页面/shaper 测试 17/17、`npm.cmd run test:mobile-h5` 13/13、`npm.cmd run test:mini-program` 17/17 通过。

# 2026-07-08 开放平台状态展示去前端默认值
本轮继续把开放平台状态事实收回后端：`shared/core-sdk` 的 `shapeOpenPlatformApp()`、`shapeWebhook()` 和 `shapeWebhookDelivery()` 不再在后端缺少 `status/lastDeliveryStatus` 时补成 `ENABLED/PENDING`；PC Web 企业开放平台页也不再把缺状态资源显示成“停用”，而是显示“等待后端状态同步 / 等待后端投递状态同步”。这样创建默认值由后端生成，展示缺失字段也不会被前端伪造成业务状态。当前验证：`npm.cmd --prefix shared/core-sdk test` 46/46、`node --test frontend/pc-web/core/tests/enterprise-open-platform-pages.test.js frontend/pc-web/core/tests/portal-shapers.test.js` 8/8 通过。

# 2026-07-08 后端运行级基准复验
本轮对“能跑起来的后端基准”做了真实进程复验：`npm.cmd run smoke:mock-api` 会临时启动 Mock API 并验证 `/health`、未登录 `401/40100`、跨角色 `403/40300`、核心维护端隔离、企业管理后台和待办 action 完成/退回；本次输出 `corePolicies=8`、`coreOpsAlerts=6`、`adminUsers=5`、`operationLogs=5`、`todos=4`，并完成 `todo-risk-risk-1`、退回 `todo-approval-approval-inst-1`。`npm.cmd run smoke:core-sdk-e2e` 同步通过员工端“登录 -> hydrate -> 加好友 -> 同意 -> 发消息 -> 打卡 -> 通知 -> 退出”和企业端“登录 -> 拉企业数据 -> 退出”2 条端到端链路。

# 2026-07-08 管理后台用户状态 action 契约收紧
本轮继续把企业管理后台用户冻结/恢复从 SDK 直连写入口收回到后端契约：`shared/core-sdk` 已移除公开的 `admin.updateUserStatus(account, status, token)`，新增 `admin.executeAction(action, body, token)` / `admin.normalizeAdminUserAction()` 统一执行 `/admin/users` 返回的完整 `actions[].code/method/apiPath/body`。PC Web 企业管理后台原本已按后端 action 渲染按钮，现在 SDK 入口也不会再鼓励上层按账号和本地状态拼 `/admin/users/{account}/status`。当前验证：`npm --prefix shared/core-sdk test` 45/45 通过。

# 2026-07-08 应用中心 / 开放平台 action 契约收紧
本轮继续把共享 SDK 中应用中心、工作台和开放平台资源状态写入口收回到后端契约：`shared/core-sdk` 已移除公开的 `apps.updateAppStatus()`、`apps.updateCard()`、`workbench.updateCard()`、`openPlatform.rotateSecret()` 与 `openPlatform.sendWebhookTest()`，新增 `apps.executeAction()` / `openPlatform.executeAction()` 统一执行后端 `/apps`、`/workbench/cards`、`/open-platform/apps`、`/open-platform/webhooks` 返回的完整 `actions[].code/method/apiPath/body`。PC Web 原本已经按后端 action 渲染按钮，现在 SDK 入口也不会再鼓励上层按资源 id 或状态拼接应用上下架、工作台启停、轮换密钥或 Webhook 测试投递路径。当前验证：`npm --prefix shared/core-sdk test` 45/45 通过，`npm run check` 通过。

# 2026-07-08 通知汇总全读 action 契约收紧
本轮继续把通知“全部已读”从前端固定入口收回到后端契约：`GET /api/v1/notifications/summary` 在存在未读通知时返回 `actions[].code=read-all`、`method`、`apiPath`、`body`，PC Web 和 Mobile App 只在摘要里存在完整 `read-all` action 时渲染“全部已读”按钮，并通过 `notifications.executeAction()` 或后端 `apiPath/method/body` 提交；缺少该 action 时只显示等待/空态，不再由客户端自行拼 `/notifications/read-all`。当前验证：`npm run test:mobile-app` 34/34 通过，`npm --prefix shared/core-sdk test` 45/45 通过。

# 2026-07-08 认证后端基准测试补强
本轮把注册、登录、找回密码和登出纳入后端 service 单测：新增 `backend/mock-api/services/tests/auth-service.test.cjs`，覆盖公开注册员工/企业管理员、注册后由后端生成个人资料、二维码、账号安全中心、登录审计、会话 token 和员工档案占位，拒绝公开注册 `core` 账号、重复账号和缺字段注册，并验证登录失败、登录成功、密码重置与登出会话删除。`auth-service` 的注册标签拆分已支持逗号、中文逗号、分号和空白；`npm run test:mock-api` 当前 54/54 通过。

# 2026-07-08 统一待办后端来源同步
本轮继续把统一待办从“启动时一次性 Mock 种子”推进为“后端按业务源同步的请求/返回模型”。`backend/mock-api/stores/todo-store.js` 现在会在读取 `/api/v1/todos` 或处理待办前同步联系人申请、审批实例、假勤未下班状态、企业入职占位、企业离职交接、企业安全风险、IM 群邀请和核心运维告警等来源；新建联系人申请、提交审批或新增待激活员工后，再次读取待办会由后端生成对应 `sourceType` 待办。源状态已完成时，联系人申请、审批、假勤、企业入职/离职和 IM 群邀请待办会由后端同步为完成或退回，IM 群邀请完成/退回还会写回群邀请名单、成员列表和系统消息，避免前端保留过期流程状态。`npm run test:mock-api` 已扩展到 54/54，新增覆盖待办来源动态同步、源状态回写、企业离职待办来源、待办处理回写业务源、来源级动作声明、未声明动作后端拒绝和 IM 群邀请源回写。

# 2026-07-08 Shared SDK legacy write helper 清理
本轮继续把共享层里残留的 direct write helper 收口：`shared/core-sdk` 已移除 `contacts.accept()`、`attendance.checkIn()/checkOut()`、`notifications.readOne()/readAll()`、`meetings.join()`、`approvals.approve()/reject()`、`admin.updateUserStatus()`、`apps.updateAppStatus()/updateCard()` 与 `openPlatform.rotateSecret()/sendWebhookTest()`。这些状态流写操作现在统一要求消费后端返回的 `actions[]`，再通过各领域 `executeAction()` 发请求，避免上层继续按资源 id 或本地状态拼接流程接口。`npm --prefix shared/core-sdk test` 与端到端 SDK 联调测试会同步验证这一点。
# 2026-07-08 Mobile App legacy helper 清理
本轮继续收紧移动 App 写入边界：`frontend/mobile-app/utils/session.js` 已移除 `acceptContactRequest(requestId)`、`approveMobileApproval(instanceId)` 和 `rejectMobileApproval(instanceId)` 这些按 resource id 拼接路径的 legacy facade。员工端联系人申请和企业端审批页现在只能通过 `executeContactRequestAction(action)` 与 `executeMobileApprovalAction(action)` 消费后端 `/contacts/requests`、`/approvals/instances` 返回的完整 `actions[]` 契约，不再留下移动端按 id 直接写入的侧门。`npm run test:mobile-app` 已新增断言，确认 session facade 不再导出这些 helper。
# 2026-07-08 小程序联系人申请 legacy helper 清理
本轮继续收紧微信小程序联系人申请边界：`frontend/mini-program/utils/core-sdk.js` 与 `frontend/mini-program/app.js` 已移除固定 `acceptContactRequest(requestId)` 通道，小程序工作台只保留 `executeContactRequestAction(action, body)` 作为写入口，必须消费后端 `/contacts/requests` 返回的完整 `actions[].code/method/apiPath/resultField` 后才能提交请求；页面 `workbench.js` 中的 legacy wrapper 也已移除，避免前端再按申请 id 拼 `/contacts/requests/{id}/accept`。`npm run test:mini-program` 当前为 17/17。

# 2026-07-08 Mobile App 会议/通知 actions 契约收紧
本轮继续把 Mobile App 员工端“加入会议”和通知“单条已读 / 全部已读”收回到后端契约：员工页只在后端 `/meetings`、`/notifications`、`/notifications/summary` 返回完整 `actions[]` 时渲染对应按钮，点击后分别通过 `executeMobileMeetingAction(action)`、`executeMobileNotificationAction(action)` 或摘要 `read-all` action 执行后端给出的 `apiPath/method/body`；移动 App facade 已移除固定 `joinMobileMeeting()` / `markMobileNotificationRead()` 导出，`markAllMobileNotificationsRead()` 也必须先取得 `notificationSummary.actions[].code=read-all`，避免页面继续按资源 id 或固定路径拼 `/meetings/{id}/join`、`/notifications/{id}/read`、`/notifications/read-all`。`shared/core-sdk` 新增 `meetings.executeAction()` / `notifications.executeAction()` 及对应 `normalize*Action()`，会拒绝缺少 `code/method/apiPath` 或绝对 URL 的 action。`npm run test:mobile-app` 当前为 34/34，`npm --prefix shared/core-sdk test` 扩展到 45/45。

# 2026-07-08 Mobile App 假勤打卡 actions 契约收紧
本轮继续把 Mobile App 员工端假勤“上班打卡 / 下班打卡”收回到后端契约：`pages/employee/employee.vue` 只遍历 `session.attendance.actions[]` 渲染按钮，点击后通过 `executeMobileAttendanceAction(action)` 执行后端给出的 `apiPath/method/body`；移动 App facade 已移除固定 `checkIn()` / `checkOut()` 导出，避免页面继续拼 `/attendance/check-in|check-out`。`shared/core-sdk` 新增 `attendance.executeAction(action, body, token)` 与 `normalizeAttendanceAction()`，会拒绝缺少 `code/method/apiPath` 或绝对 URL 的 action。当前回归验证：`npm run test:mobile-app` 34/34，`npm --prefix shared/core-sdk test` 45/45。

# 2026-07-08 Mobile H5 假勤打卡 actions 契约收紧
本轮继续把 Mobile H5 员工端假勤“上班打卡 / 下班打卡”收回到后端契约：H5 只根据 `/api/v1/attendance/status` 返回的完整 `actions[].code/method/apiPath/body` 渲染 `attendance-action` 按钮，点击时按后端给出的 `apiPath/method/body` 提交；旧的 `data-action="check-in"` / `data-action="check-out"` 和固定 `/attendance/check-in|check-out` 路径已移除。缺少完整 action 时 H5 只显示“等待后端打卡动作同步”。`npm run test:mobile-h5` 当前为 12/12。

# 2026-07-08 PC Web 假勤打卡 actions 契约收紧
本轮把员工端假勤“上班打卡 / 下班打卡”也收回到后端契约：`GET /api/v1/attendance/status` 会根据当前账号打卡状态返回 `actions[].code/label/method/apiPath/tone/body/defaultComment`，未上班返回 `check-in`，已上班未下班返回 `check-out`，已下班返回空 `actions`。PC Web 员工假勤页只渲染后端提供的 `attendance-action`，并按 `apiPath/method/body` 提交；不再由前端固定生成 `/attendance/check-in` 或 `/attendance/check-out` 请求。当前回归验证：`npm run test:pc-web-core` 160/160，`npm --prefix shared/core-sdk test` 45/45，`npm run test:mock-api` 54/54。

# 2026-07-08 PC Web 会议加入 actions 契约收紧
本轮把员工端会议“加入会议”也收回到后端契约：`GET /api/v1/meetings` 与 `POST /api/v1/meetings` 会为当前账号可加入但尚未加入的会议返回 `actions[].code/label/method/apiPath/tone/body/defaultComment`，已加入会议和缺少完整 action 的旧数据只显示状态。PC Web 日历会议页只渲染后端提供的 `join` action，并按 `apiPath/method/body` 提交；不再由前端按会议 id 自行拼 `/meetings/{id}/join`。当前回归验证：`npm run test:pc-web-core` 160/160，`npm --prefix shared/core-sdk test` 45/45，`npm run test:mock-api` 54/54。

# 2026-07-08 PC Web 通知已读 actions 契约收紧
本轮把员工端通知单条“标记已读”也收回到后端契约：`GET /api/v1/notifications` 会为当前账号未读通知返回 `actions[].code/label/method/apiPath/tone/body/defaultComment`，已读通知和缺少完整 action 的旧数据只显示状态。PC Web 通知页只渲染后端提供的 `mark-read` action，并按 `apiPath/method/body` 提交；不再由前端按通知 id 自行拼 `/notifications/{id}/read`。当前回归验证：`npm run test:pc-web-core` 160/160，`npm --prefix shared/core-sdk test` 45/45，`npm run test:mock-api` 54/54。

# 2026-07-08 PC Web 开放平台 actions 契约收紧
本轮把企业开放平台自建应用“轮换密钥”和 Webhook“测试投递”也收回到后端契约：`GET /api/v1/open-platform/apps` 与 `GET /api/v1/open-platform/webhooks` 会为启用资源返回 `actions[].code/label/method/apiPath/tone/body/defaultComment`，停用资源或缺少完整 action 的旧数据只显示状态。PC Web 开放平台页只渲染这些后端 action，并按 `apiPath/method/body` 提交；不再由前端拼 `/open-platform/apps/{id}/rotate-secret` 或 `/open-platform/webhooks/{id}/send-test`。`npm run test:pc-web-core` 已扩展到 157/157，`npm run test:mock-api` 已扩展到 36/36。

# 2026-07-08 PC Web 管理后台用户状态 actions 契约收紧
本轮把企业管理后台员工冻结/恢复也收回到后端契约：`GET /api/v1/admin/users` 会为可操作员工返回 `actions[].code/label/method/apiPath/tone/body/defaultComment`，企业管理员本人、核心账号和不可流转状态返回空 `actions`。PC Web 管理后台只渲染这些后端 action，并按 `apiPath/method/body` 提交；旧的 `canChangeStatus=true` 数据缺少完整 action 时只显示状态，不再根据当前 `status` 自行推导 `FROZEN/ACTIVE` 或冻结/恢复按钮。`npm run test:pc-web-core` 已扩展到 156/156。

# 2026-07-08 PC Web 应用中心 / 工作台 actions 契约收紧
本轮把企业端应用上架/下架、工作台卡片启用/停用也收回到后端契约：`GET /api/v1/apps` 与 `GET /api/v1/workbench/cards` 会为企业管理员返回 `actions[].code/label/method/apiPath/tone/body/defaultComment`，员工端同一接口返回空 `actions`。PC Web 企业应用页只渲染这些后端 action，并按 `apiPath/method/body` 提交；缺少完整 action 的旧数据只显示状态，不再根据 `status === "PUBLISHED"` 或 `enabled` 自行推导下一步按钮。`npm run test:pc-web-core` 已扩展到 155/155，`npm run test:mock-api` 已扩展到 35/35。

# 2026-07-08 PC Web 企业审批 actions 契约收紧
本轮把 PC Web 企业端审批实例的通过/驳回入口也收回到后端契约：企业审批页现在只遍历 `/api/v1/approvals/instances` 返回的 `actions[].code/label/method/apiPath/tone/resultField/defaultComment` 渲染按钮，点击时按后端给出的 `apiPath/method/resultField/defaultComment` 发起请求；缺少完整 action 的旧 `PENDING` 审批只显示状态，不再根据 `status === "PENDING"` 自行生成 approve/reject 按钮或拼 `/approvals/instances/{id}/approve|reject`。`npm run test:pc-web-core` 已扩展到 154/154。

# 2026-07-08 PC Web / Mobile H5 联系人申请 actions 契约收紧
本轮继续把员工端联系人申请的“通过”入口从前端状态判断收回到后端契约：PC Web 与 Mobile H5 现在都只遍历 `/api/v1/contacts/requests` 返回的 `actions[].code/label/method/apiPath/tone/resultField/defaultComment` 渲染联系人申请按钮，点击时按后端给出的 `apiPath/method/resultField/defaultComment` 发起请求；缺少完整 action 的 incoming pending 旧数据只显示状态，不再根据 `direction === "incoming"` 与 `status === "PENDING"` 自行拼 `/contacts/requests/{id}/accept`。`npm run test:pc-web-core` 已扩展到 153/153，`npm run test:mobile-h5` 当前已随状态等待态验证扩展到 12/12。

# 2026-07-08 移动 App 联系人申请 actions 契约收紧
本轮把员工端联系人申请的“通过”操作也收回到后端契约：`GET /api/v1/contacts/requests` 现在会为当前账号可处理的 incoming pending 申请返回 `actions[].code/label/method/apiPath/tone/resultField/defaultComment`，移动 App 员工页只按后端 `actions[]` 渲染联系人申请按钮，不再根据 `direction === "incoming"` 和 `status === "PENDING"` 自行判断可操作性。`shared/core-sdk` 新增 `contacts.executeAction(action, body, token)`，会拒绝缺少 `code/method/apiPath/resultField` 或绝对 URL 的联系人申请 action；旧 `acceptContactRequest(requestId)` 仅作为兼容入口保留。
# 2026-07-08 小程序联系人申请 actions 契约收紧
本轮继续把微信小程序工作台联系人申请收口到后端契约：`frontend/mini-program/utils/core-sdk.js` 会保留 `/contacts/requests` 返回的完整 `actions[]`，新增 `executeContactRequestAction(action, body)` 校验 `code/method/apiPath/resultField` 并拒绝绝对 URL；`pages/workbench/workbench.wxml` 只遍历 `item.actions` 渲染按钮，不再根据 `direction === "incoming"` 与 `status === "PENDING"` 判断“通过”入口，页面点击后执行后端给出的 `apiPath/method/resultField`。
# 2026-07-08 移动 App 审批 actions 契约收紧
本轮把企业端审批轻操作也收回到后端契约：`GET /api/v1/approvals/instances` 会为企业审核账号返回 `actions[].code/label/method/apiPath/tone/resultField/defaultComment`，移动 App 企业页只按后端 `actions[]` 渲染通过/驳回按钮，不再根据 `status === "PENDING"` 或前端固定 `approve/reject` 方法判断可操作性。`shared/core-sdk` 新增 `approvals.executeAction(action, body, token)`，会拒绝缺少 `code/method/apiPath/resultField` 或绝对 URL 的审批 action；Mock API 审批服务在审核完成后返回空 `actions`，保证流程状态和权限边界由后端维护。
# 2026-07-08 管理后台状态权限收紧
本轮继续把企业管理后台的操作权限放回后端：`GET /api/v1/admin/users` 返回的 `canChangeStatus` 现在是员工冻结/恢复按钮是否可显示的唯一依据，`shared/core-sdk` 和 PC Web shaper 不再根据 `role === employee` 或当前账号自行推导可操作状态。Mock API 的 `admin-contract` 仍由后端根据当前企业管理员、目标账号和自改限制生成 `canChangeStatus`；前端只渲染后端返回的结果，真正提交状态更新时仍由 `PATCH /api/v1/admin/users/{account}/status` 做权限校验。
# 2026-07-08 用户中心默认业务数据清理
本轮继续清理用户中心前端默认业务数据：`shared/core-sdk`、PC Web、Mobile H5 和小程序适配层不再在缺少后端字段时生成固定二维码口令、二维码可见范围、账号保护开启状态、登录提醒开启状态或双重验证开启状态。头像、姓名、我的二维码、个性标签、企业、账号安全中心等展示仍由 `/api/v1/users/me/profile`、`/api/v1/users/me/qr-code`、`/api/v1/users/me/security` 水合；缺少后端二维码或安全策略时前端展示“等待后端同步/待生成”，复制二维码会提示后端口令未生成，避免客户端静态默认值冒充后端状态。
# 2026-07-08 多端假勤默认业务数据清理
本轮继续收紧假勤边界：`shared/core-sdk`、PC Web 员工假勤页、Mobile H5 fallback 和小程序适配层不再把缺失的后端假勤字段补成固定“09:00 - 18:00 / 总部 A 栋 / 上下班提醒”。班次、办公地点和提醒策略必须来自 `/api/v1/attendance/status` 或 `/api/v1/attendance/rules`；缺少后端规则时前端展示“等待后端假勤规则同步”。PC Web 与 Mobile H5 员工假勤页还会进一步只根据 `/api/v1/attendance/status` 返回的 `actions[]` 渲染上班/下班打卡按钮，缺少完整 action 时只显示空态，避免 UI 用静态业务配置或固定接口路径冒充后端状态。
# 2026-07-08 用户中心写接口与设置页联调
本轮把用户中心从“登录后只读资料”继续推进为后端可维护状态：新增 `PATCH /api/v1/users/me/profile` 和 `PATCH /api/v1/users/me/security`，由 `routes/user-routes.js`、`controllers/user-controller.js`、`services/user-service.js`、`stores/account-store.js` 分层处理。PC Web 员工设置页新增个人资料和账号安全中心保存表单，提交时调用后端 PATCH，再通过 `hydratePortalData()` 重新水合；shared core-sdk 新增 `user.updateProfile()` 与 `user.updateSecurity()`，e2e 契约覆盖 PATCH 后再 GET 验证后端状态。
# 2026-07-08 共享 SDK 待办执行入口收紧
本轮把 `shared/core-sdk` 的待办写操作继续收口为后端 action 契约：`todos` 领域不再公开 `complete(todoId)` / `reject(todoId)` 这类前端按 ID 推导路径的方法，改为 `executeAction(action, body, token)`。调用方必须传入 `/api/v1/todos` 返回的完整 `actions[].code/method/apiPath/resultField`，SDK 会拒绝缺字段或绝对 URL 的 action，并自动兼容后端返回 `/api/v1/...` 或 `/todos/...` 两种相对路径。
# 2026-07-08 共享 SDK 待办 actions 契约收紧
本轮继续收紧 `shared/core-sdk` 的统一待办 shape：`shapeTodoActions()` 只接受后端返回的完整 `actions[]`，不再从旧 `availableActions` 或只有 `code` 的 action 自动补 `apiPath/method/resultField/defaultComment`。`availableActions` 仍作为兼容展示字段保留，但不能再通过共享 SDK 变成可执行流程，PC Web、Mobile H5、Mobile App 和小程序通过 SDK 水合时会共同遵守后端 actions 契约。

# 2026-07-08 小程序待办 actions 契约收紧
本轮把微信小程序适配层也收紧到后端待办契约：`frontend/mini-program/utils/core-sdk.js` 不再把旧 `availableActions` 升级成可执行 `actions`，只保留为兼容展示字段。小程序 session 中真正可执行的待办动作必须来自后端 `actions[].apiPath/method/resultField/defaultComment`，缺少 `apiPath/method/resultField` 的 action 会被丢弃，避免后续页面在前端自行拼完成/退回流程。

# 2026-07-08 Mobile H5 待办 actions 契约收紧
本轮把 Mobile H5 的统一待办操作也收紧为后端契约驱动：H5 页面不再根据 `availableActions` 生成 `todo-complete/todo-reject` 按钮，也不再自行拼 `/todos/{id}/complete|reject`。待办按钮只来自后端 `actions[]`，点击后按 `apiPath/method/resultField/defaultComment` 发起请求；旧本地状态缺少个人标签时也会安全渲染，等待后端资料水合。

# 2026-07-08 PC Web 待办操作契约收紧
本轮继续把统一待办从“前端根据 `availableActions` 推导按钮和接口”收紧为“PC Web 只消费后端 `actions` 契约”。员工端和企业端待办按钮必须由 `/api/v1/todos` 返回的 `actions[].code/label/method/apiPath/resultField/defaultComment` 渲染；点击处理也必须使用后端给出的 `apiPath` 与 `resultField` 发请求，缺少契约时只提示刷新，不再由 UI 自行拼 `/todos/{id}/complete|reject`。`smoke:mock-api` 同步改为真实 HTTP 验证按后端 action 完成一条待办并退回一条待办。


# 2026-07-08 PC Web 默认状态去静态业务种子

本轮清理 PC Web `createDefaultPortalState()` 中的企业员工、企业风险、审批模板、核心租户、发布记录和支持工单静态样例。默认状态只保留空集合和展示所需的安全/二维码空壳，登录后的企业端、核心端数据必须由 `/enterprise/*`、`/admin/*`、`/core/*`、`/todos` 等接口水合；退出登录时也会清空企业/核心端水合数据，避免旧会话或本地缓存继续展示前端假数据。PC Web 右侧侧边栏也同步改为数据驱动：企业管理员提醒里的待发布工作台卡片、新员工待激活数量来自 `enterpriseWorkbenchCards` 和 `enterpriseEmployees`；核心端说明和支持多端来自 `/core/policies`、`/core/ops-alerts` 水合后的分类数据。

# 2026-07-08 核心维护端策略/告警 API 水合

本轮把 PC Web 核心维护端的“能力矩阵 / 核心策略 / 运维告警 / 服务边界”从前端静态数组改为后端数据驱动。`GET /api/v1/core/policies` 现在通过 `category=capability|policy` 区分能力矩阵和核心策略；`GET /api/v1/core/ops-alerts` 通过 `category=ops|boundary` 区分运维告警和服务边界。PC Web 核心端登录水合会请求这两个接口，页面只渲染后端返回的数据，`smoke:mock-api` 和 e2e 契约也已验证分类字段。

# 2026-07-07 Mock API 后端冒烟脚本

本轮新增 `npm run smoke:mock-api`，会在独立端口 `5096` 临时启动 Mock API，并通过真实 HTTP 验证 `/health`、未登录访问统一待办返回 `40100`、员工访问管理后台返回 `40300`、企业账号访问核心维护接口返回 `40300`、核心账号访问企业客户端接口返回 `40300`、核心账号可读取核心租户、企业管理员可读取用户并更新员工状态、操作日志排除核心账号，以及 `/api/v1/todos` 返回后端 `actions` 并可完成待办。该脚本把“能跑起来的后端基准”沉淀为可重复命令。
本轮同时新增 `npm run smoke:core-sdk-e2e`，会在独立端口 `5097` 临时启动 Mock API，并把 `FANG_API_BASE` 指向该实例后执行 `shared/core-sdk/tests/e2e.mock-api.test.js`。该脚本验证员工端“登录 -> hydrate -> 加好友 -> 同意 -> 发消息 -> 打卡 -> 通知 -> 退出”和企业端“登录 -> 拉企业数据 -> 退出”，把“共享 SDK 真实走后端契约”也沉淀为可重复命令。

# 2026-07-07 多端企业假勤规则 API 水合

本轮把 `GET /api/v1/attendance/rules` 从 PC Web 扩展到 shared core-sdk `hydrate()`、Mobile H5、Mobile App 预览和微信小程序预览。企业端会话统一携带 `enterpriseAttendanceRules`，前端只展示后端返回的 `shifts/reminders/exceptions/robot`，不再由各端单独维护企业假勤规则静态数据。

# 2026-07-07 统一待办后端 actions 契约进展

本轮把统一待办从“前端读取 `availableActions` 后自行拼按钮”推进为“后端返回完整 `actions` 操作描述”。`GET /api/v1/todos` 现在会为每条待办返回 `actions[].code/label/method/apiPath/tone/resultField/defaultComment`，PC Web 和 Mobile H5 优先按该后端契约渲染按钮并提交请求；`availableActions` 继续保留用于旧端兼容。`POST /api/v1/todos/{todoId}/complete|reject` 的返回 `data.request` 也带回 `apiPath`，便于前端、SDK 和契约测试追踪请求/返回闭环。

# 2026-07-07 企业假勤规则 API 进展

本轮新增 `GET /api/v1/attendance/rules`，企业端从后端读取班次、提醒、异常审批和假勤机器人规则；PC Web 企业端假勤页已改为消费后端 `shifts/reminders/exceptions/robot`，不再把企业假勤规则写死在页面里。该接口由后端权限矩阵控制，员工账号访问返回 `40300`。

## 📌 项目简介

本项目为高职软件技术专业（全栈开发方向）暑期实习的分组实战项目，目标是**全量复刻飞书（Lark）的核心业务功能**，覆盖即时通讯、协同文档、视频会议、日历、审批、云盘、通讯录、应用中心等核心模块，最终交付一个可在生产环境运行的**企业级协同办公平台**。

项目采用前后端分离架构，前端多端统一，后端高内聚低耦合，强调**业务完整度**、**工程规范**、**文档可追溯**与**可交付性**。

> ⚠️ **实习要求**：本项目不是 Demo 演示，而是面向真实业务场景的"准生产级"交付物，所有功能必须可演示、可回归、可交付。

---

## 🎯 业务目标（全量功能复刻清单）

| 序号 | 业务模块 | 核心功能 | 优先级 |
| :--: | :------- | :------- | :----: |
| 1 | 用户中心 | 注册/登录/找回密码/SSO 单点登录/三方登录 | P0 |
| 2 | 通讯录 | 组织架构/部门管理/员工名片/搜索 | P0 |
| 3 | 即时通讯（IM） | 单聊/群聊/消息已读/历史消息/文件传输/消息撤回 | P0 |
| 4 | 协同文档 | 富文本编辑/多人实时协作/版本历史/评论 | P0 |
| 5 | 视频会议 | 预约会议/即时会议/屏幕共享/会议录制 | P1 |
| 6 | 日历 | 日程创建/重复事件/提醒/共享日历 | P1 |
| 7 | 审批（OA） | 自定义表单/审批流/加签/转交 | P1 |
| 8 | 云盘 | 文件上传下载/在线预览/权限管理/分享 | P1 |
| 9 | 应用中心 | 应用上下架/工作台配置 | P2 |
| 10 | 消息通知 | 系统通知/邮件/短信/站内信 | P1 |
| 11 | 管理后台 | 用户管理/权限管理/数据字典/操作日志 | P0 |
| 12 | 开放平台 | OpenAPI/Webhook/应用鉴权 | P2 |

---

## 🛠️ 技术栈

### 前端
- **核心框架**：Vue 3（Composition API + `<script setup>`）
- **样式方案**：Tailwind CSS（Utility-First，配合设计系统）
- **状态管理**：Pinia
- **路由**：Vue Router 4
- **HTTP**：Axios + 请求拦截器统一封装
- **构建工具**：Vite
- **跨端框架**（多端）：Uni-app / Taro（输出 H5 + iOS + Android + **微信小程序**）
- **桌面端框架**（PC 客户端）：Electron（生态成熟，跨平台打包 .exe / .dmg / .AppImage） / Tauri（Rust 内核，轻量高性能）
- **UI 组件库**：自研组件库 + Headless UI（PC Web）/ Naive UI（PC 客户端）/ Vant（移动端）

### 多端覆盖
| 端 | 形态 | 技术实现 |
| :--: | :--: | :--: |
| 💻 PC 网页端 | Web | Vue 3 + Vite + Tailwind CSS（浏览器访问） |
| 🖥️ PC 客户端 | Desktop | Electron / Tauri 跨平台打包（.exe / .dmg / .AppImage） |
| 🍎 iOS 端 | App | Uni-app / Taro 编译打包 |
| 🤖 Android 端 | App | Uni-app / Tauri 编译打包 |

### 后端
- **运行时**：.NET 10
- **Web 框架**：ASP.NET Core 10
- **ORM**：EF Core 10 / Dapper
- **数据库**：PostgreSQL 16+（pgsql）
- **缓存**：Redis 7
- **消息队列**：RabbitMQ
- **实时通信**：SignalR（IM、视频会议信令）
- **鉴权**：JWT + OAuth 2.0
- **对象存储**：MinIO（文件/图片/视频）
- **搜索**：Elasticsearch 8

### 运维 / 部署
- **容器化**：Docker + Docker Compose
- **反向代理**：Nginx
- **CI/CD**：GitHub Actions / Gitee Go
- **监控**：Prometheus + Grafana
- **日志**：Serilog + ELK

---

## 📁 仓库目录结构

```
仿飞书应用-2班6组/
├── docs/                    # 📚 项目文档（强制要求：每个过程必须有md+配图）
│   ├── 00-项目概览/
│   ├── 01-需求分析/
│   ├── 02-原型设计/
│   ├── 03-技术选型/
│   ├── 04-数据库设计/
│   ├── 05-接口设计/
│   ├── 06-前端开发/
│   ├── 07-后端开发/
│   ├── 08-联调测试/
│   ├── 09-部署上线/
│   ├── 10-运维手册/
│   └── 11-周报与复盘/
├── frontend/                # 前端工程（Vue 3 + Tailwind）
│   ├── pc-web/             # PC 网页端（Web，浏览器访问）
│   ├── pc-client/          # PC 客户端（Electron / Tauri 桌面应用）
│   ├── mobile-h5/          # H5
│   ├── mobile-app/         # iOS + Android（Uni-app / Taro 编译）
│   └── mini-program/       # 微信小程序（Uni-app 编译输出到微信开发者工具）
├── backend/                 # 后端工程（.NET 10 + pgsql）
│   ├── src/
│   ├── tests/
│   └── scripts/
├── deploy/                  # 部署相关
│   ├── docker/
│   ├── nginx/
│   └── ci-cd/
├── .gitignore
├── README.md
└── LICENSE
```

## ✅ 当前已交付实现

本仓库当前已按 README 的多端与前后端边界补齐阶段性工程：

- `frontend/pc-web`：官网站点 + 认证中心 + 登录分流后的员工端 / 企业端 / 核心端浏览器版入口，`app.js` 已开始动态复用 `frontend/pc-web/core/` 的常量、API 封装、默认状态与状态持久化、路由守卫、鉴权错误分类、Portal 数据装配、Portal shape facade、Portal 数据加载器、Portal 事件动作、Portal 运行时服务、Portal 路由渲染器、PC Web 浏览器启动器、Portal Shell、渲染片段与工具函数，请求层在 Electron PC Client 内优先使用 `window.fangDesktop.api` preload 桥，普通浏览器优先复用 `shared/core-sdk`，profile / security / chat / notification / docs / drive / calendar / meetings / approvals / contacts / todos / admin / apps / openPlatform / core 相关 shape 已向 SDK 收敛；`test:pc-web-core` 覆盖 PC Web core 常量、工具函数、API fallback、桌面端 API 桥优先级、默认状态工厂、状态层、路由守卫、鉴权、Portal 数据装配、Portal shape facade、Portal 数据加载器、Portal 事件动作、Portal 运行时服务、Portal 路由渲染器、PC Web 浏览器启动器、Portal Shell、渲染片段与 ESM explicit export + portal-shapers/portal-loaders/portal-actions/portal-runtime/portal-renderer/portal-app/page-fragments/auth-pages/employee-pages/employee-collaboration-pages/enterprise-pages/enterprise-admin-pages/enterprise-open-platform-pages/core-pages 聚合导出 159 条单测，员工端工作台 / 消息 / 通讯录 / 考勤 / 设置页面级渲染已收敛到 `employee-pages.js`，员工端通知 / 云文档 / 云盘 / 日历会议 / 审批页面级渲染已收敛到 `employee-collaboration-pages.js`，假勤打卡按钮、通知单条已读按钮和会议加入按钮只消费后端 `actions[].apiPath/method/body`，企业端总览 / 员工 / 假勤 / 审批 / 应用 / 安全 / 资料页面级渲染已收敛到 `enterprise-pages.js`，其中企业假勤页由 `/api/v1/attendance/rules` 水合班次、提醒、异常审批和机器人规则，企业应用中心/工作台按钮只消费后端 `actions[].apiPath/method/body`；企业管理后台用户 / 角色 / 字典 / 操作日志页面级渲染已收敛到 `enterprise-admin-pages.js`，员工冻结/恢复按钮只消费后端 `actions[].apiPath/method/body`；企业开放平台 OpenAPI / 自建应用 / Webhook / 投递日志页面级渲染已收敛到 `enterprise-open-platform-pages.js`，自建应用轮换密钥和 Webhook 测试投递按钮也只消费后端 `actions[].apiPath/method/body`；核心端租户 / 发布 / 策略 / 运维 / 支持页面级渲染已收敛到 `core-pages.js`，并确认企业端保留应用中心、开放平台与安全中心入口；已接入 Mock API 完成登录、注册、找回密码、邀请码入企、二维码、安全中心、登录审计、联系人、组织通讯录、联系人申请、IM 会话、群聊创建、群成员列表/添加成员、消息历史、会话已读、文本/文件卡片发送、本人消息撤回，以及统一待办列表/完成/退回联调；员工端“今日待办”、企业端“后端待办”和核心端维护待办均由 `/api/v1/todos` 水合。
- `frontend/pc-client`：Electron 桌面壳体骨架，约定 Windows 客户端统一复用认证中心；新增 `shell.js` 抽出窗口配置、登录 URL、菜单模板、健康检查和自动更新占位逻辑，新增 `bridge-api.js` 与 `preload.js` 的 `fangDesktop.api` 安全桥，桌面渲染层可通过 `/api/v1/auth/login`、`/auth/logout`、`/users/me/profile`、`/todos` 和后端 `actions[]` 提供的待办 `apiPath/method/resultField` 契约调用后端，不再由桌面桥推导 `/todos/{id}/complete|reject` 路径，统一解析 `code/message/data/traceId` 并拒绝绝对 URL；`test:pc-client` 覆盖主进程壳体、preload 桥和桌面端后端 API 桥 16 条 Node 单测。
- `frontend/mobile-h5`：移动浏览器认证入口，新增独立静态服务与 `/shared/` SDK 映射，请求层和 profile / security / loginAudit / attendance / contacts / im / enterprise / todos / apps / workbench 基础 shape 已优先复用 `shared/core-sdk`；未登录页已补登录 / 注册 / 找回密码 / 邀请码入企四个认证入口，注册与邀请成功后按员工 / 企业账号分流，核心端仍被 H5 客户端拒绝；已接入 Mock API 完成员工 / 企业账号登录分流、二维码、安全中心、登录审计、假勤打卡后端 action、统一待办列表/完成/退回、应用入口、工作台卡片、联系人、组织通讯录、会话列表、群聊创建、群成员列表/添加成员、消息详情、会话已读、文本/文件卡片发送与本人消息撤回联调；`test:mobile-h5` 覆盖 H5 认证入口切换、员工/企业 API 驱动待办/工作台渲染、联系人申请 action、假勤打卡 action、缺失后端状态等待态和用户中心写接口 12 条 Node 单测。
- `frontend/mobile-app`：Uni-app 移动端预览，已接入 Mock API 完成登录门禁、注册、找回密码、邀请码入企、员工 / 企业账号分流、基础资料、二维码、安全中心、打卡、联系人、组织通讯录、IM 会话、群聊创建、群成员列表/添加成员、会话已读、文件卡片发送、本人消息撤回、企业成员预览，并通过共享 SDK 拉取统一待办、云文档、云盘、日历/会议、审批、通知、应用中心与工作台卡片摘要；员工端和企业端页面均新增统一待办卡片，直接展示 `/api/v1/todos` 返回的标题、摘要、状态与优先级；员工端已补云文档保存/评论、云盘上传/分享/下载、预约/加入会议、通知发送/单条已读/摘要全读、提交审批轻操作，通知按钮均只消费后端 `actions[]`；企业端审批实例通过/驳回按钮只从 `/api/v1/approvals/instances` 返回的 `actions[]` 渲染，并通过 `approvals.executeAction()` 提交后端给出的 `apiPath/method/resultField`，同时保留通知员工轻操作；新增 `test:mobile-app` 覆盖 helper、toast、session facade 与登录/注册/找回/邀请/员工/企业页面事件 34 条单测，真实 Mock API 冒烟确认员工端可打卡、创建群聊、查看并添加群成员、打开会话并标记已读、发送文本消息、发送文件卡片、撤回本人消息、发起联系人申请，企业端可新增员工，核心端仍保持独立入口。
- `frontend/mini-program`：微信小程序预览骨架，新增 `utils/core-sdk.js` 小程序专用适配层，把 `wx.request`、会话存储、登录水合、用户中心、通讯录、IM、统一待办、应用中心、工作台卡片和企业摘要 shape 集中管理；已补齐未登录拦截、员工 / 企业账号登录、Mock API 会话、工作台、二维码、联系人申请、通过申请、群聊创建、群成员列表/添加成员、会话打开、会话已读、文本消息发送、文件卡片发送、本人消息撤回、通讯录摘要与账号切换；登录水合会请求 `/api/v1/todos`、`/api/v1/apps` 和 `/api/v1/workbench/cards`，并把后端待办和工作台摘要写入小程序会话；状态缺失时展示等待后端同步文案，`test:mini-program` 当前 17/17 通过；核心端仍保持独立入口。
- `shared/core-sdk`：三端共享核心 SDK，已补齐 ESM / CJS 入口、会话存储、请求封装、shape 归一化、用户中心、通讯录、IM（含群聊创建、群成员列表/添加成员、文本发送、文件卡片发送、会话已读与本人消息撤回）、统一待办、假勤状态/假勤规则、通知、云文档、云盘、日历、会议、审批、应用中心、管理后台、核心维护与开放平台领域 API，并纳入根级 `npm run check`。
- `backend/src`：`.NET 10` Web API 骨架，补齐 Auth / Core Tenant 控制器。
- `backend/tests`：`.NET 10` 测试工程骨架。
- `backend/mock-api`：Node Mock API，补齐登录、注册、找回密码、邀请码入企、个人资料、二维码、安全中心、登录审计、通讯录、组织成员、联系人申请、统一待办列表/完成/退回、IM 会话、群聊创建、群成员列表/添加成员、消息历史、会话已读、文本/文件消息发送、本人消息撤回、假勤状态、企业假勤规则、云文档、云盘、日历、会议、审批、消息通知、企业员工、管理后台、开放平台、核心租户、核心发布、核心策略、核心运维告警接口，并提供 Bearer Token 会话；认证、用户中心、通讯录、IM、假勤、云文档、云盘、日历、会议、审批、通知、应用中心/工作台、开放平台、企业员工管理、管理后台、核心维护和统一待办模块已拆到 `routes` / `controllers` / `services` / `stores` / `middlewares` / `contracts`，`middlewares/http-middleware.js` 统一负责 CORS、`ok/fail/raw`、JSON body 解析和错误归一化，`middlewares/auth-middleware.js` 统一负责 Bearer Token 提取、session 查找和账号存在性校验，`middlewares/permission-middleware.js` 统一负责员工、企业、核心账号的后端权限矩阵，`stores/session-store.js` 统一负责 Mock Bearer session 的签发、读取、删除和清空，`stores/mock-data-store.js` 统一负责 Mock 数据集克隆、账号查找、快照和测试重置，`stores/account-store.js` 统一负责账号创建、员工档案占位、密码更新和登录审计，`stores/todo-store.js` 统一负责联系人申请、审批、假勤异常、企业入职/离职、企业安全风险、IM 群邀请和核心运维告警的待办来源同步与状态回写，通讯录服务的组织目录、二维码扫码和联系人申请通过，IM 服务的消息发送者、群成员列表、群聊创建/加成员，以及管理后台用户列表、状态变更和操作日志过滤也已复用 account store 的账号/员工档案边界，`server.js` 已继续清掉迁移后遗留的 contacts / IM / admin 旧 helper，入口主要保留健康检查、OpenAPI、种子数据和分层路由分发；联系人、会话、消息、打卡状态、企业假勤规则、文档正文/版本/评论、云盘文件/分享/下载、日历事件、会议预约/加入、审批实例、通知列表/未读/已读/发送、应用上下架、开放平台应用/Webhook/投递、企业员工、管理后台用户状态/角色/字典/日志、核心租户/发布/策略/告警/工单、工作台卡片和待办状态由后端服务层维护，前端只通过 `/api/v1` 与共享 SDK 调用；核心账号只能访问独立核心维护接口，访问通讯录、假勤和企业客户端员工管理接口会返回 `403`。
- `backend/scripts`：覆盖登录分流、个人资料、安全中心、企业成员、统一待办、假勤、核心端租户发布的 PostgreSQL DDL 与种子数据。
- `deploy/docker`：PostgreSQL、Redis、MinIO 的开发环境 Compose。
- `deploy/nginx`：前端与 API 反向代理配置。
- `deploy/ci-cd`：多端构建与发布目录骨架。

本阶段机器未安装 `.NET SDK`，因此本地运行仍以 `backend/mock-api` 承担联调与演示；`.NET 10` 目录用于补齐 README 结构与后续迁移落位。

第一轮里程碑“用户中心、通讯录、IM 跑通”当前已有 Mock API 与多端前端证据；IM 群聊创建、群成员列表/添加成员、会话已读、文件卡片消息与本人消息撤回基础状态流、统一待办/请求/返回状态流、协同文档基础文本闭环、会议预约与日历同步基础闭环、审批提交与企业审核基础闭环、云盘文件预览/分享/下载基础闭环已在 2026-07-06 补齐，真实群主管理、移除成员、群公告/群设置、真实二进制文件传输、真实音视频会议、富文本实时协作、完整自定义流程引擎等仍属于后续轮次继续扩展范围。

## ✅ 后端基准版运行说明

当前可运行后端基准以 `backend/mock-api/server.js` 为入口，目标是保障多端联调、角色边界和核心业务状态流可演示。用户中心、通讯录、IM、假勤、云文档、云盘、审批、通知、应用中心/工作台、核心维护与统一待办模块已先行拆分为 `backend/mock-api/routes`、`controllers`、`services`、`stores`、`middlewares`、`contracts`，其中统一待办提供列表/完成/退回，通讯录提供联系人/申请/扫码，IM 提供会话/群聊/成员/消息/已读/撤回，假勤提供状态读取和上下班打卡，云文档提供列表/详情/正文保存/版本/评论，云盘提供文件列表/上传/详情/分享/下载，审批提供模板/实例/通过/驳回，通知提供列表/摘要/单条已读/摘要全读/发送，并由列表与摘要分别返回可执行 `actions[]`，核心维护提供租户/发布/策略/告警/工单，应用中心/工作台提供应用列表、上架/下架和工作台卡片启停等 API 状态流。它仍是内存型 Mock API，不等同于生产级 .NET API、真实数据库、真实短信/邮件/OAuth、WebSocket、音视频、对象存储、真实 BPM、真实插件运行时或完整 RBAC。

2026-07-08 当前收紧点：IM 本人消息撤回仍由后端 `/api/v1/im/chats/{chatId}/messages/{messageId}/recall` 执行并校验发送者，但前端和共享 SDK 不再公开或调用 `im.recallMessage(chatId, messageId)` 直连方法。Mock API 会在消息列表和发送结果的 `message.actions[]` 中返回完整 `recall` 动作，PC Web、Mobile H5、Mobile App 和小程序只根据后端给出的 `code/method/apiPath/body` 渲染和执行按钮；撤回后消息类型变为 `recall`，`actions` 清空。

### Windows PowerShell 启动

```powershell
cd D:\.Claude\fang-feishu-app-class2-group6
npm run dev:api
```

健康检查：

```powershell
Invoke-RestMethod http://127.0.0.1:5086/health
```

正常返回示例：

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "status": "ok",
    "service": "mock-api"
  },
  "traceId": "..."
}
```

### 推荐验收命令

```powershell
npm run check
npm run test:mock-api
npm --prefix shared/core-sdk test
npm run smoke:mock-api
npm run smoke:core-sdk-e2e
```

### 端口与环境变量

| 服务 | 默认端口 | 启动命令 | 环境变量 |
| :-- | :-- | :-- | :-- |
| Mock API | `5086` | `npm run dev:api` | `HOST`、`PORT` |
| PC Web / 官网 | `5186` | `npm run dev:frontend` | `HOST`、`PORT` |
| Mobile H5 | `5286` | `npm run dev:mobile-h5` | `HOST`、`PORT` |
| PC Client 壳 | 复用 Web/API | `node frontend/pc-client/main.js` | `FANG_WEB_ORIGIN`、`FANG_API_ORIGIN` |

示例：

```powershell
$env:PORT="5087"
npm run dev:api
```

### 测试账号

| 角色 | 账号 | 密码 | 入口边界 |
| :-- | :-- | :-- | :-- |
| 员工 | `employee@fang.cn` | `123456` | 员工客户端 UI，工作台、联系人、IM、假勤 |
| 企业管理员 | `enterprise@fang.cn` | `123456` | 企业客户端 UI，员工管理、应用、安全、开放平台 |
| 核心维护 | `core@fang.cn` | `123456` | 独立核心维护端，仅租户、发布、策略、运维、支持 |

公开注册仅允许 `employee` 和 `enterprise` 两类角色；`core` 不允许通过公开注册接口创建。核心账号不允许访问员工/企业客户端接口，例如通讯录、假勤和企业客户端员工管理接口会返回 `403`。

### 后端基准接口范围

| 范围 | 已跑通接口 |
| :-- | :-- |
| 认证 | `/api/v1/auth/login`、`/api/v1/auth/register`、`/api/v1/auth/password/reset`、`/api/v1/auth/invite/accept` |
| 用户中心 | `GET/PATCH /api/v1/users/me/profile`、`/api/v1/users/me/qr-code`、`GET/PATCH /api/v1/users/me/security`、`/api/v1/users/me/login-audits` |
| 统一待办 | `/api/v1/todos`、`/api/v1/todos/{todoId}/complete`、`/api/v1/todos/{todoId}/reject` |
| 员工端 | `/api/v1/contacts`、`/api/v1/contacts/directory`、`/api/v1/contacts/requests`、`/api/v1/contacts/scan`、`/api/v1/attendance/status`、`/api/v1/attendance/check-in`、`/api/v1/attendance/check-out`、`/api/v1/workbench/cards` |
| IM | `/api/v1/im/chats`、`/api/v1/im/chats/{chatId}/members`、`/api/v1/im/chats/{chatId}/messages`、`/api/v1/im/chats/{chatId}/read`、`/api/v1/im/chats/{chatId}/messages/{messageId}/recall` |
| 企业端 | `/api/v1/enterprise/employees`、`/api/v1/enterprise/risks`、`/api/v1/enterprise/approvals`、`/api/v1/attendance/rules`、`/api/v1/admin/users`、`/api/v1/admin/roles`、`/api/v1/apps`、`/api/v1/workbench/cards` |
| 核心维护端 | `/api/v1/core/tenants`、`/api/v1/core/releases`、`/api/v1/core/policies`、`/api/v1/core/ops-alerts`、`/api/v1/core/support-tickets` |

### 多端入口

```powershell
cd D:\.Claude\fang-feishu-app-class2-group6
npm run dev:api
npm run dev:frontend
npm run dev:mobile-h5
```

- 官网 / PC Web：`http://127.0.0.1:5186`
- Mobile H5：`http://127.0.0.1:5286`
- Mock API：`http://127.0.0.1:5086`
- OpenAPI：`http://127.0.0.1:5086/openapi.json`

Android APK、Windows EXE 和微信小程序正式发布不属于当前后端基准版完成条件；当前只有目录结构、预览端、壳体或说明入口，未冒充真实发布包。

---

## 📚 文档规范（强约束）
> 🚨 **必读**：项目立项书已就位，请先阅读 [docs/00-项目概览/项目立项书.md](docs/00-项目概览/项目立项书.md)，了解项目背景、范围、团队分工与里程碑后再开展具体工作。



> 🚨 **本项目硬性要求：开发的每一个过程都必须有完整、详实的 md 文档，文档中必须有完整、具体的配图！**

### 1. 文档形式
- **格式**：Markdown（`.md`）
- **存放位置**：`docs/` 目录下，按阶段分文件夹归档
- **命名规范**：`XX-阶段-模块-描述.md`（如 `06-前端开发-IM-消息列表组件.md`）

### 2. 文档必备内容
每篇文档必须包含以下章节（缺一不可）：

| 章节 | 说明 | 是否必含配图 |
| :--: | :--: | :--: |
| 一、背景与目标 | 为什么要做、做到什么程度 | ✅ |
| 二、需求分析 | 用户故事、业务流程 | ✅ |
| 三、方案设计 | 技术方案、架构图、时序图 | ✅ |
| 四、数据库/接口设计 | 表结构、字段说明、接口契约 | ✅ |
| 五、核心实现 | 关键代码 + 流程截图 + 运行截图 | ✅ |
| 六、测试用例 | 功能测试 + 边界用例 | ✅ |
| 七、问题与复盘 | 踩坑记录、解决方案 | ✅ |
| 八、参考资料 | 链接、文档版本 | ❌ |

### 3. 配图要求
- **工具**：推荐 draw.io（架构图/流程图）、ProcessOn、Snipaste（截图）
- **存放**：`docs/` 下的 `images/` 子目录，命名与文档一致
- **格式**：PNG（截图）/ SVG（矢量图）
- **清晰度**：1080P 以上，关键位置需红框/箭头标注
- **数量要求**：每篇文档 **≥ 5 张配图**

### 4. 文档提交节奏
- **每完成一个功能模块** → 当天提交对应 md
- **每日下班前** → 提交 `docs/11-周报与复盘/日报-YYYY-MM-DD.md`
- **每周五** → 提交周报 + 进度截图

---

## 👥 团队分工（全栈开发 + 实施运维 双线并行）

> 🚨 **组内成员包含"全栈开发"和"实施运维"两个方向，必须保证两个方向都有明确任务，不能让任何一方无事可做。**

### 角色定位

| 方向 | 角色 | 核心职责 |
| :--: | :--: | :--: |
| 💻 全栈开发 | 前端工程师 | Vue 3 + Tailwind 多端开发 |
| 💻 全栈开发 | 后端工程师 | .NET 10 + pgsql 接口开发 |
| 🔧 实施运维 | 实施工程师 | 客户对接、需求调研、数据初始化、培训 |
| 🔧 运维工程师 | 部署、CI/CD、监控、故障排查 |

### 双线任务并行表（示例，按实际组员人数调整）

| 周次 | 全栈开发线 | 实施运维线 |
| :--: | :-- | :-- |
| W1 | 需求评审、技术选型、原型设计 | 客户调研、需求收集、文档整理 |
| W2 | 架构设计、数据库设计、接口设计 | 客户环境调研、服务器选型 |
| W3-W4 | 用户中心、通讯录开发 | 测试环境部署、数据初始化脚本 |
| W5-W6 | IM、协同文档开发 | CI/CD 流水线搭建、监控告警 |
| W7-W8 | 视频会议、日历开发 | 生产环境部署、压力测试 |
| W9-W10 | 审批、云盘、消息通知 | 用户培训、使用手册编写 |
| W11-W12 | 联调、Bug 修复、回归 | 试运行支持、问题收集与反馈 |
| W13-W14 | 性能优化、文档完善 | 项目验收、运维交接文档 |

### 任务分配模板（每位组员维护自己的清单）

```markdown
## 成员：XXX（全栈开发/实施运维）

### 本周任务
- [ ] 任务1（关联 issue/文档链接）
- [ ] 任务2

### 完成情况
- 任务1：✅ 已完成，文档：[docs/xxx.md](docs/xxx.md)
- 任务2：🚧 进行中，阻塞点：xxx

### 下周计划
- [ ] 任务3
- [ ] 任务4
```

---

## 📐 开发规范

### Git 规范
- **主分支**：`main`（稳定）/ `develop`（开发）
- **功能分支**：`feat/模块名-功能名`（如 `feat/im-message-list`）
- **修复分支**：`fix/问题描述`
- **提交规范**：`<type>(<scope>): <subject>`，遵循 Conventional Commits
- **代码审查**：所有 PR 必须至少 1 人 Review 通过才能合并

### 代码规范
- **前端**：ESLint + Prettier + Vue 3 风格指南
- **后端**：`dotnet format` + EditorConfig + C# 编码规范
- **命名**：驼峰（变量）/ 帕斯卡（类）/ 全大写下划线（常量）

### 接口规范
- **RESTful** 风格，统一前缀 `/api/v1/`
- **统一响应结构**：`{ code, message, data, traceId }`
- **错误分层**：未登录 `401/40100`，无权限 `403/40300`，参数错误 `400`，资源不存在 `404`，服务错误 `500`
- **错误码**：分模块管理，全局唯一
- **文档**：使用 Swagger / OpenAPI 3.0 自动生成

---

## 🚀 快速开始

### 环境要求
- Node.js ≥ 18
- pnpm ≥ 8（或 npm ≥ 9）
- .NET SDK 10
- PostgreSQL ≥ 16
- Redis ≥ 7
- Docker ≥ 24

### 启动步骤

```bash
# 1. 克隆仓库
git clone <仓库地址>
cd fang-feishu-app-class2-groupN

# 2. 启动中间件（pgsql + redis + minio）
docker compose -f deploy/docker/docker-compose.dev.yml up -d

# 3. 启动后端
cd backend
dotnet restore
dotnet ef database update
dotnet run

# 4. 启动前端
cd frontend/pc-web
node server.js

# 当前阶段也可直接在仓库根目录运行
npm run dev:api
npm run dev:frontend
npm run dev:mobile-h5

# 5. 访问
# PC Web：http://127.0.0.1:5186
# Mobile H5：http://127.0.0.1:5286
# Mock API：http://127.0.0.1:5086
# OpenAPI：http://127.0.0.1:5086/openapi.json
```

---

## 🤝 仓库使用规范

1. **禁止** 直接 push 到 `main` / `develop` 分支
2. **禁止** 提交 `node_modules/`、`bin/`、`obj/`、`*.user`、`appsettings.Development.json` 等敏感/体积大的文件
3. **必须** 在 `docs/` 中维护对应过程的 md 文档和配图
4. **必须** 为每个功能模块编写单元测试，后端覆盖率 ≥ 60%
5. **必须** 在 PR 描述中关联对应的文档路径

---

## 📅 项目里程碑

| 阶段 | 时间 | 交付物 |
| :--: | :--: | :-- |
| 需求 + 设计 | W1-W2 | 需求文档、原型图、架构图、数据库 ER 图 |
| 第一轮开发 | W3-W6 | 用户中心、通讯录、IM 跑通 |
| 第二轮开发 | W7-W10 | 文档、会议、日历、审批、云盘、消息通知 |
| 联调 + 测试 | W11-W12 | 测试报告、Bug 清零 |
| 部署 + 验收 | W13-W14 | 生产环境部署、培训手册、验收报告 |

---

## 📞 联系方式

- **组长**：（填写）
- **指导老师**：（填写）
- **组内沟通群：（填写）
- **问题反馈**：通过 GitHub/Gitee Issues 提交

---

## 当前进展补充（2026-07-06）

本轮按 README 第二轮范围补齐了协同文档、会议/日历、审批、云盘、消息通知的基础闭环，并继续补齐 README P0“管理后台”的基础闭环，仍保持与 `Life/IMO Platform` 独立：

- `backend/mock-api` 新增统一待办分层模块，`server.js` 只做入口分发，`routes/todo-routes.js`、`controllers/todo-controller.js`、`services/todo-service.js`、`stores/todo-store.js`、`middlewares/role-middleware.js`、`contracts/todo-contract.js` 承担待办路由、参数、业务、数据、权限和响应契约。
- `backend/mock-api` 继续把用户中心 `/api/v1/users/me/profile`、`/qr-code`、`/security`、`/login-audits` 从 `server.js` 拆到 `routes/user-routes.js`、`controllers/user-controller.js`、`services/user-service.js`、`contracts/user-contract.js`，登录后四块基础资料仍由后端统一返回。
- `backend/mock-api` 继续把通讯录和 IM 从 `server.js` 拆到 `routes/contacts-routes.js`、`controllers/contacts-controller.js`、`services/contacts.js`、`contracts/contacts-contract.js` 以及 `routes/im-routes.js`、`controllers/im-controller.js`、`services/im.js`、`contracts/im-contract.js`，联系人申请、建群、群成员、消息发送、已读和撤回都走后端服务层。
- `backend/mock-api` 继续把应用中心和工作台配置从 `server.js` 拆到 `routes/apps-routes.js`、`controllers/apps-controller.js`、`services/apps-service.js`、`contracts/apps-contract.js`，企业端应用上架/下架和工作台卡片启停由后端状态驱动，员工端只读取后端返回的已上架应用和已启用卡片。
- `backend/mock-api` 新增 `/api/v1/todos`、`/api/v1/todos/{todoId}/complete`、`/api/v1/todos/{todoId}/reject`，按员工、企业、核心维护账号返回不同待办，并把未登录 `401`、无权限 `403`、重复处理 `40004` 纳入统一响应结构。
- `shared/core-sdk` 新增 `todos.list()`、`todos.executeAction()` 与 `shapeTodo()`，会话水合时为员工端、企业端拉取待办；待办写操作必须消费后端返回的 `actions[].apiPath/method/resultField`，不再通过 SDK 公开 `complete(todoId)` / `reject(todoId)` 直连方法。
- `frontend/pc-web` 员工端“今日待办”、企业端“后端待办”和核心端维护待办已改为调用 `/api/v1/todos`，完成/退回按钮通过后端 API 处理后刷新列表，不再把待办状态硬编码在 UI。
- `backend/scripts/schema.sql` 与 `seed.sql` 新增 `todos` 表和联系人申请、审批、安全提醒、核心运维告警种子数据，方便后续迁移到 PostgreSQL/EF Core。
- `backend/mock-api` 新增 `/api/v1/docs`、文档详情、正文保存、版本历史、评论列表/新增评论接口，并拆入 `routes/docs-routes.js`、`controllers/docs-controller.js`、`services/docs-service.js`、`contracts/docs-contract.js`；文档访问、正文版本递增、评论写入和审计留痕由后端服务层维护。
- `frontend/pc-web` 员工端“云文档”页已从静态展示改为 Mock API 数据驱动，支持打开文档、保存正文生成版本、新增评论、新建文档。
- `backend/mock-api` 新增 `/api/v1/calendar/events`、`/api/v1/meetings`、`/api/v1/meetings/{meetingId}/join`，并拆入 `routes/calendar-routes.js`、`controllers/calendar-controller.js`、`services/calendar-service.js`、`contracts/calendar-contract.js` 以及 `routes/meetings-routes.js`、`controllers/meetings-controller.js`、`services/meetings-service.js`、`contracts/meetings-contract.js`；日历事件、会议预约同步日历、加入会议状态回写由后端服务层维护。
- `frontend/pc-web` 员工端“日历”页已从静态展示改为 Mock API 数据驱动，支持查看日程、预约会议、加入会议。
- `backend/mock-api` 新增 `/api/v1/approvals/templates`、`/api/v1/approvals/instances`、通过/驳回接口，并拆入 `routes/approvals-routes.js`、`controllers/approvals-controller.js`、`services/approvals.js`、`contracts/approvals-contract.js`，支持员工提交审批、企业管理员处理审批，审批状态由后端服务层维护。
- `frontend/pc-web` 新增员工端“审批”入口，企业端“审批配置”页增加待处理审批实例。
- `backend/mock-api` 新增 `/api/v1/drive/files`、文件详情、分享、下载接口，并拆入 `routes/drive-routes.js`、`controllers/drive-controller.js`、`services/drive-service.js`、`contracts/drive-contract.js`；云盘文件元数据上传、在线预览、企业内可见、指定成员分享和下载内容由后端服务层维护。
- `frontend/pc-web` 新增员工端“云盘”入口，支持查看文件列表、在线预览、上传模拟文件、分享和下载。
- `backend/mock-api` 新增 `/api/v1/notifications`、未读摘要、单条已读、摘要全读接口，并拆入 `routes/notifications-routes.js`、`controllers/notifications-controller.js`、`services/notifications-service.js`、`contracts/notifications-contract.js`；通知列表、未读统计、已读状态、摘要 `read-all` action 和同企业发送校验由后端服务层维护，系统通知、邮件、短信、站内信仍为 Mock 投递记录。
- `frontend/pc-web` 新增员工端“通知”入口，支持查看通知列表、未读统计、按后端 action 标记单条已读、按摘要 `read-all` action 全部已读、给同企业成员发送模拟通知。
- `backend/mock-api` 新增 `/api/v1/admin/users`、用户状态更新、角色权限、数据字典、操作日志接口，并把企业员工 `/api/v1/enterprise/employees|risks|approvals` 与管理后台 `/api/v1/admin/*` 拆入 `contracts` / `services` / `controllers` / `routes` 分层；企业管理员仅能访问本企业管理数据，核心端账号不进入客户端管理后台。
- `frontend/pc-web` 企业端新增“管理后台”入口，覆盖用户管理、权限管理、数据字典和操作日志，可冻结/恢复员工、创建字典项并刷新审计日志。
- `backend/scripts/schema.sql` 与 `seed.sql` 新增管理后台角色权限、数据字典和操作日志相关表与种子数据。
- `backend/mock-api` 新增 `/api/v1/apps`、应用上架/下架、`/api/v1/workbench/cards`、工作台卡片配置接口；当前已拆入应用中心/工作台后端分层模块，企业端配置会影响员工端可见应用与卡片。
- `frontend/pc-web` 企业端“应用中心”改为 Mock API 数据驱动，可查看应用状态、上架/下架应用、启停员工端工作台卡片；员工端工作台快捷应用读取企业端已启用配置。
- `backend/scripts/schema.sql` 与 `seed.sql` 新增 `app_catalog`，并让 `workbench_cards` 绑定应用目录。
- `backend/mock-api` 新增 `/api/v1/open-platform/openapi`、自建应用、应用凭证换 token、Webhook 配置、测试投递和投递日志接口，并拆入 `routes/open-platform-routes.js`、`controllers/open-platform-controller.js`、`services/open-platform-service.js`、`contracts/open-platform-contract.js`；企业端开放平台管理接口需要企业账号，启用的自建应用和 Webhook 会返回 `actions[]` 供前端执行轮换密钥与测试投递，`/oauth/token` 保持应用凭证公开换 token。
- `frontend/pc-web` 企业端新增“开放平台”入口，覆盖 OpenAPI 目录、自建应用鉴权、Webhook 配置和投递日志，可创建应用、创建 Webhook；轮换密钥和测试投递按钮只根据后端 `actions[]` 渲染并按 `apiPath/method/body` 提交。
- `backend/scripts/schema.sql` 与 `seed.sql` 新增开放平台应用、Webhook 和投递日志相关表与种子数据。
- `frontend/mobile-h5` 新增 `server.js`，独立运行在 `5286` 端口并通过 `/shared/core-sdk/src/index.js` 暴露共享 SDK；H5 员工 / 企业登录冒烟已确认 `sdkLoaded=true`、SDK 请求次数大于 0、fallback 请求为 0。
- `frontend/mobile-h5` 未登录认证页继续补齐注册、找回密码、邀请码入企三种入口，复用后端 `/api/v1/auth/register`、`/api/v1/auth/password/reset`、`/api/v1/auth/invite/accept` 契约；注册/邀请成功后立即水合个人资料、二维码、安全中心、登录审计、统一待办、应用入口、工作台卡片和员工/企业数据，核心账号仍不允许进入 H5 客户端；`npm run test:mobile-h5` 当前 12/12，覆盖认证入口切换、H5 员工/企业 API 驱动待办/工作台渲染与缺失后端状态时的等待态。
- `frontend/mini-program` 新增 `utils/core-sdk.js`、`utils/tests/core-sdk.test.cjs` 与 `utils/tests/workbench.test.cjs`，小程序端 `app.js` 已从大块 request/shape/hydrate 实现改为薄壳；Node mock 单测覆盖员工登录、员工联系人/IM 操作、企业登录、核心端拒绝，以及工作台页未登录拦截、会话水合、二维码联系人申请、打开会话并标记已读、发送文本消息、发送文件卡片、撤回本人消息、通过申请和退出登录事件；本轮小程序登录水合已新增 `/todos`、`/apps`、`/workbench/cards` 请求并把统一待办、应用数和工作台卡片数写入指标/模块摘要，真实 Mock API 冒烟确认员工端可打开会话、发送消息、发起二维码联系人申请并通过联系人申请，企业账号读取 5 个员工 / 3 条风险。
- `frontend/mobile-app` 员工页继续补齐协作轻操作：通过 `shared/core-sdk` 调用云文档保存正文、新增评论、云盘上传元数据/文本内容、云盘分享给联系人、云盘下载内容接口、预约会议接口、发送通知接口；企业页审批实例通过/驳回改为执行后端返回的审批 `actions[]`，并保留通知员工接口，由 `test:mobile-app` 的 session facade 与页面事件测试覆盖。
- `frontend/mobile-app` 登录页继续升级为移动 App 认证中心，新增登录 / 注册 / 找回密码 / 邀请码入企四个入口；session facade 新增 `registerAccount()`、`resetPassword()`、`acceptInvite()`，注册和邀请成功后复用同一角色分流与水合链路，核心账号继续拒绝进入移动客户端；本轮将 shared SDK hydrate 返回的 `todos` 落入移动 App 会话，员工端和企业端页面新增 Unified Todos 卡片，测试断言 `/todos` 已参与移动端水合。
- 本轮继续补齐 IM 本人消息撤回基础状态流：`backend/mock-api` 保留 `/api/v1/im/chats/{chatId}/messages/{messageId}/recall`，但前端不再直连拼接撤回路径；`shared/core-sdk.im.normalizeMessageAction()` / `im.executeAction()`、PC Web、mobile-h5、mobile-app、mini-program 均只消费消息 `actions[]` 中的后端撤回契约；撤回仅限发送者本人，撤回后消息类型变为 `recall`、`actions` 清空并刷新会话摘要。
- 本轮继续补齐 IM 文件卡片基础闭环：`backend/mock-api` 复用消息发送接口支持 `type=file`，`shared/core-sdk.im.sendFileMessage()`、PC Web、mobile-h5、mobile-app、mini-program 均接入文件卡片发送入口；端到端契约已验证会话摘要显示 `[文件] ...`。
- 本轮继续补齐 IM 会话已读基础闭环：`backend/mock-api` 新增 `/api/v1/im/chats/{chatId}/read`，读取消息历史时也会把当前账号该会话未读数清零；`shared/core-sdk.im.markChatRead()`、PC Web、mobile-h5、mobile-app、mini-program 打开会话时均接入显式已读调用，端到端契约已验证未读数归零。
- 本轮继续补齐 IM 群聊创建基础闭环：`backend/mock-api` 新增 `POST /api/v1/im/chats`，`shared/core-sdk.im.createGroupChat()`、PC Web、mobile-h5、mobile-app、mini-program 均接入建群入口；端到端契约已验证员工创建群聊后可继续在该群内完成未读、已读、文本和文件卡片状态流。
- 本轮继续补齐 IM 群成员列表/添加成员基础闭环：`backend/mock-api` 新增 `GET/POST /api/v1/im/chats/{chatId}/members`，`shared/core-sdk.im.listChatMembers()` 与 `im.addChatMembers()` 已接入，PC Web、mobile-h5、mobile-app、mini-program 可展示当前群成员并添加同企业成员；端到端契约已验证成员列表和添加成员返回。
- 本轮继续补齐后端基准核心维护边界：`backend/mock-api` 新增 `/api/v1/core/policies` 与 `/api/v1/core/ops-alerts`，并把 `/api/v1/core/tenants`、`/core/releases`、`/core/policies`、`/core/ops-alerts`、`/core/support-tickets` 拆入 `routes/core-routes.js`、`controllers/core-controller.js`、`services/core-service.js`、`contracts/core-contract.js`；公开注册禁止创建 `core` 账号，核心账号访问员工/企业客户端接口会返回 `403`；端到端契约覆盖注册、重置密码、邀请码入企、核心维护接口和核心隔离边界。
- 当前交付是 IM 群聊创建/群成员列表与添加成员/文本发送/文件卡片/会话已读/本人撤回状态流、基础文本协作、会议/日历、审批状态流、云盘元数据/文本内容、通知投递记录、管理后台、应用中心、开放平台、核心策略和核心运维告警 Mock 闭环，不等同于完整群主管理、移除成员、群公告/群设置、成员审批、完整富文本编辑器、多人实时协作、真实对象存储、真实二进制文件传输、真实音视频会议 SDK、完整 BPM 流程引擎、真实邮件/短信网关、实时已读回执、生产级 RBAC、完整审计中心、真实应用市场/插件运行时或生产级 OAuth/OpenAPI 网关。

---

## 📄 License

本项目仅用于高职软件技术专业暑期实习教学使用，未经许可不得用于商业用途。
# 2026-07-07 后端会话注销进展

本轮新增后端会话注销闭环：`POST /api/v1/auth/logout` 会注销当前 Bearer Token，使旧 token 再访问 `/api/v1/users/me/profile` 等受保护接口时返回 `40100`。共享 SDK 新增 `auth.logout(token)`，并把 `signOut()` 从“只清本地 session”升级为“先请求后端注销，再清本地 session”。PC Web、Mobile H5、小程序适配层、Mobile App session facade 的退出动作也会尽力调用后端 logout，前端退出不再只是 UI 本地状态切换。

# 2026-07-07 后端权限矩阵进展

本轮继续按“后端为核心、前端只通过 API 调用”的方向推进 `backend/mock-api`：

- 新增 `middlewares/permission-middleware.js`，以统一权限矩阵管理 `employee`、`enterprise`、`core` 三类账号的 API 能力边界。
- 员工端、企业端、核心维护端不再只依赖前端隐藏入口；`admin`、`enterprise`、`open-platform`、`core`、`todos`、`workbench`、`attendance`、`collaboration`、`approval` 等 controller 已改为请求后端 permission。
- 未登录继续返回 `40100`，无权限继续返回 `40300`；`/api/v1/open-platform/oauth/token` 保持应用凭证公开换 token，不要求用户 Bearer。
- `tests/e2e/contract.test.cjs` 新增权限矩阵契约测试，覆盖员工越权访问企业/开放平台、企业越权访问核心、核心越权访问管理后台，以及公开 OAuth token 交换。

当前权限矩阵仍是 Mock RBAC 基座，适合作为以后替换真实数据库权限表、JWT/SSO、审计中心和生产级多租户隔离的后端分离基础。
# 2026-07-08 Mobile H5 fallback 待办契约修正
本轮继续补齐 Mobile H5 的离线 fallback shape：即使 `/shared/core-sdk` 加载失败，`frontend/mobile-h5/app.js` 也不再根据只有 `code` 的 action 或旧 `availableActions` 推导 `/todos/{id}/complete|reject`、`method`、`resultField` 和默认文案。H5 fallback 只接受后端返回完整 `code/apiPath/method/resultField` 的 `actions[]` 作为可执行按钮，`availableActions` 只保留为兼容展示字段。

# 2026-07-08 移动多端用户中心写接口补齐
本轮把 `PATCH /api/v1/users/me/profile` 与 `PATCH /api/v1/users/me/security` 从 PC Web 继续扩展到 Mobile H5、Mobile App 预览和微信小程序预览。Mobile H5 设置卡片新增 `profile-update` 与 `security-update` 表单，提交后调用后端 PATCH 并重新 hydrate；Mobile App `session.js` 新增 `updateMobileProfile()` / `updateMobileSecurity()`，通过 shared core-sdk 的 `user` domain 保存后端状态；小程序 `utils/core-sdk.js` 新增 `updateProfile()` / `updateSecurity()`，经 `wx.request` 调用后端并回写 session。新增测试覆盖三端 PATCH 请求体、Bearer token 和保存后重新水合，用户资料与账号安全不再停留在只读展示。
# 2026-07-08 开放平台创建默认值收口
本轮继续把开放平台资源创建默认值收回后端：`POST /api/v1/open-platform/apps` 只消费 `name/scopes/callbackUrl`，`appKey/appSecret/status` 由后端生成或维护；`POST /api/v1/open-platform/webhooks` 只消费 `name/event/targetUrl`，`status/lastDeliveryStatus/lastDeliveredAt` 由后端生成或维护。`shared/core-sdk.openPlatform.createApp()` / `createWebhook()` 已过滤这些后端字段，Mock API service 和 E2E 契约测试覆盖客户端伪造字段不能覆盖默认值。当前验证：`npm.cmd run test:mock-api` 60/60、`npm.cmd --prefix shared/core-sdk test` 46/46、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run test:pc-web-core` 162/162、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e`、`npm.cmd run check` 均通过。

# 2026-07-08 核心发布默认状态收口
本轮继续把核心维护端“创建发布任务”的流程状态收回后端：`POST /api/v1/core/releases` 只消费 `version/type/coverage` 等发布草稿字段，`status` 固定由 `core-service` 写为 `进行中`。PC Web 核心端发布按钮已移除请求体中的 `status`，`shared/core-sdk.core.createRelease()` 也会过滤调用方伪造的状态字段，新增 Mock API service、PC Web、SDK 和契约测试覆盖该边界。

# 2026-07-08 企业新增员工默认值收口
本轮继续把企业端“新增员工占位”的业务默认值收回后端：`POST /api/v1/enterprise/employees` 只消费账号、姓名、部门等输入字段，`status` 固定由 `enterprise-service` 写为 `待激活`，`portal` 固定为 `employee`，客户端传入的 `status/portal` 不再作为业务事实。PC Web、Mobile H5、Mobile App 已移除新增员工请求体中的 `status/portal`，新增 Mock API service、PC Web、H5、App 和契约测试覆盖该边界。最新整体验证见本文件顶部“后端运行级基准复验”和开放平台默认值收口条目。
# 2026-07-08 开放平台后端契约去默认值
本轮继续收紧开放平台契约边界：Mock API `open-platform-contract.shapeOpenPlatformApp()` 不再把缺失应用 `status` 补成 `ENABLED`，缺状态自建应用不会自动获得 `rotate-secret` action；`shapeWebhook()` 不再把缺失 `status/lastDeliveryStatus` 补成 `ENABLED/PENDING`，缺状态 Webhook 不会自动获得 `send-test` action；`shapeWebhookDelivery()` 也不再把缺失投递 `status` 补成 `PENDING`。`open-platform-service.createApp()` 和 `createWebhook()` 新建资源时仍由后端明确写入真实默认值。当前验证：`npm.cmd run test:mock-api` 72/72 通过。

# 2026-07-08 假勤打卡与规则后端契约去默认值
本轮继续收紧假勤契约边界：Mock API `attendance-contract.shapeAttendance()` 不再把缺失 `checkedIn/checkedOut` 补成 `false`，缺打卡状态不会自动生成 `check-in` action；只有后端明确返回 `checkedIn=false` 或 `checkedIn=true/checkedOut=false` 时才生成下一步打卡 action。`shapeAttendanceRules()` 也不再把缺失班次 `status`、提醒/异常 `enabled` 补成 `ENABLED/true`，缺字段保留为空值或 `null`。当前验证：`npm.cmd run test:mock-api` 71/71、`npm.cmd --prefix shared/core-sdk test` 47/47、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 和 `git diff --check` 均通过。

# 2026-07-08 核心维护端后端契约去默认值
本轮继续收紧核心维护端状态边界：Mock API `core-contract` 不再把缺失的租户 `status/clientVersion`、发布 `status`、策略 `status`、运维告警 `level/status`、支持工单 `status/tenant` 补成默认业务值；缺字段只保留为空值，交给核心维护页面展示等待后端同步。`core-service.createRelease()` 新建发布任务时仍由后端明确写入真实 `DEFAULT_RELEASE_STATUS`。当前验证：`npm.cmd run test:mock-api` 69/69、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e` 均通过。
# 2026-07-08 OpenAPI 方法与 IM 会话事实去默认业务值
本轮继续收紧“后端返回事实、前端只消费”的边界：Mock API `im-contract.shapeChat()/shapeChatMessage()/shapeChatMember()`、shared SDK、微信小程序适配层和 Mobile H5 fallback 不再把缺失的 IM 会话 `type` 补成 `group`、消息 `type` 补成 `text`、群成员 `role` 补成 `MEMBER`；缺消息类型也不会由后端 contract 兜底生成撤回 action，H5 只有在后端明确 `type=group` 时才渲染群成员管理入口。shared SDK `shapeOpenApi()` 也与后端 `open-platform-contract.shapeOpenApi()` 对齐，不再把缺失的接口目录 `method` 补成 `GET`。正常群聊/单聊、文本/文件/系统消息、群主/成员身份和 OpenAPI 方法仍由后端 service 明确返回。当前验证：`npm.cmd run test:mock-api` 77/77、`npm.cmd --prefix shared/core-sdk test` 47/47、`npm.cmd run test:mobile-h5` 15/15、`npm.cmd run test:mini-program` 18/18 通过。
# 2026-07-08 假勤/云盘/日历/核心发布类型字段去默认业务值
本轮继续把业务分类和访问范围从 contract/SDK/前端适配层默认值中收回：Mock API contract、shared SDK、Mobile H5 fallback 和微信小程序适配层不再把缺失的假勤异常 `type` 补成“异常/Exception”，不再把云盘文件 `type` 补成 `file`、`permission` 补成 `enterprise`，不再把日历事件 `type` 补成 `SCHEDULE`，也不再把核心发布 `type` 补成“全量发布”。上传云盘文件、新建日程、创建核心发布、生成默认假勤规则等场景仍由后端 service 显式写入真实默认值。当前验证：`npm.cmd run test:mock-api` 79/79、`npm.cmd --prefix shared/core-sdk test` 47/47、`npm.cmd run test:mini-program` 18/18、`npm.cmd run test:mobile-h5` 15/15、`npm.cmd run test:pc-web-core` 162/162、`npm.cmd run test:mobile-app` 36/36、`npm.cmd run test:pc-client` 16/16、`node --test tests/e2e/contract.test.cjs` 14/14、`npm.cmd run check`、`npm.cmd run smoke:mock-api` 和 `npm.cmd run smoke:core-sdk-e2e` 均通过。
# 2026-07-08 认证密码哈希与企业待办隔离补强
本轮继续补齐后端认证与企业隔离边界：新增 `backend/mock-api/services/password-service.js`，注册、找回密码重置、邀请码入企创建的新密码会由 Mock 后端使用 Node `scrypt` 哈希后写入账号数据，登录统一通过 `verifyPassword()` 校验；现有 seed 演示账号仍兼容旧明文密码，避免本地演示账号失效，但新增/重置密码不再明文落盘。`auth-service` 同时要求重置密码必须显式提交新密码，避免公开找回接口把缺失密码兜底成 `123456`。本轮还修复 `account-store.ensureEmployeeRecord()` 缺少企业字段导致统一待办可能按 `assigneeAccount` 跨企业可见的问题，员工档案会写入/回填 `enterprise`，`todo-store` 即使命中直接负责人也会继续校验企业边界，防止其他企业入职待办出现在当前企业管理员待办里。当前验证：`npm.cmd run test:mock-api` 97/97、`npm.cmd run smoke:mock-api` 通过，smoke 输出包含 `passwordReset=old password rejected + new password accepted` 且企业待办恢复为 4 条。
# 2026-07-08 会话生命周期与 SDK 会话接口补齐
本轮把登录会话继续收回到后端：`POST /api/v1/auth/login` 和注册/邀请码入企返回 `accessToken`、`tokenType=Bearer`、`expiresAt` 与 `session` 元数据，新增受保护接口 `GET /api/v1/auth/session` 用当前 Bearer token 查询后端会话，路由权限为 `user.self:read`。`backend/mock-api/stores/session-store.js` 现在为 Mock session 写入 `createdAt/expiresAt` 并在 `get()/has()` 时清理过期 token；这仍是 Mock session 基线，不等同生产 JWT、刷新令牌、SSO 或真实账号安全审计。
共享 SDK 新增 `auth.session(token)` 与 `auth.currentSession(token)`，`signIn()` 会保留后端返回的 `tokenType/expiresAt`，前端可以通过 SDK 请求后端确认当前登录态，而不是用本地静态状态冒充会话。OpenAPI 已声明 `/api/v1/auth/session`，smoke 会验证该接口的 Bearer security 与 `x-permission`。当前验证：`npm.cmd run test:mock-api` 98/98、`npm.cmd run smoke:mock-api` 输出 `openapiPaths=71` 且包含 `session=employee@fang.cn/employee`、`npm.cmd run smoke:core-sdk-e2e` 2/2、`node --test tests/e2e/contract.test.cjs` 14/14。
# 2026-07-08 后端操作日志 Store 收口
本轮继续把管理与安全维护能力往后端数据层收拢：新增 `backend/mock-api/stores/operation-log-store.js`，统一负责 `operationLogs` 集合初始化、追加、截断、按企业可见范围过滤和排除核心账号日志。`admin-service`、`apps-service`、`open-platform-service` 原来各自维护的 `appendOperationLog()` 已改为调用同一个 store，企业管理员查看管理后台日志时仍只能看到本企业非核心账号产生的记录；应用状态、工作台卡片、自建应用、密钥轮换、Webhook 创建与测试投递等后端写操作都会通过统一审计入口写入 Mock 操作日志。

这一步仍然不是生产级审计中心：没有真实数据库审计表、不可篡改日志、异步日志管道、SIEM、链路追踪或合规留存，只是把当前 Mock API 的操作日志从分散 service 私有函数推进到可替换的 store 边界。当前验证：相关局部 Node 测试 13/13 通过，`operation-log-store.test.cjs` 已纳入 `npm.cmd run test:mock-api`。

# 2026-07-08 Mock 数据仓库边界与健康自检
本轮继续把“以后可替换真实数据库/真实仓储层”的目标往后端落地：新增 `backend/mock-api/stores/schema-registry.js`，显式声明 Mock 后端当前业务集合、集合类型、领域归属和 `schemaVersion=2026-07-08.mock-db.v1`；`createMockDataStore()` 启动和 reset 时会按 registry 补齐缺失集合为空数组或对象，保证旧持久化文件也能对齐仓储边界，但不会生成任何账号、企业、待办、审批、IM 等业务事实。新增 `backend/mock-api/services/health-service.js`，`GET /health` 现在会在统一响应 envelope 内返回 `backendMode`、`apiEnvelope`、业务数据存储模式、session 存储模式、活跃 session 数、schema metadata、schema 状态、集合总数和记录数。

该能力仍然是 Mock JSON store，不等同真实 PostgreSQL/事务/迁移脚本已经完成；它的价值是把“当前后端到底有哪些表状集合、是否文件持久化、数据层是否退化”做成可运行自检，方便后续迁移到真实 repository/DB 时按同一边界替换。当前验证：`npm.cmd run test:mock-api` 115/115，`npm.cmd run smoke:mock-api` 输出 `health=mock-api/2026-07-08.mock-db.v1`、`openapiPaths=73`、`persistence=verified after restart`，`npm.cmd run check` 通过。
# 2026-07-09 前端 API 运行级 smoke

本轮新增 `npm.cmd run smoke:frontend-api`，启动真实 Mock API 后复用前端代码自己的 API 层做运行级联调：PC Web 侧通过 `createPortalLoaders()` / `createPortalShapers()` 分别登录并 hydrate 员工、企业、核心三类门户；Mobile H5 通过轻量 DOM + `app.js` 运行时请求同一后端；Mobile App 通过 `utils/session.js` facade 拉取移动端会话数据；小程序预览通过 `createMiniSdk()` 和 `wx.request` 适配层请求 Mock API；PC Client 壳通过 `bridge-api.js` 请求同一套后端接口。验证点覆盖工作台、待办、联系人、IM、云文档、应用中心、企业员工、企业风险、管理后台、开放平台和核心维护数据，并继续确认核心账号不会进入 H5 / App / 小程序客户端。

当前运行证据：`npm.cmd run smoke:frontend-api` 通过，输出 PC Web employee `todos=2/contacts=2/chats=4/apps=5/cards=4`、enterprise `employees=5/todos=4/adminUsers=5/openApi=6`、core `tenants=3/releases=3/policies=8/opsAlerts=6/todos=3`；Mobile H5 employee `todos=2/contacts=2/chats=4/apps=5/cards=4`、enterprise `todos=4/employees=5/risks=3/apps=6/cards=6`；Mobile App employee `todos=2/contacts=2/chats=4/docs=2/apps=5`、enterprise `todos=4/employees=5/risks=3/apps=6`、`requests=47`；Mini Program employee `todos=2/contacts=2/chats=4/apps=5/cards=4`、enterprise `todos=4/employees=5/risks=3/apps=6/cards=6`；PC Client employee `todos=2/contacts=2/chats=4/messages=3/members=2/apps=5/cards=4`、enterprise `employees=5/risks=3/approvals=3`、core `tenants=3/releases=3/policies=8/opsAlerts=6/tickets=3`、`requests=20`。脚本会校验每次 fetch 返回统一 envelope，并断言 Mobile App / PC Client 确实请求 `/todos`、`/workbench/cards`、`/contacts`、`/enterprise/employees`、`/enterprise/risks`、IM 会话消息，以及 PC Client 的 `/core/tenants`、`/core/policies`、`/core/ops-alerts` 等后端路径；Mobile App 仍禁止请求 core API。同时复验 `npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e`、`npm.cmd run check` 均通过。该 smoke 证明五端前端 API 层可以连真实 Mock 后端取数，但不等同 Playwright 浏览器 UI 验收、Android 真机包、Windows 安装包、微信开发者工具真机调试、真实数据库、生产 JWT/RBAC/SSO 或生产部署完成。

# 2026-07-09 多端认证角色边界加固

本轮继续按“后端返回角色、前端只消费角色”的边界收紧 PC Web、Mobile H5 和 Mobile App：登录结果必须是后端明确返回的 `employee` / `enterprise` / `core` 之一，公开移动客户端只允许 `employee` / `enterprise` 进入，`core` 仍保留在独立核心维护入口；缺失或未知角色不会再被前端兜底成员工端。注册入口也不再默认 `employee`，PC Web / H5 / App 会在发请求前拒绝被篡改的 `core` 或未知角色。路由守卫同步修复为未知登录态回登录页，不再跳转到 `#/unknown`。

当前验证：`npm.cmd run test:mobile-h5` 18/18、`npm.cmd run test:mobile-app` 37/37、`npm.cmd run test:pc-web-core` 165/165 均通过。该能力仍是 Mock API + 前端边界硬化，不等同生产级 RBAC、JWT/SSO、设备风控、账号保护策略或真实权限审计已经完成。
# 2026-07-09 前后端分离收尾验证

本轮在目标仓库 `D:\.Claude\fang-feishu-app-class2-group6` 完成一次收尾复验：后端 Mock API 已按 `routes/controllers/services/stores/middlewares/contracts` 分层运行，PC Web、Mobile H5、Mobile App 预览、微信小程序预览与 PC Client 壳均通过共享 SDK 或桥接 API 调用 `/api/v1` 后端能力；统一响应继续保持 `{ code, message, data, traceId }`，未登录、无权限、参数错误、资源不存在和服务错误均由后端统一返回业务码。

核心维护端账号安全闭环已纳入本轮验收：`GET /api/v1/core/account-security` 由核心账号读取客户端账号保护状态，`POST /api/v1/core/account-security/{account}/unlock` 由核心账号解除锁定；员工和企业账号访问该核心端接口会返回 `403/40300`。账号保护仍由 `auth-service` 与 `account-store` 维护，连续 3 次错误密码会返回 `403/40303`，解锁动作只来自后端返回的 `actions[]` 契约，前端不本地推导或伪造解锁。

本轮实际通过：`npm.cmd run test:mock-api` 202/202、`npm.cmd --prefix shared/core-sdk test` 47/47、`npm.cmd run test:pc-web-core` 168/168、`npm.cmd run test:pc-client` 18/18、`npm.cmd run test:mobile-h5` 18/18、`npm.cmd run test:mobile-app` 37/37、`npm.cmd run test:mini-program` 26/26、`npm.cmd run check`、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:core-sdk-e2e`、`npm.cmd run smoke:frontend-api` 与 `node --test tests/e2e/contract.test.cjs` 15/15。`smoke:mock-api` 输出 `openapiPaths=75`、`openapiSecurity=bearerAuth + x-permission verified`、`unauthorizedTodos=401/40100`、`employeeAdmin/coreEnterprise/enterpriseCore=403/40300`、`accountProtection=403/40303`、`persistence=verified after restart`；`smoke:frontend-api` 已覆盖 PC Web、Mobile H5、Mobile App、小程序预览和 PC Client 的员工/企业/核心 API 取数。

当前阶段仍明确是“可运行的前后端分离 Mock 后端基准”，不是生产级真实数据库、生产 JWT/RBAC/SSO/MFA、真实安全审计中心、Android/Windows 安装包、微信小程序正式发布或完整飞书一比一复刻。它的交付价值是把业务事实、权限判断、待办动作和核心维护能力集中到可替换的后端边界，为后续迁移真实数据库、真实 .NET/Node 后端和生产权限体系打底。
## 2026-07-09 Runtime Service Registry 边界
本轮继续把 Mock API 的“可替换后端”边界从 `data source / session / permission / repositories` 往上推进到 `services`：新增 `backend/mock-api/runtime/services/service-registry-adapter.js` 和 `backend/mock-api/services/service-registry.js`，由 `backend-runtime.js#createRequestContext()` 在每次请求中统一生成 `context.services`，并把当前账号、会话、repositories、时钟等依赖注入到业务 service。各 controller 现在会优先消费 `context.services.<domain>Service`，`todo-service` 也会优先通过运行时注入的 `attendanceService`、`contactsService` 等来源 service 完成待办状态流转，而不是只在单测里支持 service 注入。
`GET /health` 会继续在统一 `{ code, message, data, traceId }` 包装里报告当前 `permission`、`repositories`，并新增 `services` 驱动信息；当前默认仍是 `mock-service-registry`，它只证明 Mock runtime 已具备未来替换真实 Node/.NET service proxy 或远程业务网关的注入边界，不等同于真实数据库、真实微服务、生产 JWT/RBAC/SSO/MFA、消息队列或生产部署已经完成。当前验证：`npm.cmd run check`、`npm.cmd run test:mock-api` 253/253、`node --test tests/e2e/contract.test.cjs` 15/15、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:frontend-api`、`npm.cmd run smoke:core-sdk-e2e` 均通过。

## 2026-07-09 Env Provider Loader 边界
本轮继续把 runtime 的替换能力从“代码里手动传参”推进到“启动时环境变量挂载 provider 模块”：新增 `backend/mock-api/runtime/runtime-provider-loader.js`，支持通过 `FANG_RUNTIME_DATA_SOURCE_MODULE`、`FANG_RUNTIME_SESSION_STORE_MODULE`、`FANG_RUNTIME_PERMISSION_PROVIDER_MODULE`、`FANG_RUNTIME_REPOSITORY_MODULE`、`FANG_RUNTIME_SERVICE_MODULE`，以及可选 `FANG_RUNTIME_MODULE_CWD` 在启动时加载自定义 provider。`backend-runtime.js` 现在会先读取这些 env provider，再回退到显式传参，最后才回退到默认 Mock adapter。
这意味着以后要替换真实 PostgreSQL adapter、Redis/JWT session、外部 RBAC、远程 repository factory 或 service factory 时，不必先改 `server.js` 入口；只要 provider 模块满足当前 adapter 契约，就能挂到相同的 runtime 边界上。它依旧只是“可替换 Mock runtime”能力，不等于真实数据库、真实 .NET/Node 后端、生产网关、服务发现或分布式事务已经完成。

本轮继续把这条边界从“单测里能注入”推进到“真实启动链路可替换”：新增 `backend/mock-api/runtime/providers/example-data-source.cjs`、`example-session-store.cjs`、`example-permission-provider.cjs`、`example-repository-factory.cjs`、`example-service-factory.cjs` 和 `scripts/smoke-runtime-providers.cjs`。`npm.cmd run smoke:runtime-providers` 会通过环境变量启动真实 `backend/mock-api/server.js`，验证 `/health` 暴露 env provider driver，未登录 `/api/v1/todos` 继续返回 `401/40100`，企业账号可以退回审批待办，并在服务重启后确认 `approval-inst-1` 仍保持 `REJECTED`。

为避免“接口已经 200，但业务 JSON 还没落盘”的时序抖动，`backend/mock-api/server.js` 新增 `attachSuccessfulMutationCommitBeforeResponse()`，把成功写请求的 `runtime.commitAfterSuccessfulMutation()` 挪到响应真正结束前执行；新增 `backend/mock-api/runtime/tests/server-runtime.test.cjs` 覆盖提交顺序和 commit 失败后的错误响应退路。当前验证：`npm.cmd run check`、`npm.cmd run test:mock-api` 259/259、`node --test tests/e2e/contract.test.cjs` 15/15、`npm.cmd run smoke:mock-api`、`npm.cmd run smoke:runtime-providers`、`npm.cmd run smoke:frontend-api`、`npm.cmd run smoke:core-sdk-e2e` 均通过。

# 2026-07-10 前端演示凭据清理
本轮移除了 PC Web、Mobile H5、Mobile App 预览和微信小程序预览生产代码中的演示账号常量、账号密码预填、fill-demo/quick-login/demo-login 与预置账号按钮。Mock seed 账号仍可作为开发/测试手动输入凭据，但不会出现在客户端页面或全局状态中；登录、注册、找回密码和邀请码入企继续统一通过后端认证 API。`scripts/check-architecture-boundaries.cjs` 已增加生产前端禁用规则，防止 `DEMO_ACCOUNTS`、`PREVIEW_ACCOUNTS`、`getPreviewAccount`、预置账号 UI 和前端内嵌 mock 密码回流。当前验证：`npm.cmd run check`、`npm.cmd run test:pc-web-core` 166/166、`npm.cmd run test:mobile-h5` 18/18、`npm.cmd run test:mobile-app` 36/36、`npm.cmd run test:mini-program` 26/26、`npm.cmd run smoke:frontend-api` 均通过；仍属于可替换 Mock 后端基础，不等同真实数据库、生产 JWT/RBAC/SSO/MFA。

# 2026-07-10 Mobile Drive Default Ownership
Mobile App drive upload now submits only the user-provided file name and optional content. The frontend does not set default type, size, or enterprise permission.
`POST /api/v1/drive/files` remains backend-owned for type inference, size derivation, default enterprise permission, and preview metadata. `smoke:frontend-api` now verifies the mobile request omits those defaults and the backend returns `document` plus `enterprise` for a Markdown upload.
Verified: `npm.cmd run check:architecture`, `npm.cmd run test:mobile-app` (36/36), and `npm.cmd run smoke:frontend-api`.

# 2026-07-10 Mobile App Explicit Business Input Boundary
Mobile App no longer invents meeting, notification, or employee-management business data. Employee users must enter a meeting title and participant accounts before calling `POST /api/v1/meetings`; the facade only forwards explicit optional meeting fields. Both employee and enterprise notification forms require a recipient, title, and body, and omit `channel/category/actionText` unless a future UI explicitly supplies them. Enterprise employee creation requires a user-entered name and sends only the entered name plus an optional department.

`meetings-store` remains responsible for omitted start time, duration, room, and recording defaults; `notifications-store` remains responsible for notification delivery defaults; `enterprise-store` remains responsible for employee ID, enterprise, status, and portal. `check:architecture` blocks the previous mobile placeholder/default patterns, and `smoke:frontend-api` verifies actual mobile requests omit those backend-owned fields while the returned data contains backend defaults. Verified: `npm.cmd run test:mobile-app` (37/37), `npm.cmd run check:architecture`, and `npm.cmd run smoke:frontend-api`.