# 后端模块开发指南

从广州广告监管系统（OARMS）各模块开发中提炼的完整流程、约定和踩坑记录。
适用于所有新模块（AM / BS / CW / LB / MR）的后端开发。

**开发模式**：将 mock 数据插入到数据库中，不使用 mock 数据，直连达梦 DM8 数据库读写，所有接口面向生产环境数据。

---

# A. 运行环境

## A1. 技术栈

| 组件 | 版本 | 说明 |
|------|------|------|
| JDK | 21 | `JAVA_HOME="/d/Program Files/Java/jdk-21.0.11+10"` |
| Spring Boot | 3.4.5 | + youfool-framework-springboot3 1.0.4（公司内部框架） |
| MyBatis-Plus | - | ORM，分页插件配置在 `mybatis/mybatis-config.xml` |
| Sa-Token | - | 认证鉴权，拦截规则在 `SpringMvcConfig` |
| dynamic-datasource | baomidou | 多数据源切换 |
| Knife4j | - | API 文档，路径 `/doc.html` |
| Druid | - | 连接池 + 监控，路径 `/druid` |

## A2. 数据源

项目使用苞米豆动态数据源，**两个数据源**：

| 数据源 | 用途 | 数据库名 |
|--------|------|----------|
| `master`（primary） | 业务库 | OARMS |
| `youfool` | 框架库（restLog 等） | YOUFOOL |

实体类注解：`@DS("master")` + `@TableName(schema = "OARMS", value = "表名")`

## A3. 数据库连接信息（达梦 DM8）

```
JDBC URL:  jdbc:dm://172.22.80.70:15236?schema=OARMS
用户名:    SYSDBA
密码:      chinaweal
驱动类:    dm.jdbc.driver.DmDriver
驱动 JAR:  target/libs/DmJdbcDriver18-8.1.3.62.jar
```

## A4. Maven 配置

- **Maven 路径**：`/d/apache-maven-3.9.15/bin/mvn`
- **settings.xml**：`/d/apache-maven-3.9.15/conf/settings.xml`
- **本地仓库**：`D:/maven-repository`
- **Profile**：`-Pcompany-nexus`（公司私有仓库 `http://121.8.152.130:8081/nexus/content/groups/public/`）

## A5. 应用配置

- **默认端口**：8080，环境变量 `PRJ_PORT` 可覆盖
- **环境切换**：`spring.profiles.active` 设为 `dev` 或 `prod`
- **Mapper 扫描**：`com.chinaweal.youfool.prj.**.mapper`（新模块 mapper 放在此包下自动注册）
- **XML 加载**：`classpath*:mybatis/mapper/**/*.xml`

## A6. 认证鉴权

- Sa-Token 拦截器注册在 `SpringMvcConfig`，默认所有路径需登录
- 白名单（免登录）：`/user/auth/**`、`/test/**`、`/doc.html**`、`/cms/index.html` 等

---

# B. 工具

## B1. 编译命令

```bash
# 开发阶段编译（跳过 checkstyle）
JAVA_HOME="/d/Program Files/Java/jdk-21.0.11+10" \
  /d/apache-maven-3.9.15/bin/mvn compile -Pcompany-nexus -Dcheckstyle.skip=true

# 完整编译（含 checkstyle）
JAVA_HOME="/d/Program Files/Java/jdk-21.0.11+10" \
  /d/apache-maven-3.9.15/bin/mvn compile -Pcompany-nexus
```

强制重新编译指定模块（跳过 clean）：

```bash
rm -rf target/classes/com/chinaweal/youfool/prj/modules/{module-name}/
JAVA_HOME="/d/Program Files/Java/jdk-21.0.11+10" \
  /d/apache-maven-3.9.15/bin/mvn compile -Pcompany-nexus -Dcheckstyle.skip=true
```

## B2. 数据库执行工具：Python + JayDeBeApi

用于执行 DDL 和初始数据到 DM8：

```python
import jaydebeapi

conn = jaydebeapi.connect(
    'dm.jdbc.driver.DmDriver',
    'jdbc:dm://172.22.80.70:15236?schema=OARMS',
    ['SYSDBA', 'chinaweal'],
    'target/libs/DmJdbcDriver18-8.1.3.62.jar'
)
cursor = conn.cursor()

# CREATE TABLE（小写表名 OK，DM8 自动转大写）
cursor.execute("CREATE TABLE OARMS.xxx (...)")

# COMMENT / INDEX（必须大写表名列名）
cursor.execute("COMMENT ON TABLE OARMS.XXX IS '注释'")
cursor.execute("CREATE INDEX IDX_XXX_COL ON OARMS.XXX (COL)")

# INSERT（列名小写 OK）
cursor.execute("INSERT INTO OARMS.xxx (...) VALUES (...)")

conn.commit()

# 验证
cursor.execute("SELECT COUNT(*) FROM OARMS.XXX")
print(cursor.fetchone()[0])

cursor.close()
conn.close()
```

## B3. SQL 版本号分配

DDL 文件统一放在 `docs/db/sql/`，命名规则 `V{版本号}__{模块描述}_{ddl|init_data}.sql`。

| 版本 | 用途 | 文件 |
|------|------|------|
| V1.0.0 | BS 大屏基础信息管理 | `V1.0.0__BS_screen_ddl.sql` + `_init_data.sql` |
| V2.0.0 | LB 法律法规管理 | `V2.0.0__LB_law_ddl.sql` + `_init_data.sql` |
| V3.0.0 | AM-1 广告画面录屏设置管理 | `V3.0.0__AM_recording_config_ddl.sql` |
| V4.0.0 | AM-2 广告画面随机录屏 | `V4.0.0__AM_recording_task_ddl.sql` |
| V5.0.0 | AM-3 广告画面监控 | `V5.0.0__AM_monitor_record_ddl.sql` |
| V6.0.0 | MR-1 监测规则管理 | `V6.0.0__MR_monitoring_rule_ddl.sql` + `_init_data.sql` |
| V7.0.0 | CW-1 广告监测固化取证 | `V7.0.0__CW_evidence_ddl.sql` |
| V8.0.0 | CW-2 监测规则关联 | `V8.0.0__CW_evidence_rule_relation_ddl.sql` |
| V9.0.0 | CW-3 监测线索生成 | `V9.0.0__CW_monitoring_clue_ddl.sql` |
| V10.0.0 | CW-4 对接线索转办 | `V10.0.0__CW_clue_transfer_ddl.sql` |

---

# C. 记忆

> 开发每个模块时必须遵循的模式、约定和模板。直接复制使用，不要重新设计。

## C1. 表前缀约定

| 业务域 | 前缀 | Java 包名 |
|--------|------|-----------|
| 大屏基础库 | `bs_` | screen |
| 法律法规库 | `lb_` | law |
| 广告监控 | `am_` | monitor |
| 监测规则库 | `mr_` | rule |
| 内容预警 | `cw_` | evidence |

## C2. DM8 类型 → Java 映射

| DM8 类型 | Java 类型 | 场景 |
|----------|-----------|------|
| `VARCHAR(50)` | `String` | 主键 ID（ASSIGN_UUID） |
| `VARCHAR(20~200)` | `String` | 名称、编码 |
| `VARCHAR(500~1000)` | `String` | 描述、地址 |
| `CLOB` | `String` | 大文本、JSON（规则配置、快照） |
| `TINYINT` | `Boolean` 或 `Integer` | 0/1 标志位 |
| `DECIMAL(10,6)` | `BigDecimal` | 经纬度（精度 ≤ 38） |
| `INT` | `Integer` | 数量、排序号 |
| `DATE` | `LocalDate` | 仅日期 |
| `TIMESTAMP` | `LocalDateTime` | 日期 + 时间 |

## C3. 包结构模板

```
modules/{module-name}/
├── entity/
│   ├── {MainEntity}.java
│   ├── {SubEntity}.java
│   ├── query/
│   │   └── {Entity}Query.java         # 分页 + 筛选
│   ├── req/
│   │   ├── {Entity}SaveReq.java       # 新增/修改
│   │   └── {Action}Req.java           # 特殊操作
│   └── vo/
│       └── {Entity}DetailVO.java      # 详情聚合
├── mapper/
│   └── {Entity}Mapper.java
├── service/
│   ├── I{Entity}Service.java
│   └── impl/
│       └── {Entity}ServiceImpl.java
└── controller/
    └── {Entity}Controller.java
```

## C4. Entity 模板

```java
@Data
@EqualsAndHashCode(callSuper = true)
@Accessors(chain = true)
@DS("master")
@TableName(schema = "OARMS", value = "bs_screen")
public class ScreenEntity extends SuperEntity {
    private static final long serialVersionUID = 1L;

    @TableId(value = "id", type = IdType.ASSIGN_UUID)
    private String id;

    @TableField("screen_name")
    private String screenName;
}
```

- `SuperEntity` 提供 6 个审计字段（createBy/createTime/createName/updateBy/updateTime/updateName），**不含 id**
- 日期字段加 `@JsonFormat(pattern = DateUtil.DATE_DEFAULT_FORMAT, timezone = "GMT+8")`
- 日期时间字段加 `@JsonFormat(pattern = DateUtil.DATETIME_DEFAULT_FORMAT, timezone = "GMT+8")`

## C5. Controller 模板

```java
@Slf4j
@RestController
@RequestMapping("/api/{resource-path}")
@AllArgsConstructor
@Tag(name = "模块名称", description = "模块描述")
public class XxxController {
    private final IXxxService xxxService;

    @PostMapping("/query")
    @Operation(summary = "分页查询")
    public RestResult<IPage<Xxx>> queryList(@RequestBody XxxQuery query) {
        log.info("[OK] 查询列表: key={}", query.getKey());
        return RestResult.ok(xxxService.queryList(query));
    }

    @GetMapping("/detail")
    @Operation(summary = "查询详情")
    public RestResult<XxxDetailVO> getDetail(@RequestParam String id) {
        log.info("[OK] 查询详情: id={}", id);
        return RestResult.ok(xxxService.getDetail(id));
    }

    @PostMapping("/save")
    @Operation(summary = "新增")
    public RestResult<String> save(@RequestBody XxxSaveReq req) {
        return RestResult.ok(xxxService.save(req));
    }

    @PostMapping("/update")
    @Operation(summary = "修改")
    public RestResult<Void> update(@RequestBody XxxSaveReq req) {
        xxxService.update(req);
        return RestResult.ok();
    }

    @PostMapping("/remove")
    @Operation(summary = "删除")
    public RestResult<Void> remove(@RequestBody Map<String, String> params) {
        xxxService.remove(params.get("id"));
        return RestResult.ok();
    }

    @GetMapping("/xxx/list")
    @Operation(summary = "选项列表")
    public RestResult<List<Map<String, String>>> listXxxOptions() {
        return RestResult.ok(xxxService.getXxxOptions());
    }
}
```

- DI：`@AllArgsConstructor` + `private final`
- 返回值：`RestResult.ok(data)` / `RestResult.ok()`
- 日志：`log.info("[OK] 操作描述: key={}", value)`
- 删除用 `Map<String, String>` 接收 id
- 选项接口返回 `List<Map<String, String>>`（label + value）

## C6. Service 模板

```java
@Slf4j
@Service
public class XxxServiceImpl extends ServiceImpl<XxxMapper, XxxEntity>
        implements IXxxService {

    @Override
    public IPage<XxxEntity> queryList(XxxQuery query) {
        Page<XxxEntity> page = new Page<>(query.getPageNum(), query.getPageSize());
        QueryWrapper<XxxEntity> wrapper = Wrappers.query();
        if (query.getName() != null && !query.getName().isEmpty()) {
            wrapper.like("name", query.getName());
        }
        wrapper.orderByAsc("name");
        return baseMapper.selectPage(page, wrapper);
    }

    @Override
    @DSTransactional
    public String save(XxxSaveReq req) {
        XxxEntity entity = new XxxEntity();
        BeanUtils.copyProperties(req, entity, "id");
        save(entity);
        return entity.getId();
    }
}
```

- **事务必须用 `@DSTransactional`**
- `BeanUtils.copyProperties(req, entity, "id")` 第三个参数忽略 id
- 分页用 `new Page<>(pageNum, pageSize)`
- 查询用 `QueryWrapper` 或 `LambdaQueryWrapper`

## C7. Mapper 模板

```java
@Mapper
public interface XxxMapper extends BaseMapper<XxxEntity> {
}
```

无需 XML，MyBatis-Plus 自动提供 CRUD。新模块 mapper 放在 `com.chinaweal.youfool.prj.**.mapper` 包下自动注册。

## C8. Query 模板

```java
@Data
@Accessors(chain = true)
@Schema(description = "Xxx查询参数")
public class XxxQuery implements Serializable {
    private static final long serialVersionUID = 1L;

    @Schema(description = "页码")
    private Integer pageNum = 1;

    @Schema(description = "每页条数")
    private Integer pageSize = 10;

    @Schema(description = "排序字段")
    private List<String> orderFields;

    @Schema(description = "排序规则")
    private List<String> orderSorts;

    // ... 筛选条件
}
```

## C9. 对象映射选择

| 方面 | MapStruct | BeanUtils |
|------|-----------|-----------|
| 依赖 | 需要 `convert/` 接口 | Spring 自带 |
| 编译警告 | unmapped properties 警告 | 无 |
| 适用场景 | 字段多、映射复杂 | 字段少、映射简单 |
| **建议** | 已有模块保持 | **新模块推荐 BeanUtils**，减少样板代码 |

## C10. 初始数据约定

> 系统运行必需的种子数据（码表、默认规则等），不是 mock 测试数据。
> 文件仅用于首次部署时初始化，后续数据通过 API 接口维护。

- **文件命名**：`V{版本号}__{模块描述}_init_data.sql`
- **ID 命名**：`{模块缩写}-{实体缩写}-{序号}`，如 `MR-RULE-001`、`CW-EVI-001`
- **审计字段默认值**：
  - `create_time` / `update_time`：`TO_TIMESTAMP('2026-05-18 10:00:00', 'YYYY-MM-DD HH24:MI:SS')`
  - `create_by` / `update_by`：`'system'`
  - `create_name` / `update_name`：`'系统管理员'`
- **数据原则**：贴近真实业务场景，数量以覆盖主要业务分支为准
- **标记字段**：`is_initial_data = 1` 标记初始数据，用户通过 API 创建的数据为 `0`

---

# D. 评估

> 每个模块开发完成后必须执行的验证步骤。

## D1. 编译验证

```bash
# 1. 删除目标模块编译产物（确保强制重编译）
rm -rf target/classes/com/chinaweal/youfool/prj/modules/{module-name}/

# 2. 编译
JAVA_HOME="/d/Program Files/Java/jdk-21.0.11+10" \
  /d/apache-maven-3.9.15/bin/mvn compile -Pcompany-nexus -Dcheckstyle.skip=true

# 3. 确认输出 BUILD SUCCESS
```

## D2. 数据库验证

```python
# 通过 Python + JayDeBeApi 连接后执行
cursor.execute("SELECT TABLE_NAME FROM ALL_TABLES WHERE OWNER='OARMS' AND TABLE_NAME LIKE '{PREFIX}%'")
# 确认表已创建

cursor.execute("SELECT COUNT(*) FROM OARMS.{TABLE_NAME}")
# 确认初始数据行数符合预期
```

## D3. 模块完成检查清单

- [ ] DDL 文件已创建（`docs/db/sql/V*__*_ddl.sql`）
- [ ] DDL 已执行到 DM8 数据库，表和索引存在
- [ ] 初始数据文件已创建（`docs/db/sql/V*__*_init_data.sql`，如需要）
- [ ] 初始数据已插入数据库，行数正确
- [ ] Entity / Query / Req / VO 类已创建，继承 SuperEntity
- [ ] Mapper 接口已创建，继承 BaseMapper
- [ ] Service 接口 + ServiceImpl 已创建，事务用 `@DSTransactional`
- [ ] Controller 已创建，API 路径和参数与前端 s4 文档一致
- [ ] `mvn compile` BUILD SUCCESS，无编译错误（warnings 可忽略）
- [ ] 启动应用，Knife4j 文档可访问（`/doc.html`），新接口可见
- [ ] 通过 API 接口能正常读写数据库数据

---

# E. 边界

> 必须遵守的约束和必须避免的错误。违反这些会导致编译失败或运行时异常。

## E1. 数据库禁忌

| 禁忌 | 后果 | 正确做法 |
|------|------|----------|
| COMMENT ON / CREATE INDEX 用小写表名 | 报"无效的表或视图" | **必须用大写**：`OARMS.BS_SCREEN` |
| `DECIMAL(100,0)` 等精度 > 38 | DM8 精度溢出错误 | 改用 `TINYINT` 或 `INT` |
| 用 `split(';')` 解析 SQL 文件执行 | 注释或 CLOB 中的 `;` 导致语句截断 | 按 SQL 语句逐条在 Python 中硬编码执行 |
| 连接串不带 `?schema=OARMS` | 连接成功但操作错误的 schema | URL 必须包含 `?schema=OARMS` |
| 用 `OARMS` / `OARMS@2026` 作为用户名密码 | 连接失败 | 用户名 `SYSDBA`，密码 `chinaweal` |

## E2. 代码禁忌

| 禁忌 | 后果 | 正确做法 |
|------|------|----------|
| 使用 `@Transactional` | 多数据源事务不生效 | **必须用 `@DSTransactional`** |
| 实体类不加 `@DS("master")` | 默认走 youfool 数据源 | 所有业务实体加 `@DS("master")` |
| 实体类不加 `schema = "OARMS"` | MyBatis-Plus 找不到表 | `@TableName(schema = "OARMS", value = "表名")` |
| 主键不加 `@TableId` | MyBatis-Plus 无法识别主键 | `@TableId(value = "id", type = IdType.ASSIGN_UUID)` |
| SuperEntity 已有 id 字段 | 重复字段编译错误 | SuperEntity **不含 id**，各实体自行定义 |

## E3. 编译陷阱

| 问题 | 原因 | 解决方案 |
|------|------|----------|
| `mvn clean compile` 报 `Failed to delete target/xxx.jar` | JAR 被运行中的 Java 进程锁定 | 先停应用，或用 `mvn compile`（跳过 clean） |
| 编译输出 `Nothing to compile` | target 中已有旧 class | 先删除对应模块的 class 目录 |
| MapStruct unmapped warnings | SuperEntity 审计字段未映射 | 正常现象，不影响编译 |
| unchecked warnings | JSON 反序列化泛型操作 | 正常现象，不影响编译 |

---

# F. Harness Engineering

> 从需求到上线的完整开发管线、模块进度和任务规划。

## F1. 全流程

```
信息收集 → 设计建表 → DDL 脚本 → 初始数据 → Java 代码 → 执行建表 → 插入初始数据 → 编译验证 → 接口联调
```

### Step 1: 信息收集（并行读取）

| 输入 | 路径 | 用途 |
|------|------|------|
| 需求文档 s1 | `gz-oarms-web/docs/prd-llm/{域}*/{模块}*/s1-需求分析.md` | 理解业务背景、角色、流程 |
| 实体定义 s2 | `gz-oarms-web/docs/prd-llm/{域}*/{模块}*/s2-实体定义.md` | **DDL 和 Entity 的主要来源** |
| API 设计 s4 | `gz-oarms-web/docs/prd-llm/{域}*/{模块}*/s4-api-design.md` | Controller 接口定义 |
| 编码任务 s4 | `gz-oarms-web/docs/prd-llm/{域}*/{模块}*/s4-编码任务.md` | 页面和 API 总览 |
| 本开发指南 | `docs/backend-module-dev-guide.md` | 代码风格和流程规范 |
| 全局实体字典 | `gz-oarms-web/docs/prd-llm/DM-全局数据模型/全局实体字典.md` | 核心实体跨域引用 |

**操作建议**：并行读取 s1 + s2 + s4(api) + s4(编码任务)，不要串行。

### Step 2: 设计建表

根据 s2 实体定义，产出 DDL 脚本（参见 C 记忆部分的模板和类型映射）。

### Step 3: 准备初始数据

系统运行必需的种子数据（码表、默认配置、示例业务数据），参见 C10 初始数据约定。
不是所有模块都需要初始数据文件——部分模块的表由 API 接口填充。

### Step 4: 生成 Java 代码

按 C3 包结构模板，依次生成：
```
Entity → Query/Req/VO → Mapper → Service(接口+实现) → Controller
```

### Step 5: 执行建表 + 插入初始数据

使用 B2 数据库执行工具，按 D1/D2 评估步骤验证。

### Step 6: 编译验证

执行 D3 检查清单。

### Step 7: 接口联调

启动应用，通过 Knife4j（`/doc.html`）或前端页面验证 API 接口能正常读写数据库。

## F2. 模块开发进度总表

> 状态标记：✅ 已完成 | 🔨 部分完成 | ⏳ 待开发

### 大屏基础库域（BS）

| 模块 | 功能 | DDL | 初始数据 | Java 代码 | 编译 | 备注 |
|------|------|:---:|:----:|:---------:|:----:|------|
| BS-1 大屏基础信息管理 | 大屏 CRUD + 地图 + 导出 | ✅ | ✅ 8条 | ✅ | ⏳ | 核心实体 SCREEN |

### 法律法规库域（LB）

| 模块 | 功能 | DDL | 初始数据 | Java 代码 | 编译 | 备注 |
|------|------|:---:|:----:|:---------:|:----:|------|
| LB-1 法律法规管理 | 法律法规 CRUD | ✅ | ✅ 5条 | ✅ | ⏳ | |

### 广告监控域（AM）

| 模块 | 功能 | DDL | 初始数据 | Java 代码 | 编译 | 备注 |
|------|------|:---:|:----:|:---------:|:----:|------|
| AM-1 广告画面录屏设置管理 | 录屏配置 CRUD | ✅ | - | ✅ | ⏳ | |
| AM-2 广告画面随机录屏 | 录屏任务管理 | ✅ | - | ✅ | ⏳ | |
| AM-3 广告画面监控 | 监控审核记录 | ✅ | - | ✅ | ⏳ | |

### 监测规则库域（MR）

| 模块 | 功能 | DDL | 初始数据 | Java 代码 | 编译 | 备注 |
|------|------|:---:|:----:|:---------:|:----:|------|
| MR-1 监测规则管理 | 监测规则/法律条款 CRUD | ✅ | ✅ 3+3+3条 | ✅ | ⏳ | 核心实体 MONITORING_RULE |

### 内容预警域（CW）

| 模块 | 功能 | DDL | 初始数据 | Java 代码 | 编译 | 备注 |
|------|------|:---:|:----:|:---------:|:----:|------|
| CW-1 广告监测固化取证 | 取证记录管理 | ✅ | - | ✅ | ⏳ | 核心实体 EVIDENCE_RECORD |
| CW-2 监测规则关联 | 证据-规则多对多 | ✅ | - | ✅ | ⏳ | |
| CW-3 监测线索生成 | 线索生成与管理 | ✅ | - | ✅ | ⏳ | |
| CW-4 对接线索转办 | 线索推送转办 | ✅ | - | ✅ | ⏳ | |

## F3. 核心实体跨域依赖

```
SCREEN (BS-1) ──── 被引用于 ──── AM-1/2/3（录屏配置/任务/监控）
                                CW-1（取证关联大屏）

MONITORING_RULE (MR-1) ──── 被引用于 ──── CW-2（证据规则关联）
                                      CW-3（线索生成依据）

EVIDENCE_RECORD (CW-1) ──── 被引用于 ──── CW-2（规则关联）
                                      CW-3（线索来源）
                                      CW-4（转办依据）
```

**开发建议**：先开发 BS-1（大屏）和 MR-1（规则），这两个是核心实体，被多个下游模块依赖。

## F4. 待开发任务建议顺序

### P1: BS-1 大屏基础信息管理

- **需求文档**：`BS-大屏基础库域/BS-1_大屏基础信息管理/`
- **核心实体**：SCREEN（评分 0.956，全系统最高）
- **被依赖**：AM-1/2/3、CW-1 均关联大屏
- **工作量**：中（标准 CRUD + 地图 + 导出）

### P2: MR-1 监测规则管理

- **需求文档**：`MR-监测规则库域/MR-1_监测规则管理/`
- **核心实体**：MONITORING_RULE（评分 0.738）
- **被依赖**：CW-2（证据规则关联）、CW-3（线索生成）
- **工作量**：中（规则 + 法律条款 CRUD）

### P3: AM-1~3 广告监控（可并行）

- **需求文档**：`AM-广告监控域/AM-{1,2,3}_*/`
- **依赖**：BS-1（关联大屏）
- **工作量**：大（3 个子模块）

### P4: CW-1~4 内容预警（顺序开发）

- **需求文档**：`CW-内容预警域/CW-{1,2,3,4}_*/`
- **依赖**：BS-1（关联大屏）+ MR-1（关联规则）
- **工作量**：大（4 个子模块，建议 CW-1 → CW-2 → CW-3 → CW-4 顺序）

### P5: LB-1 法律法规管理

- **需求文档**：`LB-法律法规库域/LB-1_法律法规管理/`
- **依赖**：无强依赖，但 MR-1 会引用法律条款
- **工作量**：小（标准 CRUD）
- **建议**：可与 P1/P2 并行开发