# 功能文档解析报告: <功能名称>

> 输入文件:
> - 功能文档: <*.md 文件路径>
> - 流程图: <*.drawio 文件路径>（如有）
> - 原型: <*.html 文件路径>（如有）
> 解析日期: <日期>

---

## 1. 子模块清单

| 编号 | 模块名称 | 类型 | 新建/修改 | 简述 |
|:----:|----------|------|:---------:|------|
| M-01 | | 新建CRUD / 修改已有 / 外部接口 / 记录表 | 新建 / 修改 | |
| M-02 | | | | |

> 如仅一个模块，此表只有一行。

---

## 2. 各模块解析详情

### M-01: <模块名称>

#### 2.1 功能简介

| 项目 | 值 |
|------|-----|
| 菜单路径 | |
| 应用设备 | |
| 使用人员 | |
| 功能描述 | |

#### 2.2 数据表

##### 表: <table_name>

| 字段名 | 中文名 | 原始类型 | 长度 | 主键 | 非空 | 默认值 | 说明 | Java 类型 | 适配说明 |
|--------|--------|----------|------|:----:|:----:|--------|------|-----------|----------|
| id | 主键 | BIGINT | - | ✅ | ✅ | - | | Long | → NUMBER(19) 雪花算法 |
| | | | | | | | | | |

**适配变更**（功能文档 DDL → MES Oracle 规范）：
- <列出所有需要适配的项>

**审计字段**（自动补充）：
- created_by VARCHAR2(64)
- created_date DATE DEFAULT SYSDATE
- last_updated_by VARCHAR2(64)
- last_updated_date DATE DEFAULT SYSDATE

##### 子表: <detail_table_name>（如有）

| 字段名 | 中文名 | 原始类型 | 长度 | 主键 | 非空 | 说明 | Java 类型 |
|--------|--------|----------|------|:----:|:----:|------|-----------|
| | | | | | | | |

**外键字段**: <关联主表的字段>

#### 2.3 操作/按钮

| 按钮 | 类型 | 对应接口 | 说明 |
|------|------|----------|------|
| 新增 | CRUD | POST /add | |
| 编辑 | CRUD | PUT /update | |
| 查看 | CRUD | GET /get/{id} | |
| 删除 | CRUD | DELETE /delete | |
| 导入 | 导入 | POST /uploadExcel | 模板: xxx |
| 导出 | 导出 | POST /export | |

#### 2.4 业务逻辑

##### 校验规则

| 编号 | 校验项 | 规则 | 错误提示 |
|:----:|--------|------|----------|
| V-01 | | | |

##### 特殊逻辑

1. <逻辑描述>
2. <逻辑描述>

##### 导入逻辑（如有）

- 模板格式: <描述>
- 校验规则: <列出>
- 事务控制: 整批回滚 / 逐行处理

##### 状态流转（如有）

```
<状态机 ASCII 图>
```

#### 2.5 外部接口（如有）

| 接口名 | 方法 | 路径 | 调用方 | 描述 |
|--------|------|------|--------|------|
| | | | | |

##### 接口详情

**<接口名>**

请求:
```json
{}
```

响应:
```json
{}
```

业务逻辑:
1. <步骤>

#### 2.6 流程图摘要

从 *.drawio 提取的关键流程:

```
<ASCII 流程图>
```

---

<!-- 重复以上结构，为每个子模块 M-02, M-03... 生成 -->

---

## 3. 依赖关系图

```
M-01 (新建CRUD)
    │
    ├──→ M-02 (修改已有，依赖 M-01 的数据)
    │
    └──→ M-03 (外部接口，读取 M-01 + M-02 的数据)
```

| 依赖 | 源模块 | 目标模块 | 类型 | 说明 |
|------|--------|----------|------|------|
| D-01 | M-01 | M-02 | 数据依赖 | M-02 读取 M-01 的表 |
| D-02 | M-01 | M-03 | 功能依赖 | M-03 调用 M-01 的 Service |

---

## 4. 疑问点

| 编号 | 类型 | 描述 | 建议 |
|:----:|------|------|------|
| Q-01 | 字段疑问 / 逻辑疑问 / 依赖疑问 | | |

---

## 5. 统计

| 维度 | 数量 |
|------|:----:|
| 子模块数 | |
| 新建表数 | |
| 修改表数 | |
| API 接口数 | |
| 外部接口数 | |
| 校验规则数 | |