跳到正文

Haonan S005-2 后端 LLD

基于 PRD、原型、HLD 与 S005-1 数据设计,输出后端 Schema、接口、幂等与并发、流式协议、Agent 生命周期、监控和验收规范;用于后端详细设计与审查。

个人 Skill产品研发4 个文件浏览次数 0
开始使用

下载前阅读 SKILL.md 中的使用条件,并确认所用工具支持对应能力。

输入资料
生成 LLD 前读取以下适用资料并检查关键依赖。必要信息缺失时只暂停依赖该信息的设计,明确其余可交付内容;在完整授权内补充必要前置设计。 【SKILL02】PRD 核心业务验收:提取业务闭环、Agent 上架/管理的功能定义、以及对高并发 (QPS/TPS) 的指标要求。 【SKILL03】PROTOTYPE 交互映射:提取所有需要后端支撑的动态交互点。 【SKILL04】HLD 架构基座验收:核对 API 网关选型、微服务拆分边界与安… 阅读本节完整说明
交付内容
按以下四阶段完成全部设计;用户要求交互评审时逐阶段确认,完整授权下连续执行并报告进度。 第一阶段 (Storage: 资产映射与存储深度设计):输出 【第 1 至 3 节:上游资产承接、后端本能防线、关系型与向量库详细设计篇】。询问:“存储层已完全解耦,Schema 与索引优化已就绪,是否符合性能预期?” 第二阶段 (Interface: 协议规约与网关治理):用户确认后,输出 【第 4 节:API 网关路由、前后端流式协议与外部数据交… 阅读本节完整说明
  1. 获取完整包,保留配套文件的目录结构。
  2. 按照原文准备所需工具、依赖与输入资料。
  3. 阅读对应使用步骤与输入输出说明,在自己的环境中验证结果。

使用提示摘自原文,配套文件保留来源版本;实际运行条件以各包说明为准。

正文

获取原文件

references/service-behavior.md

缺少材料时标记事实、推导与未知。只阻塞受关键未知影响的动作。依赖或 API 用法不确定时查看对应版本官方资料,不默认 Redis、Kafka、SSE 或其他基础设施。

设计要求

  1. 为服务定义职责、数据所有权、调用方和访问边界。每个承诺动作映射到实际业务处理及可观察结果。
  2. 接口包含身份、权限、请求、响应、错误、分页、版本、幂等和兼容语义;使用方及错误后的恢复动作明确。
  3. 状态转换绑定实际业务事实;保存记录、确认请求、执行成功和收到外部回执分别定义。
  4. 配置发布后明确运行时读取位置、版本选择、作用范围、缓存失效和实际效果。没有执行器时不能把配置状态命名为业务已执行。
  5. 定义事务、并发冲突、锁或版本、重试、重复投递、部分失败和取消;异步任务补租约、超时、失败队列、重放与结果通知。
  6. 权限包含主体、资源、动作与数据范围,同时说明合法用户如何取得前置并完成操作。
  7. 外部依赖定义超时、有限重试、失败边界、限流和观测;内部投影不能当作外部送达证据。
  8. 启动核查配置、秘密及依赖,禁止无提示启用测试模式或用占位结果冒充实际服务。
  9. 健康检查区分进程存活、依赖就绪和核心业务可用;日志与审计记录来源和结果,保护敏感内容。
  10. Schema 演进包含数据保护、兼容、迁移、对账及恢复,沿用项目工具校验有效语法。

参考 后端规范。Agent 内部编排由 S005-3 设计,后端明确可调用能力与授权边界。

验收与交接

写操作验收包含合法调用、服务端变化、重新读取和后续业务结果;拒绝路径单独测试。只读接口验证数据来源、范围与权限。注册数量、返回码或单表 CRUD 不自动代表完整模块。

向 Agent 与前端提供实际接口、身份字段、版本、时序、错误与恢复要求;向 S009/S010 提供成功和拒绝检查。跨层任务使用 交付记录,接口格式通过与业务验收分别记录。

Haonan S005-2 后端 LLD · 原理图

查看原图
Haonan S005-2 后端 LLD 原理图

CONTACT HAONAN

联系haonan

医疗 AI · 产品与独立开发

刘浩南

关注医疗 AI 从 demo 到真实落地,聚焦产品化、商业化与院内工作流效率提升。

12年医疗产研经验,大湾区头部医疗AI公司前产品总监,独立开发者

医疗 AI 产品化医疗 AI 商业化院内工作流效率
刘浩南的微信联系二维码
微信扫一扫,联系 haonan