# 松江农民土地退养补助金发放管理服务（目录 `sj_nmtybt_server`）

Spring Boot 业务接口层，对齐 **《流程图260804》**，对接 DMS（`sjnmtybt_*`）与 OAuth，提供 Swagger 文档。

## 环境

- JDK 8+
- Maven 3.6+

## 启动

```bash
mvn -DskipTests spring-boot:run
```

- 服务：http://localhost:8088/sjnmtybt
- Swagger：http://localhost:8088/sjnmtybt/swagger-ui.html
- 本地默认 `sjnmtybt.auth.enabled=false` 可免 Token；正式环境需请求头 `Token`

## 文档

| 文档 | 说明 |
|------|------|
| **[docs/README.md](docs/README.md)** | 文档索引 + 近期业务约定 |
| [docs/api-business-flow-guide.md](docs/api-business-flow-guide.md) | 接口调用指南（主文档） |
| [docs/flow-260804.md](docs/flow-260804.md) | 流程图角色与泳道 |
| [docs/dms-model-migration-2026-08-04.md](docs/dms-model-migration-2026-08-04.md) | DMS 模型 |
| [docs/dms-mock-data.md](docs/dms-mock-data.md) | Mock 数据 |

## 流程图泳道与接口 Tag

| 泳道 | 说明 | 主要 Tag |
|------|------|----------|
| 月度补助金申请 | 录入→村批选人提交→经发初审→居保→清单→领导审批→对照文件→线下→回盘 | 03/04/05/07/08 |
| 特殊业务申请 | 死亡预警、暂停恢复、**调标差额补发**、补发类 | 06、11 |
| 回盘信息更新 | 回盘确认、失败告警、**待补发台账**、统计归档 | 08、08b、09 |
| 监管 / 附件 | 看板、区划统计；本地附件上传 | 12、13 |

流程定义：`GET /api/workflow/roles|lanes|stages|special-biz-nodes`

## DMS 栏目

| tag | 说明 |
|-----|------|
| `sjnmtybt_ryjbxx` | 人员表 |
| `sjnmtybt_pcb` | 批次表（清单头） |
| `sjnmtybt_ffmx` | 发放明细 |
| `sjnmtybt_pctj` | 批次统计 |
| `sjnmtybt_lcb` | 流程跟踪（含特殊业务单、待补发台账） |
| `sjnmtybt_jebz` | 金额标准 |
| `sjnmtybt_xzqh` | 行政区划 |
| `sjnmtybt_alart` | 告警表 |