# ywdata schema 业务术语词典

中文执法办案系统的拼音/缩写表名很容易误译。先查这里。

## 表名缩写

| 表名 | 全称 | 含义 |
|------|------|------|
| `zq_zfba_xyrxx` | 嫌疑人信息 | 嫌疑人主表 (通用) |
| `zq_zfba_ajxx` | 案件信息 | 案件主表 |
| `zq_zfba_wcnr_xyr` | 未成年人嫌疑人 | 未成年专项嫌疑人表 |
| `zq_zfba_xzcfjds` | **行政处罚决定书** | 行政处罚记录 |
| `zq_zfba_byxzcfjds` | **不予行政处罚决定书** | ⚠️ 不是"必要教育"！是"不予处罚" |
| `zq_zfba_jlz` | 拘留证 | 刑事拘留记录 |
| `zq_zfba_wenshu` | 文书 | 各类法律文书 (终止侦查决定书、训诫书等) |
| `zq_zfba_xjs2` | 训诫书 | 训诫文书 |
| `zq_zfba_zlwcnrzstdxwgftzs` | 责令未成年人专门矫治通知书 | 专门教育决定书 |
| `zq_zfba_tqzmjy` | 提请专门矫治教育 | 提请专门教育申请书 |
| `zq_zfba_wcnr_sfzxx` | 未成年人身份证信息 | 身份信息核查 |

## 字段缩写

| 字段 | 全称 |
|------|------|
| `sfzh` / `sfzhm` | 身份证号 / 身份证号码 |
| `ajbh` / `ajxx_ajbh` | 案件编号 |
| `rybh` / `xyrxx_rybh` | 人员编号 (嫌疑人在系统的唯一ID) |
| `ajlx` | 案件类型 (`'行政'` / `'刑事'`) |
| `ay` / `ay_dm` | 案由 / 案由代码 |
| `lasj` | 立案时间 |
| `lrsj` | 录入时间 |
| `fasj` | 发案时间 |
| `fadd` | 发案地点 |
| `jyaq` | 简要案情 |
| `cbdw` / `cbdw_bh` / `cbdw_bh_dm` | 承办单位 / 编号 / 编号代码 |
| `cbqy` | 承办区域 |
| `hjdxz` / `hjdxzqh` | 户籍地详址 / 户籍地行政区划 |
| `xzdxz` / `jzdxzqh` | 现住地详址 / 居住地行政区划 |
| `xm` / `xb` | 姓名 / 性别 |
| `csrq` | 出生日期 |
| `wsmc` | 文书名称 |
| `xgry_xm` | 相关人员姓名 (文书表里嫌疑人就用这个名字字段) |
| `cfzl` | 处罚种类 (拘留/罚款/警告等) |
| `cfjg_text` | 处罚结果文本 |
| `tj_jlts` | 拘留天数 |
| `tj_fkje` | 罚款金额 |
| `zxqk_text` | 执行情况文本 (含"不执行""不送") |
| `cbryj` | 承办人意见 |

## 业务规则常见关键词

| 关键词 | 含义 |
|--------|------|
| `'违法事实不能成立'` | 不予处罚的撤销理由，出现在 `byxzcfjds_cbryj` 中 |
| `'终止侦查决定书'` | 刑事案件不予追诉的标志 (在 `wenshu.wsmc` 中) |
| `'提请专门'` | 提请专门教育申请的文书 |
| `'训诫'` | 训诫书 |
| `'拘留'` + `'不执行\|不送'` | "拘留不执行"判定的核心组合 |
| `isdel_dm = '0'` | 未删除 |

## 业务标志字段含义 (出现在 zmjz/wfry 系列sql中)

| 标志字段 | 判定 |
|----------|------|
| 是否拘留不执行 | 行政 + cfzl有"拘留" + zxqk有"不执行/不送" + jlts > 4 |
| 是否2次违法犯罪且第一次开具矫治文书 | 行政案件=2次 + 案由相同 + 第一次有训诫书或专门教育决定书 |
| 是否3次及以上违法犯罪 | 行政案件 ≥ 3次 |
| 是否犯罪且未刑拘且未开具《终止侦查决定书》 | 刑事 + 无 jlz 记录 + wenshu 中无终止侦查决定书 |
| 是否符合专门(矫治)教育 | 上面四类情形任一为"是" |
| 是否开具专门(矫治)教育申请书 | tqzmjy 表存在 (ajbh + 姓名) 匹配 |

## 易错点

1. **`byxzcf` 不是"必要教育"**，是"不予行政处罚" (byXZCF = 不予行政处罚)。
2. **`zq_zfba_wenshu` 没有 rybh 字段**，关联嫌疑人只能用 `xgry_xm`(姓名)，所以容易出现重名问题。
3. **空格处理**：姓名字段可能含中英文空格，比较时统一用 `regexp_replace(xm, '[[:space:]　]+', '', 'g')`。
4. **多对一**：一个 (案件,人员) 可能对应多条 `xzcfjds` 记录 (一案多罚)，聚合时注意 `string_agg DISTINCT` 或取最新。