# 经侦案件智慧管理系统 — 全系统业务分析建模

> **文档定位**：全系统业务地图与业务模型（活文档）  
> **落点**：`Docs/Key/biz-model-system.md`  
> **变更记录**：`Docs/Key/biz-model-changelog.md`  
> **首版日期**：2026-07-22  
> **维护约定**：功能确认并实现完成后，同步更新本文对应章节；单功能细节仍写在 `docs/Plan/prd-*.md`

---

## 1. 系统定位与建设目标

### 1.1 定位

面向公安机关经侦业务的一体化办案支撑系统，覆盖「接警登记 → 审核定性 → 案件办理 → 资金/财物处置 → 卷宗归档 → 审议决策 → 数据展示」全链条。

### 1.2 建设目标

| 目标 | 说明 |
|------|------|
| 统一接报案入口 | 咨询求助、报案类、110 流转等多来源警情集中管理 |
| 规范审批链 | 作废、定性审核等关键动作有角色与组织层级约束 |
| 贯通办案后半程 | 案件、资金、财物、卷宗、审议形成业务闭环（当前多为前端壳，待后端落地） |
| 可运营可授权 | 门户八大模块 + 菜单功能点权限 + 超级管理员旁路 |

### 1.3 技术形态（业务视角）

| 层 | 说明 |
|----|------|
| 前端 | Vue3 + Ant Design Vue；门户 `/portal` → 一级模块 → 二级菜单页 |
| 后端 | Spring Boot（SmartAdmin）+ Sa-Token 权限 |
| 数据 | Kingbase/PostgreSQL；核心已落地表以 `t_alarm_*` 为主 |
| 工作流 | Warm-Flow 已集成（审议/请假等框架能力），经侦审议业务尚未深度绑定 |

---

## 2. 业务域总览（门户八大模块）

固定顺序来自 `economic-crime-web/src/constants/system/portal-const.js`：

| 序号 | 一级模块 | 一句话职责 | 成熟度 |
|------|----------|------------|--------|
| 1 | 接报案中心 | 警情登记、110 抽取流转、审核、作废、材料与监控 | **已落地（核心）** |
| 2 | 案件管理 | 案件监督、考评、两书一单、风险、涉企、领办 | **前端壳 + 模拟数据** |
| 3 | 涉案资金 | 冻结/扣押/返还资金台账与分析、金析为证 | **前端壳 + 模拟数据** |
| 4 | 涉案财物 | 涉案物品入库、估值、处置、返还 | **前端壳 + 模拟数据** |
| 5 | 卷宗管理 | 卷宗编号、归档、借出保管 | **已落地**（一级目录 + 6 子菜单） |
| 6 | 审议流程 | 一般审议、督办、意见流、审核组、流程定义 | **前端壳 + 模拟数据**（可借 Warm-Flow） |
| 7 | 数据大屏 | 综合态势可视化 | **前端展示壳（静态演示数据）** |
| 8 | 系统设置 | 组织人员、角色菜单、字典、文件等平台能力 | **框架已落地** |

```mermaid
flowchart LR
  A[接报案中心] --> B[案件管理]
  B --> C[涉案资金]
  B --> D[涉案财物]
  B --> E[卷宗管理]
  B --> F[审议流程]
  A --> G[数据大屏]
  H[系统设置] -.-> A & B & C & D & E & F & G
```

---

## 3. 角色与权限模型

### 3.1 平台级角色

| 角色编码 | 名称 | 职责 |
|----------|------|------|
| （`administrator_flag=1`） | 超级管理员（如 admin） | 拥有全部菜单与接口，旁路权限校验 |
| `JZ_ADMIN` | 经侦管理员 | 业务侧全模块授权（需 role_menu） |
| `JZ_USER` | 经侦用户 | 登记/查看等基础权限 |
| `JZ_AUDITOR` | 审核员 | 警情审核相关权限 |

### 3.2 接报案作废审批角色（业务专项）

| 角色编码 | 名称 | 职责 |
|----------|------|------|
| `alarm_city_receiver` | 市局接报案中心接警员 | 市局登记、编辑、发起作废 |
| `alarm_district_receiver` | 区县接报案分中心接警员 | 区县登记、编辑、发起作废 |
| `alarm_city_director` | 市局接报案中心主任 | 市局作废审核（演示：章成） |
| `alarm_district_captain` | 区县经侦大队大队长 | 区县作废审核 |

### 3.3 权限点约定

- **前端**：`v-privilege="'xxx:yyy'"` / `$privilege`
- **后端**：`@SaCheckPermission("xxx:yyy")`
- **菜单**：`t_menu.web_perms` / `api_perms`；`menu_type`：1 目录 / 2 页面 / 3 功能点
- **角色管理功能权限树**：`RoleMenuService.getRoleSelectedMenu` 全量加载 `t_menu`（`deleted_flag=0` 且 `disabled_flag=0`），含全部功能点；**仅 `t_menu` 中存在的权限可分配**
- **权限同步脚本**：`docs/20260805_sync_all_function_permissions.sql` 按前后端注解审计，补全接报案/案件/审议/财物/卷宗/流程/系统设置等模块缺失的 `menu_type=3` 记录；`web_perms` 全局唯一，已存在则跳过

### 3.4 接报案关键权限点

| 权限点 | 含义 | 典型入口 |
|--------|------|----------|
| `alarm:query` / `alarm:add` / `alarm:update` / `alarm:delete` / `alarm:detail` | 警情 CRUD / 详情 | 接报案大厅 |
| `alarm:audit` | 定性/受理审核 | 审核监督 |
| `alarm:void:apply` | 发起作废 | 接报案大厅 |
| `alarm:void:query` / `alarm:void:audit` | 作废待办查询 / 审批 | 作废审核 |
| `alarm-extract:*` | 110 抽取、分类、流转、回传 | 数据互通 |
| `evidence:*` / `suspect:*` | 证据 / 嫌疑人 | 大厅附属功能点 |
| `material:view` / `monitor:view` | 材料预览 / 视频监控 | 对应菜单 |

> **已知债（2026-08-05 已修）**：审核监督旧权限码 `alarm-audit:query/handle` 与前端 `alarm:audit:query/do`、后端 `alarm:query/audit` 不一致，导致审核组角色登录后按钮不可见、接口 403；见 `20260805_fix_alarm_audit_permission_codes.sql`。其余如详情 `alarm:view` vs `alarm:detail`、110 流转 `alarm-extract:transfer` vs `alarm:extract:transfer` 仍待逐步对齐。

---

## 4. 端到端主流程（跨模块）

### 4.1 当前真实贯通路径（已落地）

```mermaid
flowchart TD
  E110[数据互通: 110抽取] -->|流转| Hall[接报案大厅]
  Reg[本系统登记: 咨询求助/报案类] --> Hall
  Hall -->|报案类待审| Audit[审核监督]
  Hall -->|发起作废| Void[作废审核]
  Void -->|同意| Voided[已作废 不可操作]
  Void -->|不同意| Hall
  Audit -->|通过| Done[处置: 已审核完成]
  Hall --> Mat[材料预览]
```

### 4.2 规划中后半程（壳子，未真正贯通）

警情审核完成 → **案件管理**立卷办理 → **涉案资金/财物**处置 → **卷宗**归档 → **审议**重大事项 → **数据大屏**汇总。

> 说明：后半程目前多为页面原型 + 前端 mock，无对应经侦业务后端包。

---

## 5. 分域模型

---

### 5.1 接报案中心（已落地 · 核心）

#### 5.1.1 职责

统一受理与管理警情：登记、查询、编辑、证据、审核、作废、110 数据互通、材料预览、监控入口。

#### 5.1.2 菜单与页面

| 菜单 | 路径 | 组件 | 成熟度 |
|------|------|------|--------|
| 接报案大厅 | `/business/alarm/alarm-reception-list` | `alarm-reception-list.vue` | 已落地 |
| 数据互通 | `/business/alarm/alarm-extract-list` | `alarm-extract-list.vue` | **半成品**：查询/流转已接；抽取、分类、回传多为 TODO |
| 审核监督 | `/business/alarm/audit-list` | `audit-list.vue` | 已落地（三人审核组表决） |
| 作废审核 | `/business/alarm/void-audit-list` | `void-audit-list.vue` | 已落地（独立菜单） |
| 材料预览 | `/business/alarm/material-view` | `material-view.vue` | **半成品**：已接详情/证据只读 API，偏展示封装 |
| 视频监控 | `/business/alarm/center-monitor` | `center-monitor.vue` | **壳**：摄像头墙为 Mock，无真实监控 API |

#### 5.1.3 后端包与主 API

- 包：`.../module/business/alarm/`
- 控制器：`AlarmReportController`

| 接口 | 权限 | 说明 |
|------|------|------|
| `POST /alarm-report/query` | `alarm:query` | 分页列表 |
| `POST /alarm-report/add` | `alarm:add` | 新增登记 |
| `POST /alarm-report/update` | `alarm:update` | 更新 |
| `GET /alarm-report/delete/{id}` | `alarm:delete` | 删除 |
| `GET /alarm-report/detail/{id}` | `alarm:detail` | 详情（含子表） |
| `POST /alarm-report/audit` | `alarm:audit` | 审核组表决（agree/disagree/return_refill） |
| `GET /alarm-report/audit/votes/{alarmId}` | `alarm:audit` | 三人票况面板 |
| `POST /alarm-report/void/apply` | `alarm:void:apply` | 发起作废 |
| `POST /alarm-report/void/pending-query` | `alarm:void:audit` | 作废待办 |
| `POST /alarm-report/void/audit` | `alarm:void:audit` | 作废审批 |
| `GET/POST .../history-*` | `alarm:query` | 重复报警历史 |
| 证据相关 | `evidence:*` | 证据材料 CRUD |
| 流转 `transfer` / 批量流转 | `alarm-extract:transfer` 等 | 110 → 大厅 |

#### 5.1.4 核心业务对象

| 对象 | 表 / Entity | 说明 |
|------|-------------|------|
| 警情主单 | `t_alarm_report` / `AlarmReportEntity` | 编号、来源、类型、报案人、案由、处置/审核/作废状态、`return_refill_time` 等 |
| 审核组表决 | `t_alarm_audit_vote` / `AlarmAuditVoteEntity` | 本轮三位席位一票：legal/lawyer/jz |
| 嫌疑人 | `t_alarm_suspect` / `AlarmSuspectEntity` | 挂警情 |
| 证据材料 | `t_evidence_material` 等 / `EvidenceMaterialEntity` | 类型 + 图片文件 |
| 证据文件 | `EvidenceFileEntity` | 文件 key/url |
| 附件（兼容） | `AlarmAttachmentEntity` | 历史附件模型 |

#### 5.1.5 关键分类与状态

**警情类型 `alarm_category`**

| 编码 | 展示名 | 说明 |
|------|--------|------|
| `non_economic` | 咨询求助 | 原「非经侦类」 |
| `pending_review` | 报案类警情 | 原「待审核类/经侦类」 |

**警情来源 `alarm_source`**

| 编码 | 展示 | 说明 |
|------|------|------|
| `city_register` | 市局登记 | 市局接警员 |
| `district_register` | 分局登记 | 区县接警员 |
| `system_register` | （历史）本系统登记 | 兼容 |
| `110_transfer` | （历史）110 流转 | 兼容 |

**案件来源 `case_source`（报案类登记·接警信息）**

| 编码 | 展示 | 附加字段 |
|------|------|----------|
| `party_report` | 当事人报案 | 默认 |
| `admin_transfer` | 行政执法机关移交 | — |
| `court_transfer` | 人民法院移交 | 必填 `accepting_unit` 受案单位 |
| `procuratorate_transfer` | 人民检察院移交 | 必选 `case_source_sub`：虚假诉讼 / 其他 |
| `superior_assign` | 上级交办 | — |
| `work_discovery` | 工作中发现 | — |
| `other_unit_transfer` | 其他单位移交 | — |

**不予受理复审 `no_accept_review_status`（报案类·初步处理为不予调查处理且审核完成）**

| 编码 | 展示 | 说明 |
|------|------|------|
| （空） | 待发起复审 | 数据源：preliminary_handle_type=no_investigation + completed |
| `initiated` | 待上传申请书 | 接警员发起复审 |
| `app_uploaded` | 待填写复审意见 | 已上传复审申请书 |
| `accept_case` | 建议受案 | 克隆新警情至接报案大厅 |
| `pending_decision` | 待回传决定书 | 维持不予调查，可下载决定书 |
| `completed` | 复审完成 | 已回传纸质复审决定书 |

**处置状态 `disposal_status`（列表主展示）**

| 编码 | 咨询求助展示 | 报案类展示 | 说明 |
|------|--------------|------------|------|
| `pending_review` | 待审核 | 待定性审核 | 当前默认待办态 |
| `return_refill` | — | 退回重填（红） | 审核组任一人退回；大厅置顶；接警员可编辑 |
| `audit_rejected` | — | 审核未通过 | 三人齐票后多数不同意 |
| `no_disposal` / `non_economic` | 无需处置 | — | 历史/完成映射 |
| `completed` | 已审核完成 | 已审核完成 | 审核多数同意 |
| `pending_info` | — | （已废弃写入） | 历史「待补充信息」；展示映射为待定性审核；一次性 SQL 见 `docs/20260711_*.sql` |

**审核状态 `status`（列表不展示，后端保留）**

| 编码 | 含义 |
|------|------|
| `no_audit` | 咨询求助：无需审核 |
| `pending` / `reviewing` | 待审 / 审中 |
| `approved` / `accepted` | 已受理 |
| `rejected` | 已驳回 |
| `transferred` | 已移送 |
| `voided` | 已作废 |

**作废状态 `void_status`**

| 编码 | 含义 | 操作限制 |
|------|------|----------|
| `pending_void` | 作废审批中 | 不可编辑/再作废/开证据清单 |
| `voided` | 已作废 | 同上（仅可查看） |
| `void_rejected` | 作废已驳回 | 可再次发起作废 |

**作废组织层级 `void_org_level`**：`city`（主任章成）/ `district`（大队长）

#### 5.1.6 主流程细拆

**A. 咨询求助登记**

1. 大厅 → 警情受理登记 → 咨询求助  
2. 填咨询求助人信息、简要事实等  
3. 落库：`alarm_category=non_economic`，`status=no_audit`，`disposal_status=pending_review`，来源按接警员角色写市局/分局登记  
4. 列表可查看/编辑；无证据清单、无大厅「审核」按钮  

**B. 报案类登记**

1. 选择报案类 → 填报案人、简要案情、涉企信息（可选）、证据材料（图片）等  
2. 落库：`alarm_category=pending_review`，`disposal_status=pending_review`  
3. 有审核权限用户可走审核监督  

**C. 110 数据互通**

1. 列表查询已接后端  
2. **流转 / 批量流转**已接：进入接报案大厅，处置状态为 **待定性审核**（不再写 `pending_info`）  
3. **抽取、分类打标、回传、统计**：菜单权限已预留，前端多为 TODO，尚未真正落地  

**D. 审核监督（三人审核组）**

1. 待审/审核中报案类警情列表（咨询求助类不进）  
2. 全宽抽屉查看警情全量信息 + 三人票况（法制 / 公职律师 / 经侦）  
3. 席位角色：`alarm_audit_legal` / `alarm_audit_lawyer` / `alarm_audit_jz`；超管可代投空席  
4. 同意/不同意：三人齐票后少数服从多数  
   - 多数同意 → `status=accepted`，`disposal_status=completed`  
   - 多数不同意 → `status=rejected`，`disposal_status=audit_rejected`  
   - 未齐票 → `status=reviewing`  
5. 任一人「退回重填」立即生效 → `disposal_status=return_refill`（红色置顶），清本轮票；接警员可编辑，改完回 `pending_review`  

**E. 作废**

1. 接警员在大厅填理由发起作废 → `pending_void`  
2. 市局件 → 主任；区县件 → 大队长（admin 可看全部并可代审）  
3. 同意 → `voided`；不同意 → `void_rejected`  

#### 5.1.7 列表交互要点（大厅）

- 筛选：警情类型、处置状态（含退回重填/审核未通过；**无**「待补充信息」）、报警时间、编号、报案人等  
- 列表排序：`return_refill` 置顶，其次 `return_refill_time` 倒序  
- 列顺序：… → 警情类型 → 处置状态 → … → 操作  
- 操作列：查看 / 编辑（含退回重填可编）/ 证据清单（报案类）/ 作废；宽度收窄紧凑布局  
- 审核监督 PRD：`docs/Plan/prd-alarm-audit-supervision.md`  
- 大厅 PRD：`docs/Plan/prd-alarm-reception-hall.md`（部分历史条目可能滞后于代码，以本文 + 代码为准）

#### 5.1.8 与其他模块衔接

| 衔接 | 现状 |
|------|------|
| → 案件管理 | 规划：审核完成后立为案件；**未自动贯通** |
| → 数据大屏 | 规划：汇总警情指标；大屏现为静态演示数 |
| → 系统设置 | 字典（案件类型 77 类、警情级别等）、角色菜单、人员 |

---

### 5.2 案件管理（前端壳）

#### 5.2.1 职责

办案过程监督、执法考评、法律文书（两书一单）、风险预警、涉企案件台账、领导领办包保。

#### 5.2.2 菜单与页面

| 菜单 | 路径 | 组件 | 成熟度 |
|------|------|------|--------|
| 案件监督 | `/case-management/supervision` | `case-supervision.vue` | 壳 + mock |
| 执法考评 | `/case-management/evaluation` | `evaluation.vue` | 壳 |
| 两书一单 | `/case-management/two-books-one-form` | `two-books-one-form.vue` | 壳 |
| 风险预警 | `/case-management/risk-warning` | `risk-warning.vue` | 壳 |
| 涉企案件 | `/case-management/enterprise-record` | `enterprise-record.vue` | 壳 |
| 领办包保 | `/case-management/leader-record` | `leader-record.vue` | 壳 |

#### 5.2.3 后端

- **无**独立 `case-management` 业务 Controller/表（经侦域）  
- 权限点示例：`case:query`、`evaluation:query`（菜单已配，接口未建）

#### 5.2.4 业务对象（目标模型 · 待建）

| 对象 | 建议字段方向 |
|------|----------------|
| 案件 | 案件编号、名称、类型、来源警情 ID、状态（办理中/结案/撤销/督办中） |
| 考评记录 | 案件、指标、得分、周期 |
| 两书一单 | 文书类型、文号、关联案件、附件 |
| 风险预警 | 规则、级别、触发案件、处置状态 |
| 涉企案件 | 企业信用代码、案件关联 |
| 领办包保 | 领导、包保案件、期限、进度 |

#### 5.2.5 主流程（目标）

1. 接报案审核通过 → 生成/关联案件  
2. 办案中监督节点、风险触发预警  
3. 文书生成（两书一单）  
4. 涉企/领办专项台账维护  
5. 结案 → 卷宗归档 / 审议（重大）

#### 5.2.6 现状结论

页面具备查询区、表格、操作按钮等完整体验骨架，数据为 **前端 mock**，不可当真业务库。

---

### 5.3 涉案资金（前端壳）

#### 5.3.1 职责

涉案资金冻结、扣押、返还等台账；资金分析；「金析为证」分析成果固化。

#### 5.3.2 菜单与页面

| 菜单 | 路径 | 组件 | 成熟度 |
|------|------|------|--------|
| 资金管理 | `/fund/management` | `fund-management.vue` | 壳 + mock 统计/列表 |
| 资金分析 | `/fund/analysis` | `fund-analysis.vue` | 壳 |
| 金析为证 | `/fund/evidence` | `fund-evidence.vue` | 壳 |

#### 5.3.3 后端

无经侦资金域独立后端包；无真实资金表。

#### 5.3.4 目标对象与状态

| 对象 | 方向 |
|------|------|
| 资金账户/流水 | 账号、户名、金额、银行、关联案件 |
| 强制措施 | 冻结/扣押/返还；状态：待处理/已冻结/已扣押/已返还 |

页面统计卡示例字段：冻结总额、扣押总额、返还总额、待处理笔数（当前写死演示数）。

#### 5.3.5 衔接

依赖案件管理提供 `caseId`；分析结果可回写证据/卷宗（未实现）。

---

### 5.4 涉案财物（已落地）

#### 5.4.1 职责

涉案物品登记、在库管理、调用审批、估值、处置与返还。

#### 5.4.2 菜单与页面

| 菜单 | 路径 | 组件 | 成熟度 |
|------|------|------|--------|
| 财物管理 | `/property/management` | `property-management.vue` | 已落地 |
| 财物调用 | `/property/transfer` | `property-transfer-list.vue` | 已落地 |
| 财物归还 | `/property/return` | `property-return-list.vue` | 已落地 |
| 财物出库 | `/property/checkout` | `property-checkout-list.vue` | 已落地 |
| 查扣冻未登记 | `/property/unregistered` | `property-unregistered-list.vue` | 已落地 |
| 涉案财物漏交漏录 | `/property/omission` | `property-omission-list.vue` | 已落地 |

**财物调用**为调用审核中/调用中子集。**财物归还** Tab：待归还（调用中，调用发起人申请）/ 归还审核中（涉案财物管理员审核）/ 归还记录。**财物出库** Tab：已入库（办理民警发起）/ 出库审核中（涉案财物管理员审核）/ 已出库。**查扣冻未登记**：同步执法办案系统查扣冻文书编号，与 `t_property.legal_doc_no` 比对，列出未登记录入项。**涉案财物漏交漏录**：按案件比对办案系统财物清单（名称、类型、数量）与本平台登记，发现完全漏交或数量不足。均在用户权限范围内过滤。

#### 5.4.3 目标对象

| 对象 | 方向 |
|------|------|
| 财物主档 | 案件编号、法律文书、类型、措施、名称、编码、数量、特征、所有人、提交人、保管人、接收时间、条形码、法律文书附件 |
| 调用单 | 调用单号、调用人、调用时间、调用事由、调用期限（最长 2 个月）、期限届满、审核人 |
| 归还记录 | 关联调用单、归还人、归还时间、归还说明 |
| 出库单 | 出库单号、出库经办人、出库时间、出库事由 |
| 查扣冻文书（办案系统） | 法律文书编号、案件编号、措施类型（查封/扣押/冻结）、承办人、办案单位、文书日期 |
| 办案系统财物清单 | 案件编号、财物名称、类型、数量、办案单位 |
| 处置单 | 处置方式、审批、状态（在库/待处置/已返还等） |

财物状态：已登记、已入库、调用审核中、退回重填、待确认调用、调用中、归还审核中、出库审核中、已出库。

**调用流程**：已入库 → 调用申请 → 调用审核中 → **大队长审核**（同意/不同意/退回重填/提级审核）→ 同意后经**录入人确认** → 调用中 → **调用发起人归还申请** → **涉案财物管理员审核** → 已入库。

| 归还审核结果 | 财物状态变化 | 后续 |
|--------------|--------------|------|
| 同意归还入库 | 已入库 | 流程结束 |
| 不同意归还入库 | 调用中 | 发起人可再次申请 |
| 财物改变 | 已入库 | 需填写改变说明 |

**操作轨迹**：财物录入/调用/归还/出库等操作写入 `t_property_operation_log`，在财物详情「处置记录时间线」展示。

**出库流程**：已入库 → **办理民警**提交出库申请（法律文书编号+附件）→ 出库审核中 → **涉案财物管理员审核** → 已出库 / 返回重填（恢复已入库，可再申请）。

| 出库审核结果 | 财物状态变化 | 后续 |
|--------------|--------------|------|
| 确认出库 | 已出库 | 流程结束 |
| 返回重填 | 已入库 | 办理民警可再次发起 |

#### 5.4.4 权限点

| 页面 | web_perms |
|------|-----------|
| 财物管理 | `property:management:query/add/detail/checkout/invoke` |
| 财物调用 | `property:transfer:query/detail/audit` |
| 财物归还 | `property:return:query/detail/submit/audit` |
| 财物出库 | `property:checkout:query/detail/submit/audit` |
| 查扣冻未登记 | `property:unregistered:query/sync` |
| 涉案财物漏交漏录 | `property:omission:query/sync` |

#### 5.4.5 后端

涉案财物已落地后端（`module/business/property`），接口前缀 `/property/**`；数据表 `t_property`、`t_property_attachment`、`t_property_transfer`、`t_property_return`、`t_property_checkout`、`t_case_seizure_doc`（办案系统查扣冻文书缓存）、`t_case_property_item`（办案系统财物清单缓存）。前端已移除 mock，全量走 API。

**查扣冻未登记逻辑**：`POST /property/unregistered/sync` 从执法办案系统抓取文书 → 写入 `t_case_seizure_doc`；`POST /property/unregistered/query` 查询办案文书中 `legal_doc_no` 不在已登记财物中的记录。

**漏交漏录逻辑**：`POST /property/omission/sync` 同步办案系统案件财物清单 → `t_case_property_item`；`POST /property/omission/query` 按 `case_no + property_name + property_category` 汇总比对，列出本平台登记数量少于办案系统的项（完全漏交 / 数量不足）。

---

### 5.5 卷宗管理（后端已落地 · 一级目录 + 6 子菜单）

#### 5.5.1 职责

从执法办案系统同步待归档案件卷宗 → 登记归档（分册）→ 可选移交市局 → 借阅（本人/他人/支队）→ 归还审核 → 呈请复印（三级审核）。

#### 5.5.2 菜单与页面

| 菜单 | 路径 | 组件 | 成熟度 |
|------|------|------|--------|
| 卷宗管理（一级目录） | `/dossier` | — | 已配置 |
| 登记归档 | `/dossier/register` | `dossier-register-list.vue` | 已落地 |
| 借阅本人卷宗 | `/dossier/borrow-self` | `dossier-borrow-self-list.vue` | 已落地 |
| 借阅他人卷宗 | `/dossier/borrow-other` | `dossier-borrow-other-list.vue` | 已落地 |
| 支队借阅 | `/dossier/borrow-detachment` | `dossier-borrow-detachment-list.vue` | 已落地 |
| 借阅归还 | `/dossier/borrow-return` | `dossier-borrow-return-list.vue` | 已落地 |
| 呈请复印 | `/dossier/copy-request` | `dossier-copy-request-list.vue` | 已落地 |

#### 5.5.3 状态机

**归档状态 `archive_status`**

| 码 | 含义 |
|----|------|
| `not_archived` | 未归档（默认） |
| `archived` | 已归档（登记后） |

**卷宗状态 `dossier_status`**

| 码 | 含义 |
|----|------|
| `temp_custody` | 暂存保管（同步后默认） |
| `registered_archived` | 已登记归档 |
| `transferred_city` | 已移交市局（不可借阅） |
| `borrow_auditing` | 借阅他人 · 大队长审核中 |
| `pending_confirm` | 待管理员确认借出 |
| `borrowing` | 借出中 |
| `return_auditing` | 归还审核中 |
| `copy_auditing` | 复印审核中 |

**来源案件状态 `source_case_status`**：`no_filing`（不予立案）、`withdrawn`（撤案）、`transfer_prosecution`（移送起诉）

#### 5.5.4 核心表

| 表 | 说明 |
|----|------|
| `t_dossier` | 卷宗主表 |
| `t_dossier_volume` | 分册 |
| `t_dossier_transfer` | 移交市局记录 |
| `t_dossier_borrow` | 借阅/归还单 |
| `t_dossier_copy_request` | 复印申请（三级审核） |
| `t_dossier_operation_log` | 操作轨迹 |

#### 5.5.5 后端 API（`/dossier/**`）

| 接口 | 权限 | 说明 |
|------|------|------|
| `POST /dossier/sync` | `dossier:sync` | 同步办案系统（demo：不予立案/撤案/移送起诉） |
| `POST /dossier/register/query` | `dossier:register:query` | 登记归档列表 |
| `POST /dossier/register/submit` | `dossier:register:submit` | 登记归档（写入分册） |
| `POST /dossier/transfer/submit` | `dossier:transfer:submit` | 移交市局 |
| `GET /dossier/detail/{id}` | `dossier:detail` | 详情（分册 + 操作时间线） |
| `POST /dossier/borrow-self/*` | `dossier:borrow:apply` | 本人借阅 → 待确认 → 借出 |
| `POST /dossier/borrow-other/search` | `dossier:borrow:apply` | 本单位搜索（仅返回卷宗编号） |
| `POST /dossier/borrow-other/*` | `dossier:borrow:audit` | 他人借阅 · 大队长审核 |
| `POST /dossier/borrow/confirm` | `dossier:borrow:confirm` | 管理员确认借出 |
| `POST /dossier/borrow-return/*` | `dossier:return:audit` | 归还申请/审核 |
| `POST /dossier/copy/*` | `dossier:copy:apply` / `audit` | 复印三级审核（队长→章主任→领导） |

代码包：`module/business/dossier/`；SQL：`docs/20260804_dossier_module.sql`

---

### 5.6 审议流程（前端壳 · 可接 Warm-Flow）

#### 5.6.1 职责

重大议题审议、监督督办、意见流转、审核组配置、流程定义管理。

#### 5.6.2 菜单与页面

| 菜单 | 路径 | 组件 | 成熟度 |
|------|------|------|--------|
| 一般审议 | `/review/general-list` | `general-list.vue` | 壳 + mock |
| 监督督办 | `/review/supervision` | `supervision.vue` | 壳 |
| 审核意见 | `/review/opinion-flow` | `opinion-flow.vue` | 壳 |
| 审核组配置 | `/review/group-config` | `group-config.vue` | 壳 |
| 流程列表 | `/review/process-list` | `process-list.vue` | 壳 + mock 节点/版本 |

#### 5.6.3 目标对象与状态

| 对象 | 方向 |
|------|------|
| 审议议题 | 议题编号、类型（案件审议/资金处置/财物处置/政策研讨等）、提交人、状态 |
| 审议状态 | 待审议 / 审议中 / 已通过 / 已驳回 |
| 审核组 | 成员、角色、适用议题类型 |
| 流程定义 | 可对接 Warm-Flow（系统已有 flow 模块与请假示例） |

#### 5.6.4 框架能力参考

- `docs/工作流定义.md`  
- 后端 `module/flow`、前端 `views/flow`  
- OA 请假（`oa/leave`）可作流程接入样例  

> **重要区分**：「审议流程」业务菜单（`views/business/review/*`）目前全是 Mock；**WarmFlow ≠ 该菜单**。引擎已集成，但尚未接到经侦审议页。

---

### 5.7 数据大屏（前端展示壳）

#### 5.7.1 职责

领导驾驶舱：今日警情、趋势、结构分布、办理进度等可视化。

#### 5.7.2 菜单与页面

| 菜单 | 路径 | 组件 | 成熟度 |
|------|------|------|--------|
| 综合数据大屏 | `/bigscreen/data-bigscreen` | `data-bigscreen.vue` | UI 完整，数据静态 |

#### 5.7.3 现状

- 数字滚动、SVG 趋势等为前端动画/占位  
- **未**接 `t_alarm_report` 实时统计 API  

#### 5.7.4 目标指标（建议）

今日登记数、待定性审核数、作废审批中、已审核完成、来源占比（市局/分局/110）、趋势按日。

---

### 5.8 系统设置（框架已落地）

#### 5.8.1 职责

支撑全系统运行的组织、人员、角色菜单、字典、文件、日志、通知等。

#### 5.8.2 来源

- 菜单重组：`docs/20260629_reorganize_top_menus.sql` 将原系统类菜单归入「系统设置」  
- SmartAdmin 标准模块：`employee`、`role`、`menu`、`department`、`dict`、`file`、`login` 等  

#### 5.8.3 与经侦业务关键点

| 能力 | 业务用途 |
|------|----------|
| 角色 / 菜单 | 接报案与作废角色授权 |
| 字典 | 经侦 77 类案件类型、警情级别、来源等 |
| 员工 | 接警员双岗人员、审批人账号 |
| 超级管理员标志 | admin 全菜单 + 作废全量待办 |

#### 5.8.4 附带演示业务（非经侦主链）

OA 企业/发票/银行、通知公告、ERP 商品分类等仍在代码仓库中，**菜单已下线**（`docs/20260805_hide_system_demo_menus.sql`：reload、文件管理、单号管理、功能 Demo、文档中心、代码生成），不纳入经侦八大主价值链。

#### 5.8.5 系统设置保留菜单（经侦常用）

组织人员、部门、角色、菜单、字典、参数配置、缓存、操作/登录日志、消息通知、定时任务等运维能力仍保留在「系统设置」下。

---

## 6. 核心数据对象总表（已落地）

| 对象 | 表 | 主键 | 归属模块 |
|------|-----|------|----------|
| 警情 | `t_alarm_report` | id / report_no | 接报案 |
| 审核组表决 | `t_alarm_audit_vote` | alarm_id + auditor_role | 接报案 |
| 嫌疑人 | `t_alarm_suspect` | — | 接报案 |
| 证据材料 | 证据相关表 | — | 接报案 |
| 菜单/角色 | `t_menu` / `t_role` / `t_role_menu` | — | 系统设置 |
| 员工 | `t_employee` | employee_id | 系统设置 |

待建：案件、资金、财物、卷宗、审议议题等业务表。

---

## 7. 状态机汇总

### 7.1 处置状态（展示主状态）

```text
[登记/流转] → pending_review（待审核/待定性审核）
                 ├─→ reviewing（三人表决中，status）
                 ├─→ completed（多数同意）
                 ├─→ audit_rejected（多数不同意）
                 ├─→ return_refill（任一人退回重填，大厅置顶可编辑）→ 改完回 pending_review
                 ├─→ no_disposal（无需处置，咨询求助场景）
                 └─（历史 pending_info 已迁移/映射为 pending_review）
```

### 7.2 作废状态

```text
(空/驳回后) --申请--> pending_void --同意--> voided
                         └--不同意--> void_rejected → 可再申请
```

### 7.3 审核状态（后端）

```text
no_audit（咨询求助）
pending → reviewing → approved/rejected/transferred
任意节点叠加 voided（作废同意后）
```

---

## 8. 代码 / 菜单对照速查

| 业务 | 前端目录 | 后端目录 |
|------|----------|----------|
| 接报案 | `views/business/alarm/` | `module/business/alarm/` |
| 案件 | `views/business/case-management/` | （无） |
| 资金 | `views/business/fund/` | （无） |
| 财物 | `views/business/property/` | `module/business/property/` |
| 审议 | `views/business/review/` | （无；通用 flow 另有） |
| 大屏 | `views/business/alarm/data-bigscreen.vue` | （无） |
| 系统 | `views/system/` 等 | `module/system/` |
| 菜单初始化 | — | `sql/init_alarm_menus_and_roles.sql` |
| 作废菜单（一次性 SQL） | — | `docs/20260708_void_audit_menu.sql` |
| 处置状态迁移（一次性 SQL） | — | `docs/20260711_migrate_pending_info_to_pending_review.sql` |
| 审核组表决（一次性 SQL） | — | `docs/20260722_alarm_audit_group.sql` |

常量：

- `AlarmVoidConst` / `AlarmSourceConst`  
- 前端 `constants/business/alarm/*`

---

## 9. 已知缺口与待建能力

| 优先级 | 缺口 | 说明 |
|--------|------|------|
| P0 | 案件域后端 | 警情 → 案件贯通 |
| P1 | 资金真实台账 | 替换 mock |
| P1 | 卷宗归档借阅 | 替换 mock |
| P1 | 审议绑定 Warm-Flow | 替换 mock |
| P2 | 大屏接真实统计 API | 替换静态数 |
| P2 | 视频监控对接 | 现有页面待接流媒体/平台 |
| P2 | 接警员人员库后台维护 | 现部分前端模拟 |
| 文档 | 单功能 PRD 与本文对齐 | 如 `pending_info` 废弃后需改 PRD |

---

## 10. 文档维护约定（长期）

1. **主文档**：本文 `Docs/Key/biz-model-system.md`  
2. **变更记录**：`Docs/Key/biz-model-changelog.md` 每次业务变更追加一条  
3. **单功能 PRD**：仍放 `docs/Plan/`，实现完成后更新 PRD，并回写本文对应域章节  
4. **触发时机**：功能经用户确认并实现完成后，由 AI/开发同步改文档（见项目规则）  
5. **成熟度标记**：壳子上线后端后，必须把本节成熟度从「壳」改为「已落地」并补 API/表  

---

## 附录 A. 相关文档索引

| 文档 | 说明 |
|------|------|
| `docs/Plan/prd-alarm-reception-hall.md` | 接报案大厅 PRD |
| `docs/Plan/prd-alarm-audit-supervision.md` | 审核监督三人表决 PRD |
| `.trae/documents/prd-non-economic-crime-report.md` | 非经侦/咨询求助相关 |
| `.trae/documents/tech-arch-non-economic-crime-report.md` | 技术架构笔记 |
| `docs/工作流定义.md` | 工作流 |
| `sql/init_alarm_menus_and_roles.sql` | 菜单角色初始化 |
| `docs/20260708_void_audit_menu.sql` 等 | 作废菜单增量 |
| `docs/20260711_migrate_pending_info_to_pending_review.sql` | 处置状态迁移 |
| `docs/20260722_alarm_audit_group.sql` | 审核组表决表与退回重填字段 |
| `MIGRATION_PLAN.md` | 迁移计划（若有） |

## 附录 B. 演示账号（作废链）

| 账号 | 角色 | 密码（演示） |
|------|------|--------------|
| `alarm_city_receiver` | 市局接警员 | 123456 |
| `alarm_district_receiver` | 区县接警员 | 123456 |
| `zhangcheng` | 市局主任 | 123456 |
| `district_captain` | 区县大队长 | 123456 |
| `admin` | 超级管理员 | （系统原密码） |