baiyue-firstleg/print/AGENTS.md

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 并记录接口验证。