用途:当需要在 Helpline 的 services/api 目录下新增或变更一条 HTTP 路由时启用,按项目网关约定逐步操作。
主要能力与流程: 一、在对应模块中编写处理器,票务相关路由放在 tickets.py,新的名词则新建模块;处理器签名为 (request: dict) -> dict。 二、先做输入校验,缺失或非法输入应抛出 ValidationError,不要手工返回错误字典。 三、处理器内不写业务逻辑,改为调用 packages/db 的 repo 或其他服务,处理器只负责编排与组织响应。 四、在 routes.py 的 build_app() 中用 app.route("METHOD /path", handler) 注册路由,未在此注册的路由不存在。 五、在 tests/ 中新增测试,构建应用并派发该路由进行验证。
参考:完整清单与示例见 references/route-checklist.md。
限制:资料未提供更多错误处理、认证、版本控制或部署细节,实际项目依赖结构请以仓库代码为准。