添加快速索引文件

firstleg/AGENTS.md

@@ -0,0 +1,26 @@
+# Firstleg Service 模块指引
+
+## 职责边界
+
+- 负责订单提交后的国内头程履约任务、操作分配和分配历史。
+- 订单主单、商户草稿和交易状态属于 `order/`；不要把订单模型复制进本服务。
+
+## 快速索引
+
+| 功能 | 入口 |
+|---|---|
+| 应用入口 | `src/main/java/com/baiyue/firstleg/BaiyueFirstlegApplication.java` |
+| 平台履约分配 API | `controller/PlatformFulfillmentAssignmentController.java`（`/api/platform/v1/first-leg/tasks`） |
+| 服务状态 | `controller/FirstlegHealthController.java` |
+| 分配请求 | `dto/AssignRequest.java` |
+| 履约与分配编排 | `service/FulfillmentTaskService.java` |
+| 任务与历史持久化 | `entity/`、`mapper/`、`repository/FulfillmentTaskRepository.java` |
+| 表结构 | `src/main/resources/db/firstleg.sql` |
+| 本地/Nacos 配置 | `src/main/resources/application.yml`、`../config/nacos/{local,cn}/firstleg-service.yml` |
+
+## 修改与验证
+
+- 任务状态与订单状态保持领域分离；需要联动时使用稳定 DTO 或事件，不共享 Order Entity 或数据库。
+- 分配操作要保留历史、操作者、时间和幂等语义；平台端接口必须执行权限校验。
+- 当前模块没有专属自动化测试时，不要为小改动擅自引入新框架；至少运行模块构建并记录接口验证。
+- 从父目录运行 `mvn -pl firstleg -am test`。