银行核心知识库维护规范
本文档用于约束后续所有系统截图解读、业务专题沉淀和目录维护。目标是让 wiki/ 能同时承接存款核心柜面、存款产品工厂、贷款核心和通用核心能力，而不是只按截图顺序堆材料。
1、总体原则
1.1 按系统域归档
知识库内容统一放在 wiki/ 下。中文源内容放在 wiki/cn/ 下，并按系统域划分：
wiki/cn/01-存款核心/
wiki/cn/02-贷款核心/
wiki/cn/03-通用核心能力/存款核心下再区分系统形态：
wiki/cn/01-存款核心/01-核心柜面/
wiki/cn/01-存款核心/02-存款产品工厂/
wiki/cn/01-存款核心/03-存款业务专题/当前已经整理的柜面截图和页面解读，全部归入：
wiki/cn/01-存款核心/01-核心柜面/1.2 页面事实和专家解读分开写
文档中需要区分两类信息：
- 截图事实：页面标题、字段、按钮、页签、表格列名、提示语。
- 专家解读：基于银行核心经验推断出的业务含义、校验逻辑、账务影响、风险控制点。
如果某项内容不是截图直接展示，而是业务经验判断，应使用“通常”“可能”“一般情况下”等表述。
1.3 截图和文字必须绑定
每个页面解读都应包含：
- 页面原始截图
- 页面定位
- 字段和按钮说明
- 业务流程
- 核心业务解读
- 关键规则和风险控制点
只存截图不利于复习，只写文字又会丢失系统界面上下文，两者必须一起沉淀。
1.4 通用概念不要重复堆在页面里
跨多个页面复用的概念，应沉淀到专题文档：
- 某个系统内复用：放到该系统自己的
topics/。 - 跨存款和贷款都复用：放到
wiki/cn/03-通用核心能力/。
交易页面只保留必要解释，并链接到专题。
2、目录规范
2.1 项目根目录
README.md
wiki/
web/
scripts/
project-docs/项目根目录只放全局入口和顶层目录，不放具体页面解读。
| 目录 | 职责 |
|---|---|
wiki/ | 知识库源内容，按 cn 和 en 维护中英文版本。 |
web/ | 后续 Web 可视化系统代码。 |
scripts/ | 后续项目级或 wiki 级自动化脚本。 |
project-docs/ | 项目规范、目录说明、设计说明和部署说明。 |
2.2 Wiki 根目录
wiki/
├── cn/
└── en/wiki/cn/ 是中文源内容目录，wiki/en/ 是英文学习版目录。除英文站点首页 wiki/en/index.md 外，两个语言目录保持同路径结构。
2.3 总览目录
wiki/cn/00-总览/
├── 学习路线.md
├── 系统地图.md
├── 术语表.md
└── 待补充清单.md这里用于回答“先学什么、系统之间怎么连接、有哪些通用术语、后面还缺什么”。
2.4 存款核心
wiki/cn/01-存款核心/
├── README.md
├── 01-核心柜面/
├── 02-存款产品工厂/
└── 03-存款业务专题/01-核心柜面/ 保存柜面菜单、页面截图、交易功能解读。
02-存款产品工厂/ 保存活期、定期、利率、期限、转存、费用、账户控制等产品参数配置。
03-存款业务专题/ 保存跨柜面和产品工厂的存款业务模型，例如账户生命周期、活期存款、定期存款、计息、结息、日终批量。
2.5 贷款核心
贷款核心当前先沉淀业务专题：
wiki/cn/02-贷款核心/
├── README.md
└── 03-贷款业务专题/03-贷款业务专题/ 保存贷款对象、生命周期、产品和还款方式、放款还款账务、计息罚息、还款计划、逾期催收、担保抵质押、风险分类拨备等内容。
后续拿到贷款核心截图或文档后，再补充：
wiki/cn/02-贷款核心/01-贷款柜面/
wiki/cn/02-贷款核心/02-贷款产品工厂/页面解读应链接到贷款业务专题，避免在每个页面重复解释授信、合同、借据、还款计划、逾期和担保等通用概念。
2.6 通用核心能力
wiki/cn/03-通用核心能力/这里保存跨存款、贷款都成立的通用概念，例如客户与账户、产品工厂通用模型、机构柜员权限、授权审批、账务流水、内部户、参数管理、日终批量、对账差错。
3、截图规范
3.1 截图目录
所有截图统一放到 wiki/cn/assets/screenshots/ 下，再按系统域拆分：
wiki/cn/assets/screenshots/01-存款核心柜面/
wiki/cn/assets/screenshots/02-存款产品工厂/
wiki/cn/assets/screenshots/03-贷款核心/3.2 截图命名
有交易码或功能码时，优先使用交易码：
9103.png
3001.png
1001.png同一页面多张截图时使用序号：
3001-01.png
3001-02.png
3001-03.png没有交易码的产品工厂页面，可以使用稳定的业务名称：
current-product-basic.png
term-product-interest-rule.png命名要求：
- 不使用空格。
- 尽量不使用中文文件名。
- 不随意覆盖旧图，除非确认是同一页面的清晰替换版。
3.3 图片引用
存款核心柜面分文档位于：
wiki/cn/01-存款核心/01-核心柜面/docs/二级菜单/文档.md图片路径示例：
../../../../assets/screenshots/01-存款核心柜面/9103.png后续存款产品工厂和贷款核心也按所在目录计算相对路径，原则是：文档能在本地 Markdown 或 Obsidian 中直接显示图片。
4、页面解读结构
柜面类页面按“系统菜单”组织，推荐粒度是“一个二级菜单一个分文档”。
每个二级菜单分文档使用：
# 二级菜单名称
## 业务框架
### 1.1 模块主线
### 1.2 页面分工
### 1.3 关键字段和状态
### 1.4 与其他模块的关系
## 页面解读
### 2.1 交易清单
### 2.2 [交易码]页面名称
#### 页面截图
#### 页面定位
#### 适用场景
#### 页面要素
#### 业务流程
#### 核心业务解读
#### 关键规则
#### 风险控制点
## 关联功能标题要自然专业，不在标题中写“总：”“分：”。
5、产品工厂文档结构
产品工厂不是简单交易页面集合，重点是“参数如何生成产品能力”。建议按配置主题拆：
01-产品模型
02-活期产品配置
03-定期产品配置
04-利率与计息规则
05-期限与到期处理
06-费用与收费规则
07-账户控制与交易限制
08-产品发布与生效每个配置页面建议回答：
- 这个参数控制什么业务行为。
- 会影响哪些柜面交易。
- 对账户、利息、费用、账务、状态有什么影响。
- 修改后何时生效，是否影响存量账户。
- 有哪些风险和校验点。
6、更新流程
每次新增截图或文档时按以下顺序处理：
- 判断材料属于哪个系统域：存款核心柜面、存款产品工厂、贷款核心或通用能力。
- 图片保存到对应
wiki/cn/assets/screenshots/子目录。 - 找到或新建对应系统下的
docs/分文档。 - 先记录截图事实，再补充专家解读。
- 如果出现跨页面复用概念，更新对应
topics/或wiki/cn/03-通用核心能力/。 - 更新对应系统的
README.md。 - 必要时更新
wiki/cn/00-总览/学习路线.md和wiki/cn/00-总览/待补充清单.md。
7、中英版本同步规则
当前知识库采用中文源内容 + 英文学习版双轨维护。
| 目录 | 职责 |
|---|---|
wiki/cn/ | 中文业务知识源头，保留截图事实、业务解释和专家解读。 |
wiki/en/ | 英文学习版，使用 en-US 和美式银行/金融科技表达重写同一业务内容。 |
维护要求：
wiki/cn/下每个 Markdown 必须有同路径英文页，例如wiki/cn/a/b.md对应wiki/en/a/b.md。- 英文页必须保留
Chinese source:、Locale: en-US、Audience: Internal learning。 - 新增中文页时，同步新增英文页；修改业务含义、字段、流程、规则或风险控制点时，同步修改英文页。
- 如果只修中文错别字且不改变业务含义，可以不立即更新英文。
- 英文不是逐字翻译，但不能改变业务事实、页面关系和风险含义。
- 新增术语时，先更新
wiki/cn/00-总览/术语表.md，再更新英文正文。 - 完成维护后运行：
cd web
npm run check
npm run buildnpm run check 会检查 Markdown 链接、图片引用、wiki/cn/ 与 wiki/en/ 的英文覆盖率，以及英文菜单是否残留中文标签。单独检查英文覆盖率可运行：
cd web
npm run check:i18n完整英文写作和术语规则见：英文版翻译规范.md。
如果新增了中文目录名，而英文侧边栏仍显示中文，需要同步更新 scripts/build-sidebar.mjs 中的英文目录映射。
8、敏感信息
如截图中出现真实客户姓名、账号、证件号、手机号、余额、交易流水号等敏感信息，应先打码再入库。文档中不得主动还原或扩散敏感信息。