1. 课程导入

在银行核心系统中，账户模型是几乎所有业务的地基。无论是存款、贷款、支付、理财，还是对账、计息、风控，最终都要落到“钱记在哪个账户上、这个账户属于谁、它和别的账户是什么关系”这几个问题上。很多系统在早期只设计了单一的“客户—账号”结构，随着产品线扩张，很快会遇到一个客户持有多个产品、一个产品下需要分项管理资金、不同币种和期限需要独立核算等需求，于是“子账户”概念被引入。本课程围绕银行客户账户与子账户模型设计展开，共30章，从概念、建模、落地到复盘逐步推进。本章作为导入，先建立账户体系的整体认知，明确学习目标与课程结构，并说明贯穿全程的实战项目。

一、银行账户体系概览：从客户到分户账

银行账户体系通常不是一张表，而是一组有层次关系的对象集合。理解它，关键是分清“客户”“账户”“子账户”“分户账/明细”这几个层次。客户是法律与业务主体，账户是客户与银行之间某类业务关系的载体，子账户是在一个主账户下按币种、期限、用途或产品分项设立的核算单元，分户账则记录具体余额与交易明细。它们之间的关系可以用下面的结构图来理解。

从图中可以看到，客户是顶层主体，主账户按业务类型横向展开，子账户在主账户下按币种、用途或产品分项，分户账承载最终余额与流水。这个层次决定了后续建模时的主键设计、余额汇总方式以及交易路由逻辑。若层次混乱，最常见的结果是余额对不上、交易重复记账或对账困难。

二、学习目标与课程结构

本课程的目标不是只讲概念，而是让学员能够独立完成一套可落地的账户与子账户模型设计。具体目标包括：理解账户体系的分层逻辑与业务语义；掌握主账户、子账户、分户账的建模方法；能够设计账户开立、变更、冻结、销户等状态流转；能够处理多币种、多产品、多期限下的余额与交易路由；能够识别并规避常见设计误区。课程结构按“认知—建模—落地—复盘”四段推进，共30章。

三、实战项目说明：个人银行账户与子账户模型

贯穿本课程的实战项目是“个人银行账户与子账户模型设计与实现”。项目背景设定为一家中型银行需要支持个人客户开立活期、定期和理财三类主账户，并在活期主账户下按币种设立子账户，支持人民币、美元和港币。项目要求实现账户开立、子账户挂接、余额查询、交易记账、冻结解冻和销户等核心能力。项目采用分层建模思路，先定义领域对象，再映射到数据库表，最后通过接口暴露服务。

在项目初期，建议先明确几个关键参数，例如账户号生成规则、子账户编号规则、币种精度和余额类型。下面是一段示例配置，用于定义账户模型的基础参数：

account:
  mainAccountPrefix: "62"
  subAccountPrefix: "88"
  currencyPrecision:
    CNY: 2
    USD: 2
    HKD: 2
  balanceTypes:
    - available
    - frozen
    - pending
  statusFlow:
    - CREATED
    - ACTIVE
    - FROZEN
    - CLOSED

这段配置看似简单，但它决定了后续余额计算、交易校验和状态流转的实现方式。例如，余额类型中同时存在 available 和 frozen，意味着每次记账都要区分可用余额与冻结余额；状态流转中 FROZEN 可以回到 ACTIVE，但 CLOSED 不可逆，这些约束必须在模型层体现。

四、常见误区与复盘视角

在账户与子账户模型设计中，初学者最容易陷入几个误区。第一，把子账户当成独立账户处理，导致客户维度汇总困难；第二，余额只设计一个字段，无法区分可用、冻结和在途；第三，状态流转没有约束，出现已销户账户仍能记账的情况；第四，忽略币种精度，导致金额计算出现分位误差。这些问题在项目初期不明显，一旦交易量上升或对账频率提高，就会集中暴露。