# backend/catalog Specification

## Purpose
定义服务机构端服务目录四层（L1–L4）与属地配置、业务字典的后端行为——按属地加载目录、机构不可改目录、国家新增项显式提示。

## Requirements

### Requirement: 属地目录加载
后端 MUST 按机构 `loc_code` 加载对应目录：昆明加载本地 45 项，新建制州市加载国家 36 项。

#### Scenario: 昆明机构加载
- **WHEN** 昆明机构请求目录
- **THEN** 返回本地 45 项（系统内置 L3 映射）

### Requirement: 机构不可改目录
机构 MUST 只能对 L4 勾选 + 配价（改 `is_enabled`/`price`），不可新增/修改 L1–L3 目录。

#### Scenario: 机构改目录被拒
- **WHEN** 机构尝试新增或修改目录项
- **THEN** 返回 403

### Requirement: 国家新增项显式提示
国家目录有而昆明本地目录没有的 5 项 MUST 在昆明机构勾选界面显式列出并标注「过渡期新增·建议纳入」。

#### Scenario: 昆明机构看到新增项
- **WHEN** 昆明机构请求可勾选项
- **THEN** 返回国家新增 5 项并标记 is_new_national

### Requirement: 属地配置驱动
新增州市 MUST 仅需插入 `loc_config` + `svc_local` 数据即生效，不改代码。

#### Scenario: 新增州市零代码
- **WHEN** 插入某新州市的 loc_config 与 svc_local
- **THEN** 该州市机构登录即加载新目录，无需发版