功能操作台：贷款顾问 / Admin / Compliance 在此执行各项功能。下面 ① 为贷款匹配工具，② 为可按权限使用的资料更新功能，③④ 为规划中的功能（待开发）。
① New Case Matching（贷款匹配）
选择贷款类型与客户，系统按准入规则匹配可贷银行。
该贷款类型的匹配条件
② Update Client Data Base（按 Deal Number 更新客户资料）
输入 Deal Number，系统自动到客户文件夹（Numbered Client List）里找到最新修改的文件，提取内容并更新到该客户的档案：写入「信息记录（待核对）」并更新该 Deal 的源文件路径。
权限：Broker 与 Admin 可用；Compliance 不可用。
取文件规则：优先取「文件名含该 Deal 号」的最新文件；若没有，则取该客户文件夹里最新修改的文件（最多扫描 4 层、4000 个文件）。PDF 会自动提取文字。
若资料库无该 Deal 对应的客户档案：系统会先查重、确认是全新客户才建档 —— 先按出生日期（辅以姓名）在已有客户档案里比对，同一客户只增加关联 Deal（结果列显示 🔗 关联已有客户），不重复建档；确实找不到才自动建档（🆕，姓名按文件名/文本猜测，需人工核对）。
多文档自动填档：除主文件外，系统会扫描该客户文件夹里所有资料，按类型识别并取每类的最新版本，把字段自动写入对应版块（不覆盖人工已填的值，冲突项进「待核对」）：
· 护照 / ID / BRP → 申请人姓名、出生日期、国籍、护照号
· 签证 / Share Code → 签证状态、到期日
· 银行对账单 / 水电单 / Council Tax → 住址（写入地址历史）
· Payslip / P60 → 雇主、NI 号、工资金额
· Tax Calculation / SA302 → 自雇利润、租金收入、利息股息
· 征信报告 → 信用记录
· 买卖合同 / 租约 / 银行 Offer → 房产信息
· 公司年报 / Companies House → 公司记录
· Mortgage Offer > Illustration > Application Form（按此优先级）→ Deal 的贷款行、产品、额度、利率、期限
扫描结果会在结果表「自动填档」列列出每份资料的来源；扫描件（无文字层，如拍照的护照）读不到内容，会明确提示需人工补录。
③ 其他功能（待开发）
以上功能规划对 Admin / Broker / Compliance 开放，后续按需逐步启用。
④ Zoho WorkDrive 连接（云端直连）
接上 Zoho WorkDrive 后，云端服务器可自行到 Zoho 里按单号查找并下载客户文件，不再依赖本机 Z 盘。仅 Admin 可配置。
授权后没自动跳回？在这里粘贴授权码
⑤ 源文件目录配置
设置客户文件夹根目录（默认 Z 盘 Numbered Client List）。若工作台部署在云端，服务器无法访问本机 Z 盘，请改为服务器上的路径。
Lender Criteria Research
内容汇总自 Knowledge Bank criteria search 报告（Z 盘客户档案）＋ Broker 自录关键词。输入多个准入条件，系统只列出同时满足全部条件的银行，并展示每家银行在各条件下的准则原文与 YES / NO 结论。条件支持中英文（中文自动匹配库内英文术语）。
添加 2 个以上条件后点击「合并搜索」，例如：条件 1 填 HMO、条件 2 填 CCJ、条件 3 填 85% LTV。
关键词类别 · 准则陈列
先点选一个关键词类别，下方即列出该类别下的具体准则问题（关键词），点开可看各家银行的 YES / NO 结论与原文。
Criteria AI 助手
加载中…
可以直接问我，例如：
· TMW 接受 deck access 的公寓吗？
· 哪些银行接受 1 年自雇账目？
· NatWest 是否做 HMO / 公司借款？
（页面上方选中的贷款类型和关键词类别会自动作为检索范围；想放宽就把类别取消选择）
结论基于入库报告，各银行政策会变化，重大决定请二次核对 Knowledge Bank 原文。
Criteria AI 助手 · 服务配置（仅 Admin）
填一个 OpenAI 兼容的 API Key 即可启用 AI 直接作答。Key 只保存在服务器 data/aiConfig.json，页面不回显完整值。
模型被厂商下架时，系统会自动查询该服务当前可用模型并换一个（也会按顺序尝试备选模型），无需手动改。
常见报错：402 Insufficient Balance = 该服务商账号余额为 0，去它后台充值即可自动恢复；401 = Key 填错了。
从银行官网抓取准则（仅 Admin）
粘贴银行公开准则页网址 → 自动发现该站点的准则子页 → 抓取正文 → 结构化成条目并按 9 个关键词类别归类 → 你逐条勾选确认后才入库（不覆盖已有条目，来源记录网址与抓取日期）。
仅适用于无需登录的公开准则页；需登录的中介门户 / Knowledge Bank 请走原有导入渠道。
若该行只做某一类贷款（如 Nationwide 只做 Residential），在「整批贷款类型」里直接选，本批条目会统一打上该类型，避免按页面自动识别时漏判。
网页抓取准则 · 待审核
从银行官网抓取并入库的条目都先放在这里（准则列表里显示 官网抓取 徽章）。请逐条核对：确认无误的保留，抓歪或重复的删除。
加载中…
关键词修改审批
每个关键词右侧有「✏️ 修改」：Broker 点击后提交修改，系统发消息给 Admin；Admin 批准后修改正式发布（KB / PARADIGM 条目显示 已修订 徽章）。
加载中…
我的所有客户列表
顾问默认只显示自己名下（执行贷款顾问是自己）的客户；Admin / Compliance 显示全部客户。Broker 权限下 Email / 手机号按合规要求隐藏。点击客户姓名可打开完整档案。
客户档案库（统一更新，避免多表格冲突）
| 姓名 | 联系方式（邮箱 / 手机） | 职业 | 年收入 | 签证身份 | 贷款需求 | LTV | 执行顾问 | 更新时间 | 操作 |
|---|
同一客户只保留一份档案：新建时如检测到同名同电话会阻止重复建档；每次修改自动留痕，谁改的、改了什么都有记录。
KB Criteria Research
直接查询 Knowledge Bank® 原生准则库：一次可添加多条准则，逐条列出各Lender 的结论与政策说明。 查询由你自己电脑上的浏览器执行（住宅 IP），服务器不保存任何 KB 密码。
输入准则关键词后点「开始搜索」。
首次使用前请确认：KB 专用 Chrome 已启动、代理在运行、SSH 隧道已建立。
利率库
| 银行 | 产品 | 利率 | 产品费 | 最高 LTV | 更新日期 |
|---|
Successful Case Study Base（准入规则库）
只收纳本机构自己成交的案例（不含 Knowledge Bank 内容），按 6 种贷款类型分类。点击类型筛选。
Lender Update · 官方准则库更新（仅 Admin）
四层结构：① Lender Name → ② Mortgage Type（Residential / BTL / HMO-MUFB / Semi-Commercial / Commercial / Bridge）→ ③ Real Official Data Base Connected?（是否已接该行官网公开准则页）→ ④ Updated date & time。
点击某个格子的 Update → 系统到该行官网重新抓取一遍该类型的准则：先清除该 Lender 该类型的旧条目，再写入最新结果，并刷新更新时间。
加载中…
报告中心 · Skill 索引
这里登记了在 WorkBuddy / Codex 里做好的报告类 Skill（仅 Admin 可见）。报告不是在网页里跑的——它们是给 agent 的操作说明书，需要 agent 在本机读 Bigin / WorkDrive / Z 盘才能执行。
物业 / 房产管理类技能不在这里，已迁出到独立页面：C:\Users\nanli\WorkBuddy\2026-09-07-16-46-52\property-skill-hub.html
用法：点卡片上的 📋 复制运行指令，把指令粘进 WorkBuddy 或 Codex 的对话框即可；📂 复制路径 拿到 SKILL.md 所在目录，方便直接改说明书。
加载中…
📊 自助报告生成器
基于 24 模块数据库的实时数据。流程：① 选模块 → ② 在模块里点字段「＋」添加成报告列 → ③ 设筛选（客户范围 + 字段条件）→ 运行 出表，可导出 Excel。
报告层级决定每行粒度：客户（每人一行）/ 申请·Deal（每笔一行）/ 房产 / 贷款。跨模块的字段和筛选会通过客户/申请/房产/贷款 ID 自动关联（例如「从 NatWest 拿到 Offer 的客户与 Deal」「贷款额 > 50 万」）。
Offer 写回 Bigin（自动跑 · Beta）
输入 Deal Number → 服务器到 WorkDrive 客户文件夹里找 Offer 文档 → 抽取条款 → 先给你预览核对 → 你勾选后才写回 Bigin 并追加审计 Note。
文档优先级：① Mortgage Offer（最终版）→ ② Illustration / ESIS / KFI → ③ File Administration Checklist；草稿 / 作废文件自动跳过。
Bigin 里的字段名。授权后可点「🔍 探测字段」/「测试连接」核对真实名称，不一致就在这里改。
尚未扫描。
Zoho Bigin 连接（服务端直连 · Beta）
接上之后，工作台服务器就能自己读 Bigin 数据跑报告，不依赖 ChatGPT、也不用开 agent。
第一步：去 Zoho API Console 建一个 Server-based 应用，Redirect URI 填 https://workbench.empoweryield.co.uk/oauth/bigin，把 Client ID / Secret 粘进来保存；第二步：点「授权 Bigin 账号」。
贷款顾问工作台 · 使用说明书 v3
本说明按 Admin（负责人）／Individual Broker（贷款顾问）／Compliance（合规）三种权限角色分别说明可执行的功能、可访问的数据与典型操作流程。最后附「重要数据与文件位置」与「常见操作流程」。
0. 总览
访问地址：https://workbench.empoweryield.co.uk（HTTPS 自动）｜登录方式：用户名 + 密码（首次明文密码向负责人索取，登录后可自行修改）。
工作台共 8 个 Tab：
- 功能操作台 — New Case Matching（6 类贷款分流匹配） + Update Client Data Base（按 Deal Number 更新客户档案 / 自动建档） + Zoho WorkDrive 连接（仅 Admin）
- Lender Criteria Research — 合并搜索（多条件 AND）＋ 按 9 个关键词类别浏览准则（91 行 3356 条）+ Broker 自录关键词 + Criteria AI 助手 + 从银行官网抓取准则（仅 Admin）
- Rate Finding — 利率库（案例库 + KB 准则库两视图）
- Existing Client Data Base — 客户档案库（含查询 + 我的所有客户列表）
- Case Study Base — 本机构成交案例库（准入规则库）
- Lender Update — Lender × Mortgage Type 一键更新官方准则（仅 Admin，四层结构：Lender / 类型 / 是否连接官方库 / 更新时间）
- 报告中心（仅 Admin）— 报告类 Skill 索引（顾问周报 PDF / 顾问佣金表 / 月度 Broker Fee 表 / Offer 写回 Bigin / WorkDrive 客户同步）：每张卡片可一键复制运行指令或复制 SKILL.md 目录路径；报告由 agent 在本机执行，不在网页内运行。Admin 可新增、修改、删除条目。物业 / 房产管理类技能已迁出到独立页面
property-skill-hub.html - 使用说明 — 本文档
1. 角色 × 功能 权限矩阵
| 功能 / 数据 | Admin（负责人） | Broker（贷款顾问） | Compliance（合规） |
|---|---|---|---|
| ① New Case Matching（贷款匹配） | ✓ 全量 | ✓ 全量 | ✓ 只读 |
| ② Update Client Data Base（按 Deal Number 更新 / 自动建档） | ✓ | ✓ 名下客户可改 | ✗ 不可用 |
| ④ Zoho WorkDrive 连接配置 | ✓ 唯一可配 | ✗ 不可见 | ✗ 不可见 |
| Lender Criteria 浏览 | ✓ | ✓ | ✓ 只读 |
| Lender Criteria 新建/修订关键词 | ✓ 直接发布 | ⏳ 提交待审批 | ✗ |
| Lender Criteria 审批 | ✓ 通知铃铛 | ✗ | ✗ |
| 从银行官网抓取准则（含待审核管理） | ✓ 唯一可用 | ✗ 卡片不可见 | ✗ 卡片不可见 |
| Lender Update（一键更新 Lender × Mortgage Type） | ✓ 唯一可用 | ✗ Tab 不可见 | ✗ Tab 不可见 |
| Criteria AI 助手 | ✓ | ✓ | ✓ |
| Rate Finding 浏览 | ✓ | ✓ | ✓ 只读 |
| 客户列表查看 | ✓ 全部 75+ 客户 | 🔒 仅名下客户（执行顾问匹配） | ✓ 全部 |
| 客户邮箱/手机号 | ✓ 可见 | 🔒 服务端强制隐藏 | ✓ 可见 |
| 客户档案查询（按 Deal ID / 姓 / 名） | ✓ 全部 | ✓ 名下客户 | ✓ 全部 |
| 客户档案行内编辑（✏️ / ✕ / + 添加） | ✓ 所有客户 | ✓ 名下客户 | ✗ |
| 修改执行贷款顾问 | ✓ 唯一可改 | ✗ | ✗ |
| 新增客户（弹窗） | ✓ | ✗（建议走自动建档） | ✗ |
| Case Study Base 浏览 | ✓ | ✓ | ✓ 只读 |
| Case Study 维护 | ✓ | ✗ | ✗ |
| 使用说明 | ✓ | ✓ | ✓ |
2. Admin（负责人）使用说明
账号示例：nanli / 初始密码 Ey2026Admin（首次登录后请改）
Admin 拥有工作台全部权限，并对系统级配置、客户顾问归属、准则审批等独占操作负责。
2.1 功能操作台
- ① New Case Matching：选择贷款类型（① 自住房 ② BTL ③ Let to Buy ④ HMO ⑤ Semi-Commercial ⑥ 过桥）→ 填写客户基本情况（贷款额 / 房产价值 / 收入 / 签证 / 信用等）→ 系统按准入规则匹配可贷银行，显示 ✅ 通过 / ⚠️ 需人工核对 / ❌ 不匹配。
- ② Update Client Data Base：输入 Deal Number（支持多个，逗号或空格分隔，最多 20 个）→ 系统自动到本地
Z:/04 Operation/Client/Numbered Client List或云端 Zoho WorkDrive 找最新文件 → 提取 PDF / docx / xlsx 等文本 → 写入客户档案的「信息记录（待核对）」并更新该 Deal 的源文件路径。资料库无对应档案时：先查重、再建档 —— 系统按出生日期（Fact Find 文本中的生日与档案比对，辅以姓名）在已有客户里查找，同一客户只增加关联 Deal（结果列显示 🔗 关联已有客户，档案页有「关联到本客户」待核对项供人工确认）；确实没有才自动建档（🆕 角标，姓名按文件名猜测，需人工补全）。
多文档自动填档（本版新增）：系统会扫描该客户文件夹的全部资料，按文档类型识别，每类只取最新版本，再把字段写入对应版块 —— 护照/ID→姓名与出生日期、Share Code/签证→签证状态、银行对账单/水电单→住址、Payslip→雇主与 NI、SA302/Tax Calc→自雇与租金收入、征信报告→信用记录、买卖合同/租约→房产、公司年报→公司记录、Mortgage Offer > Illustration > Application Form（按优先级）→ Deal 的贷款行/产品/额度/利率/期限。
规则要点：不覆盖人工已填的值（自动建档的猜测值可被真实证件覆盖）；联名申请按姓氏自动归属到对应申请人；扫描件（无文字层）会提示人工补录；所有自动写入都会在「待核对」里留痕，结果表「自动填档」列显示每项来源。 - ③ 其他功能（待开发）：批量上传 / 批量下载导出 / 查看报告。
- ④ Zoho WorkDrive 连接：仅 Admin 可见。配置 Client ID / Secret / 团队 ID / 根目录 ID，凭据存
data/zohoConfig.json；点击「授权 Zoho 账号」跳转 Zoho 完成同意，refresh_token 长期有效，access_token 过期自动强刷。 - ⑤ 源文件目录配置：可改默认
Z:/04 Operation/Client/Numbered Client List与扫描深度（默认 4 层、4000 个文件）。
2.2 Lender Criteria Research
- 合并搜索（页面顶部）：选贷款类型 → 填 2 个以上条件（AND）→ 只列出同时满足全部条件的银行，并展示每家银行在各条件下的准则原文与结论。
- 关键词类别浏览（下方）：先选贷款类型，再点 9 个类别之一（1-Applicant / 2-Residential history / 3-Income / 4-Property / 5-Credit / 6-Source of Fund / 7-Mortgage History / 8-Mortgage Product / 9-Others）→ 列出该类别下的具体准则问题，点开看各家银行 YES / NO 结论。类别由系统自动归类。
- 新建搜索关键词：直接发布到团队，全团队立即可见。
- 修订既有条目：点击条目右侧「✏️ 修改」→ 提交即生效（KB / Paradigm 修订存
data/criteriaEdits.json，custom 条目原地更新）。 - 审批 broker 提交：右上角🔔通知铃铛显示待审数量，点开批准或驳回。
- AI 服务配置（页面底部，仅 Admin）：填 OpenAI 兼容的 API Key（OpenAI / DeepSeek / OpenRouter / 硅基流动 均可），Key 只存服务器；模型被厂商下架时系统自动查询可用模型并切换，也可手动改。现已接 DeepSeek（deepseek-v4-flash）。
- Criteria AI 助手：可问 "TMW 接受 deck access 的公寓吗" "哪些银行接受 1 年自雇账目" 等自然语言问题；只依据本库已收录的准则作答（KB + PARADIGM + 自录 + 官网抓取），未收录会明确说明，不会编造；中文问题靠术语表自动翻译成英文关键词检索。
- 从银行官网抓取准则（仅 Admin）：粘贴银行公开准则页网址 → 系统自动发现该站准则子页并抓取 → AI 结构化成条目、按 9 个关键词类别归类 → 你逐条勾选确认后入库（不覆盖已有条目，来源记网址与日期）。若该行只做某类贷款（如 Nationwide 只做 Residential），在「整批贷款类型」里选好，本批条目统一打标。
- 网页抓取准则 · 待审核（仅 Admin）：从官网抓取入库的条目集中在此，逐条核对——确认无误的保留，抓歪或重复的可单条删除或整行删除；并显示最近 20 次抓取记录。
2.3 Rate Finding
- 按年限（2 年 / 5 年）和类型（固定 / 浮动）筛选利率，分两视图：案例库（本机构成交）+ KB 准则库。
- 可新增 / 修改 / 删除利率条目（写入
data/rules.json）。
2.4 Existing Client Data Base
- 客户档案库（顶部）：列表查看全部 75+ 客户，含联系方式 / 职业 / 收入 / 签证 / 贷款需求 / LTV / 执行顾问 / 更新时间；可「+ 新增客户」。
- 客户档案查询：按 Deal ID / 姓 / 名搜索，弹出 6 大 Section 完整档案（身份 / 地址 / 收入 / 房产 / 信用 / Deal 历史）。
- 我的所有客户列表：Admin 显示全部，26 字段可自选（Deal ID / 顾问 / 最新贷款行 / 收入 / 房产 / LTV / NI / 签证等），选择存 localStorage。
- 行内编辑：所有客户的所有 Section（地址 / 房产 / 收入 / 记录 / 公司 / Deal）+ 申请人 1 / 2 基本情况均可用 ✏️ 改 / ✕ 删 / + 添加，无需审批。
- 修改执行贷款顾问：在档案 Deal 行内改 advisor 字段（broker / compliance 无权）。
2.5 Case Study Base
- 按 6 类贷款筛选本机构成交案例（16 行 37 单），可新增 / 修改 / 删除（
data/rules.jsonevidence 字段）。
2.6 Lender Update（仅 Admin，独立 Tab）
- 四层结构：① Lender Name → ② Mortgage Type（Residential / BTL / HMO-MUFB / Semi-Commercial / Commercial / Bridge）→ ③ Real Official Data Base Connected?（是否已配置该行官网公开准则页）→ ④ Updated date & time（最后更新时间与条数）。
- 添加银行：页面顶部填 Lender 名称 + 官网公开准则页网址 →「➕ 添加 / 更新数据源」。未填网址的行显示 ❌ Not connected，无法更新。
- 一键更新：点某个类型格的 ⟳ Update → 系统到该行官网重新抓取该类型准则，先清除该 Lender 该类型的旧条目再写入最新结果，并刷新更新时间（约 10–30 秒）。
- 每行网址可随时在行内修改（💾 保存）；「子页数」默认 0 = 自动：普通数据源抓取该网站发现的全部准则子页（上限 40），类型专属页（如 TMW 的 HMO 专页）只抓该页本身；想只抓前几页可自行填数字。
- 更新后的条目立即进入 Lender Criteria 准则库（带 官网抓取 徽章）并参与 AI 检索；也可在 Lender Criteria 页的「网页抓取准则 · 待审核」卡片里逐条核对。
2.7 系统级独占操作
- 批准 / 驳回 broker 准则修订（通知铃铛）。
- 修改任意客户的执行贷款顾问（影响 broker 可见客户范围）。
- 配置 Zoho WorkDrive 连接（云端自动取客户文件的前提）。
- 用户与权限管理（待开发：建 compliance 账号、重置密码、新建 broker）。
3. Individual Broker（贷款顾问）使用说明
账号示例：sherry / Ey2026Sherry、hannah / Ey2026Hannah、anna / Ey2026Anna、nan / Ey2026Nan
Broker 主要面向自己名下客户做日常运营：匹配银行、查准则、查利率、维护客户档案、用 AI 助手问答。
3.1 功能操作台
- ① New Case Matching：同 Admin，全量可用。
- ② Update Client Data Base：可用。输入名下客户的 Deal Number → 系统自动取文件 → 写入档案信息记录，并扫描客户文件夹全部资料自动填档（身份证/地址/工资/税务/Deal 等，见 Admin 章节的说明）。若 Deal 无对应客户档案，系统会先按出生日期/姓名查重：同一客户只增加关联 Deal（🔗），确认是新客户才自动建档（🆕）。自动填档的内容都标为「待核对」，请在客户档案页复核后再用于正式的材料准备。
- ④ Zoho WorkDrive 连接：不可见（仅 Admin 可配）。
3.2 Lender Criteria Research
- 合并搜索：选贷款类型 + 多条件（AND）查看同时满足的银行。
- 关键词类别浏览：选贷款类型 → 点 9 个关键词类别之一 → 展开该类别下的具体准则问题，查看各家银行结论。
- 新建搜索关键词：提交后状态为 pending，需 Admin 批准后才发布到团队；待审 角标显示在条目上。
- 修订既有条目：点「✏️ 修改」提交修订 → pending → Admin 批准后正式生效；KB / Paradigm 修订存
data/criteriaEdits.json动态覆盖读取。 - Criteria AI 助手：自然语言查询准则，中文问题靠术语表检索英文准则。
3.3 Rate Finding
- 仅查看利率（不可新增 / 修改 / 删除）。
3.4 Existing Client Data Base
- 客户档案查询：按 Deal ID / 姓 / 名搜索，仅显示自己名下客户（执行贷款顾问匹配当前用户 username / name）。
- 我的所有客户列表：只显示自己名下客户；邮箱 / 手机号按合规要求服务端强制隐藏（即使前端尝试提交也无效）。
- 行内编辑：仅可编辑自己名下客户的档案（地址 / 房产 / 收入 / 记录 / 公司 / Deal + 申请人基本情况），无需 Admin 审批，立即生效。
- 修改执行贷款顾问：无权（仅 Admin 可改）。
- 新增客户：无权（建议走「按 Deal Number 更新」触发自动建档后再补全字段）。
3.5 Case Study Base
- 只读浏览本机构成交案例。
4. Compliance（合规）使用说明
Compliance 角色以"只读审计"为核心，可查看全部数据用于合规审计，但不可修改任何数据、不可执行资料更新。
4.1 功能操作台
- ① New Case Matching：只读，可看匹配结果，不可保存。
- ② Update Client Data Base：不可用（按钮置灰，API 返回 403）。
- ④ Zoho WorkDrive 连接：不可见。
4.2 Lender Criteria Research
- 只读浏览准则库，不可新建 / 修订 / 审批。
- Criteria AI 助手可用（只读查询）。
4.3 Rate Finding
- 只读查看利率。
4.4 Existing Client Data Base
- 客户档案查询：可查全部客户档案（含联系方式）。
- 我的所有客户列表：显示全部客户，邮箱 / 手机号可见（合规审计需要）。
- 行内编辑：不可用（无 ✏️ / ✕ / + 添加 按钮）。
4.5 Case Study Base
- 只读浏览。
4.6 待开发
- Compliance 账号尚未正式建立（默认权限已就位，需要时联系 Admin 开通）。
5. 重要数据与文件位置
| 文件 / 数据 | 用途 | 位置 | 谁可写 |
|---|---|---|---|
| clients.json | 客户列表（id / 姓名 / 联系方式 / 贷款需求） | data/clients.json | Admin（含自动建档） |
| profiles/*.json | 客户完整档案（6 大 Section + Deal 历史 + 信息记录） | profiles/<base>.json | Admin + 名下 Broker |
| rules.json | 利率规则 + 本机构成交案例（evidence 字段） | data/rules.json | Admin |
| kb.json | Knowledge Bank 准则库（91 行 3356 条） | data/kb.json | Admin（修订走覆盖） |
| paradigm.json | PARADIGM 准则库 | data/paradigm.json | Admin（修订走覆盖） |
| customCriteria.json | Broker 自录关键词 | data/customCriteria.json | Admin（Broker 提交 → 审批） |
| criteriaEdits.json | KB / Paradigm 修订覆盖层 | data/criteriaEdits.json | Admin（Broker 提交 → 审批） |
| criteriaWeb.json | 从银行官网抓取的准则条目（带来源网址与日期） | data/criteriaWeb.json | Admin（抓取勾选入库 / Lender Update） |
| criteriaImports.json | 抓取/更新审计记录（最近 200 次） | data/criteriaImports.json | Admin |
| lenderSources.json | Lender Update 数据源（银行 × 官网网址 × 各类型更新时间） | data/lenderSources.json | Admin（仅） |
| notifications.json | 待审批通知（pending 准则修订） | data/notifications.json | Admin（批准后清除） |
| zohoConfig.json | Zoho WorkDrive 凭据 + 团队/根目录 ID | data/zohoConfig.json | Admin（仅） |
| importConfig.json | 源文件目录配置 | data/importConfig.json | Admin |
| aiConfig.json | OpenAI 兼容 Key（未配置时降级本地检索）+ criteriaSources 数据源开关（kb/paradigm/web/custom，缺省=全部） | data/aiConfig.json | Admin |
| users.json | 账号 + sha256 密码 | data/users.json | Admin（待开发 UI） |
| Z 盘源文件 | 客户 Fact Find / Suitability / Offer 等原始文档 | Z:/04 Operation/Client/Numbered Client List/<deal>/ | 本机（云端走 Zoho WorkDrive） |
| Zoho WorkDrive | 云端客户文件（Aura Hexaa TEAM 版） | My Folders → 中台客户服务部 → Client（292 子目录） | 服务器 OAuth2 直连 |
6. 常见操作流程
6.1 新客户上门
- 在「功能操作台 → ① New Case Matching」选择贷款类型，填写客户基本情况，匹配可贷银行。
- 若客户已有 Fact Find / Suitability 文件但资料库无档案：到「② Update Client Data Base」输入 Deal Number → 系统自动建档（🆕）+ 写入信息记录。
- 到「Existing Client Data Base → 客户档案查询」打开新档案，用 ✏️ / + 添加 补全身份 / 地址 / 收入 / 房产等字段。
- 到「Lender Criteria Research」用关键词或 AI 助手核对所选银行的具体准入条款。
- 到「Rate Finding」查利率；如需更细，可在准则页向 Admin 提交修订建议。
6.2 准则修订流（Broker → Admin）
- Broker 在「Lender Criteria Research」找到要修订的条目，点「✏️ 修改」提交修订。
- 修订进入 pending，存
data/criteriaEdits.json，条目右侧显示 待审 角标。 - Admin 右上角🔔通知铃铛显示待审数量，进入「Lender Criteria Research」审批。
- Admin 批准 → 修订正式发布、全团队可见、铃铛数减 1；驳回 → 修订标记 rejected，broker 收到反馈。
6.3 按单号更新现有客户档案
- Broker / Admin 在「功能操作台 → ② Update Client Data Base」输入 Deal Number（多个用逗号或空格分隔）。
- 系统自动到 Z 盘（本地）或 Zoho WorkDrive（云端）找最新修改的文件，按「文件名含该 Deal 号」优先匹配。
- 下载并提取文本（PDF 用 pdftotext，docx/xlsx/pptx 用 Python zipfile + regex）。
- 写入对应客户档案的「信息记录（待核对）」，更新该 Deal 的源文件路径，列入 conflictsAndPending 待人工核对。
- 到「Existing Client Data Base」打开客户档案，人工核对信息记录与原档案，按需更新各 Section。
6.4 Admin 配置 Zoho WorkDrive（一次性）
- 在 Zoho API Console 创建 Client，获取 Client ID / Secret。
- 在工作台「功能操作台 → ④ Zoho WorkDrive 连接」填入凭据，scope 选
WorkDrive.files.READ,ZohoFiles.files.READ,WorkDrive.team.READ,WorkDrive.teamfolders.READ。 - 点「授权 Zoho 账号」跳转 Zoho 完成同意 → 回调
/oauth/zoho自动换 token。 - 用目录选择器定位到 My Folders → 中台客户服务部 → Client，点「设为根目录」。
- 此后云端服务器即可直接读 Zoho 客户文件，不依赖本机 Z 盘。
6.5 新增一个 Lender 的官方准则更新（Admin）
- 找到该银行的公开（无需登录）准则页网址，例如
https://www.nationwide-intermediary.co.uk/lending-criteria。 - 到「Lender Update」Tab 顶部：填 Lender 名称 + 网址 →「➕ 添加 / 更新数据源」→ 该行显示 ✅ Connected。
- 点该行对应 Mortgage Type 格子的 ⟳ Update → 系统自动抓取并替换旧条目，刷新更新时间与条数。
- 到「Lender Criteria Research → 网页抓取准则 · 待审核」逐条核对抓取结果，误抓的删除。
- 此后任何时候怀疑准则过期，回到 Lender Update 再点一次 Update 即可一键刷新。
- 注意：需要登录的中介门户（Knowledge Bank / PARADIGM 等）不适用此功能，仍走原有导入渠道。
7. 待开发功能
- 客户 PORTAL 注册 + ZOHO 表格（新客户自助提交资料）。
- 客户 PORTAL 自助查看 / 修改档案。
- 功能操作台 ③ 批量上传 / 批量下载导出 / 查看报告。
- Compliance 账号正式建立与 UI 完善。
- Rate Sourcing Tool（独立利率源工具）。
- 案例库 6 类分类校准（Let to Buy / HMO / Semi-Comm / 过桥暂 0 案例）。
- 利率库补 BTL / HMO / 过桥产品。
版本：v3 ｜ 更新日期：2026-09-12 ｜ 维护：Empower Yield 贷款顾问工作台