添加快速索引文件

2026-07-31 11:06:36 +08:00
parent 71c5f2f3b5
commit 4cee256f22
20 changed files with 512 additions and 1 deletions
@@ -0,0 +1,21 @@
+# 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` 并记录接口验证。