Files
baiyue-firstleg/print/AGENTS.md
T
2026-07-31 11:06:36 +08:00

22 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Print Service 模块指引
## 职责边界
- 本模块定义打印中心独立服务边界;当前只包含应用入口、状态接口、配置和数据库骨架。
- 打印模板版本、任务状态机、PDF/标签生成、重试和幂等尚未完整实现;开始扩展前必须先核对阶段需求,不从原型自动扩大范围。
## 快速索引
| 功能 | 入口 |
|---|---|
| 应用入口 | `src/main/java/com/baiyue/print/PrintServiceApplication.java` |
| 当前状态 API | `controller/PrintHealthController.java`(`/api/platform/v1/print/status`) |
| 数据库骨架 | `src/main/resources/db/print.sql` |
| 本地/Nacos 配置 | `src/main/resources/application.yml`、`../config/nacos/{local,cn}/print-service.yml` |
## 修改与验证
- 订单服务只应提交打印请求,不自行生成面单或操作打印机;生成文件通过 File 服务引用。
- 新增任务处理时设计明确的状态机、幂等键、失败重试、模板版本与权限边界。
- 当前无专属测试时,不为小改动引入整套新测试框架;至少从父目录运行 `mvn -pl print -am test` 并记录接口验证。