1. 案件对接概设

docs/案件数据对接/案件数据对接概要设计.md

@@ -0,0 +1,115 @@
+### 1. **功能概述**
+
+1.1 对接不同地区的案件数据，将案件数据批量导入系统中进行模型分析。
+1.2 不同地区之间可以自定义指标模型。
+1.3 不同地区之间数据相互隔离。
+
+### 2. **业务流程**
+
+![业务流程](./img/sass版本数据导入流程.jpg)
+
+### 3. **数据隔离方案(可选)**
+
+![用户数据隔离](./img/用户数据隔离.png)
+
+![案件数据隔离](./img/案件数据隔离.png)
+**如果不进行数据隔离，为保证各地区数据不受影响可单独部署一套应用环境**
+
+### 4.数据导入步骤：
+
+#### 4.1 按照excel表格要求录入数据
+
+![数据录入_excel](./img/数据录入_excel.png)
+
+##### 4.2 把笔录和证据资料放到对应的文件目录下
+
+**示例**
+
+```
+│─案件信息摘要.xlsx
+│
+├─笔录
+│  │  xxx询问笔录.docx
+│  │
+│  └─询问笔录第一次
+│          行为人笔录1.png
+│          行为人笔录2.png
+│
+└─证据
+    │  xxx证据.docx
+    │
+    └─xxx提供证据
+            证据1.png
+            证据2.png
+```
+
+### 5. **程序执行逻辑**
+
+![导入案件](./img/导入案件.png)
+
+#### 6. **涉及到的字段说明**
+
+**案件基础信息字段说明**
+
+| 字段| 字段中文名 | 是否必填 | 说明|
+| --- | --- | --- | --- |
+| caseName | 案件名 | 是 |  |
+| caseNo | 案件编号 | 是 | 案件的唯一标识，不允许重复 |
+| caseType | 案件类型 | 是 | 不同案件对应不同的分析模型，详情参考案件类型说明 |
+| caseStatus | 案件状态 | 是 | 详情参考案件状态说明 |
+| crimeMode | 到案方式 | 是 | 详情参考到案方式状态说明 |
+| caseDetail | 案件详情 | 是 |  |
+
+**涉案人员字段说明**
+
+| 字段| 字段中文名 | 是否必填 | 说明|
+| --- | --- | --- | --- |
+| name | 涉案人员名称 | 是 |  |
+| idCard | 涉案人员身份证 | 是 | |
+| role | 涉案人员角色 | 是 | 行为人、嫌疑人、受害人、证人、主行为人（案件只能有一个主行为人） |
+
+
+**案件笔录字段说明**
+
+| 字段| 字段中文名 | 是否必填 | 说明|
+| --- | --- | --- | --- |
+| actorIdCard | 行为人身份证号码 | 是 |  |
+| inquiryNo| 询问序号 | 是 | 第几次询问笔录 |
+| materialName | 供述材料名 | 是 | 支持文件类型 文档格式：（docx、doc） 图片格式：(png、jpg、jpeg) |
+| law_asker | 询问人姓名 | 是 | 警官姓名 |
+| confession_start_time| 供述开始时间 | 是 | 如: 2025-01-15 10:10:00 |
+| confession_end_time| 供述结束时间 | 是 | 如: 2025-01-15 11:10:00 |
+
+说明：对于一个证据文件类型只能是文档或者图片的一种，如果一个证据中有多个证据可以单独放到一个文件目录中
+
+**案件证据字段说明**
+
+证据按照分类存放到文件目录下，一个证据有多个文件的，单独创建目录
+
+| 字段| 字段中文名 | 是否必填 | 说明|
+| --- | --- | --- | --- |
+| evidenceType | 证据分类 | 是 | 详情参考证据分类 |
+| evidenceName | 证据名称 | 是 |  |
+
+**用户角色表字段说明**
+
+| 字段| 字段中文名 | 是否必填 | 说明|
+| --- | --- | --- | --- |
+| roleId | 角色id | 是 |  |
+| appId| 应用id | 是 |  |
+
+**菜单表字段说明**
+
+| 字段| 字段中文名 | 是否必填 | 说明|
+| --- | --- | --- | --- |
+| menuId| 菜单id | 是 |  |
+| appId| 应用id | 是 |  |
+
+**菜单表字段说明**
+
+| 字段| 字段中文名 | 是否必填 | 说明|
+| --- | --- | --- | --- |
+| menuId| 菜单id | 是 |  |
+| appId| 应用id | 是 |  |
+
+