教程二:基于标准源码开发客户业务

先按安装手册从发行包完成空库安装,浏览客户/目录/审批页面,保持SDK wheel锁定。代码导航:backend/wsea/app.py为HTTP与会话入口;customers.py保存客户和审计;approvals.py保存实例/任务/意见及客户业务效果;models.py为本应用表;platform.py只适配SDK与Actor;frontend/src为实际页面。

用现有客户资料审阅走完开发合同

  1. 平台企业管理员创建员工、发布含岗位审批与抄送的模板,给员工customers.view/create/edit、approvals.view/submit,给审核者approvals.decide并配置节点人员;双方都有runtime.access。不能用账号名称代替稳定employee_id。
  2. 员工登录应用,客户页新增“教程客户”,保存并记下返回id/version。创建/编辑用UUID Idempotency-Key;页面和后端同时校验权限,服务端决定企业应用范围。
  3. 客户行点资料审阅,选模板、正式预览、提交。平台launch返回签名依据,应用保存冻结路径及业务上下文;预览不能作为已提交实例,客户端普通摘要不能替代launch证明。
  4. 审核者登录待办批准。应用先通过SDK核验当前资格与continuation,持有自身实例版本/锁,写入任务、意见、事件、客户业务结果并同事务提交。并发只一个版本成功。审批人变化时旧人拒办,新的有效人读取更新后的待办;历史原意见不改。
  5. 列表查询客户与审批历史;申请停用目的批准才停用客户,拒绝不会直接停用。文件附件由本应用文件表和目录管理,业务提交仍持有所属范围。

增加自己的业务字段或页面

仅在应用中建立模块/表/前向迁移,并同步schema历史、安装验证、API目录、权限目录和手册;不要改SDK保存客户SQL,也不要改平台的角色/员工表。输入模型extra=forbid,保留版本和幂等合同;权限code是完整应用内编码。迁移显式运行,禁止startup自动建表或trigger。公共SDK协议变更回到SDK源和独立版本,不能在各业务模块各写一套Token/游标/投影解析。

可执行验证

.\.venv\Scripts\python.exe -m pytest tests/test_new_execution.py tests/test_new_platform.py

以实际存在测试名为准,包的 tests/test_m21_sdk_installation.py 验证SDK安装边界。真实SQL测试需显式专用新库,不能误连旧库;SQL测试的创建/清理约束见测试文件。前端 npm ci --ignore-scripts、npm run build、npm test 在frontend目录。真实操作补客户保存、审批前后数据库与HTTP、浏览器桌面及390截图;不能用单元替身冒充真连接。