Files
zkxw/openspec/changes/project-business-statistics/design.md
T
zlwu a4c4028144 fix(projects): resolve runtime permissions and migration compatibility
Use existing menu permissions for management actions, preserve shared list styles in teleported detail dialogs, and align project attribution column collations with the project primary key. Record isolated MySQL and browser validation while retaining the real-device acceptance gate.
2026-11-02 16:04:31 +08:00

6.4 KiB
Raw Blame History

实现设计与接口契约

模块边界

新增 models/project_management.py、services/project_management.py、api/project_management.py。现有四种主表(预签约、采集协议、科研捐赠、中试/基础实验申请)增加可空 project_id,不向下游样本表复制归属。不更改已有课题名称 project_title。

项目组包含 teamName、leaderUserId、members[{id?,userId}]、regions[{id?,regionId}]、hospitals[{id?,hospitalId}]、enabled、remark。子行按 sync_child_rows 与自然键更新。负责人应计入可选项目成员判断。项目包含 projectNo、projectName、teamId、leaderUserId、bizTypes[]、startDate、endDate、status(pending/active/completed/disabled)、remark。编号服务端生成。项目已有业务后禁止换组;引用中的项目和组只能停用,不能删除。所有引用租户内校验。

权限与兼容

管理功能使用 project:team:list/edit、project:project:list/edit、project:statistics:list、project:assignment:edit 菜单权限,复用有效角色并集;super_admin 仍限定本次认证租户。代录选任意项目需 project:assignment:edit,不用普通 admin 身份自动放开。订单数据统计、明细及归属调整应用原有 apply_data_scope;项目成员身份不扩权。

新单据项目必填由 PROJECT_ASSIGNMENT_REQUIRED 配置控制,默认 false 供多端滚动升级;全部入口更新且项目资料准备好后由运维设为 true。数据库历史 NULL 继续合法。编辑未传 projectId 时保留旧值;普通表单不可改变已有非空归属,历史补录与归属调整统一从维护入口审计。未改变归属的历史单据不重验成员或启用状态。

公共服务契约:

validate_assignment(db, tenant_no, user, project_id, biz_type, *, current_project_id=None, required=False) -> str | None
project_brief(db, tenant_no, project_id) -> dict  # projectId/projectName/teamId/teamName

用户 user 使用认证上下文字典。调用方在创建时传 required=settings.PROJECT_ASSIGNMENT_REQUIRED;传入项目必须存在、启用、组启用、业务类型匹配且用户为负责人/成员或有代录权限。普通更新若归属不同返回“请通过项目归属维护调整”。转换复制来源项目,不按转换操作人重新分配;转换的目标业务类型仍允许保留来源项目历史归属。

HTTP契约

均复用 success_response。管理前缀 /web/admin/project-management。

  • GET /teams:page/pageSize/keyword/leaderUserId/enabled,返回 {list,total};POST /teams;GET/PUT/DELETE /teams/{id}。
  • GET /projects:page/pageSize/keyword/teamId/status,返回 {list,total};POST /projects;GET/PUT/DELETE /projects/{id}。
  • GET /references:返回 {users:[{id,name}],regions:[{id,name}],hospitals:[{id,name,regionId}]},仅管理权限。
  • GET /statistics:groupBy=team|project、teamId/projectId/startDate/endDate,返回 {items:[{id,name,teamName,cell_storage,research_donation,pilot_service,basic_experiment}],totals:{含未归属的四类业务总量},unassignedTotals:{四类业务计数},presignTotal}。
  • GET /records:bizType=presign|cell_storage|research_donation|pilot_service|basic_experiment,page/pageSize/teamId/projectId/unassigned/status/keyword/startDate/endDate,返回 {list:[{id,bizType,bizNo,status,projectId,projectName,teamId,teamName,createTime}],total,statusCounts:{原状态码:数量}}。
  • POST /assignments/preview:{bizType,id,projectId},返回 {records:[{bizType,id,bizNo,projectId,projectName}]}。
  • POST /assignments:{bizType,id,projectId,reason,expectedAssignments:[{bizType,id,projectId}]};锁定并重新校验关联集合及旧归属后一次事务提交,记录审计;不匹配返回冲突,全部单据须有权操作。
  • GET /assignments/history:bizType/id,返回 {list},每行包含 oldProjectName/newProjectName/reason/operatorName/createTime。
  • GET /project-management/options(独立认证路由,不要求管理菜单):bizType/keyword/currentProjectId,返回 {list:[{id,projectName,projectNo,teamId,teamName,disabled}],required}。currentProjectId不授权读取任意项目;仅补充本人已有权限单据的历史显示,若难以证明则由单据响应的名称回显,不返回额外敏感资料。

业务既有返回新增 projectId/projectName/teamId/teamName(嵌套单据放到 basic);列表支持 projectId/teamId 过滤。认证租户不由客户端传入。前端选择器复用统一 options 接口。

关联与统计

预签约转协议继承归属;存储/捐赠互转继承。归属维护将同租户的预签约→协议→捐赠转换记录组成关联集合,循环防重,锁定顺序固定;任一关联记录不可访问则拒绝整个操作,返回信息不暴露无权查看单据。历史软删除记录不参与活跃统计,不复活。

正式存储按协议、捐赠按主单、中试和基础实验按对应 biz_type 申请单计数;预签约另列,不把四类数量称为独立客户数。日期按创建日期(起日含、结束日次日不含),状态显示当前状态。查询先按租户、软删除、原有数据权限过滤,再聚合,不联接子行产生重复;金额不在本期。

界面与验证

Web P01/P02/P09,参考 system/unit/index.vue、cell-storage/protocol/ProtocolFormDialog.vue,复用 panel-top/list-table/list-wrap/list-pager-bar/dialog-form-layout 等。移动复用 src/market 契约与既有选择器,保留 Token,不借任务全局换色。

自动化测试使用隔离 SQLite 内存数据库,运行验收使用独立 MySQL 5.7 合成库;不连接或修改真实业务库。用户已明确授权本任务自行切换 backend/web-admin 服务,需保留原配置和运行来源记录。迁移验证覆盖首次新增、排序规则兼容修正及重复执行。最终服务/真机环境不可用时报告验证缺口,不标记完成合并。

查询筛选与新建选择的区别

公共 options 默认用于新建/归属调整,校验项目启用和成员资格。usage=filter 按现有可见业务主单返回历史项目(包含完成/停用),不因成员变更丢失筛选能力。 移动列表使用 /mini/market/{specialist|manager}/project-options?bizType=...,复用对应菜单权限及现场数据范围;不借公共筛选扩大现场范围。 普通创建不能伪造来源预签约/转换来源,普通更新不得改来源关联;只有受控转换入口维护来源图。