fintech-engineer

金融科技工程师

用途

提供有关构建金融科技系统的专家指导，确保遵循正确的会计原则、符合法规要求并进行高精度计算。专长包括账本设计、支付处理架构和金融数据完整性。

适用场景

• 设计复式记账系统或会计数据库
• 实现高精度金融计算（避免浮点误差）
• 构建支付处理流水线
• 确保符合 PCI-DSS 或 SOX
• 与银行 API（Plaid、Stripe 等）集成
• 处理货币兑换和多币种系统
• 为金融交易实现审计追踪
• 设计对账系统

快速入门

在以下情况下调用此技能：

• 构建账本或会计系统
• 实现要求精确的金融计算
• 设计支付处理架构
• 确保符合法规要求（PCI、SOX、PSD2）
• 集成银行或支付 API

在以下情况下不要调用：

• 不涉及金融场景的通用数据库设计 → 使用 /database-administrator
• 不涉及金融特性的 API 集成 → 使用 /api-designer
• 通用安全加固 → 使用 /security-engineer
• 基于 ML 的欺诈检测模型 → 使用 /ml-engineer

决策框架

Financial Calculation Needed?
├── Yes: Currency/Money
│   └── Use decimal types (never float)
│   └── Store amounts in smallest unit (cents)
├── Yes: Interest/Rates
│   └── Use arbitrary precision libraries
│   └── Document rounding rules explicitly
└── Ledger Design?
    ├── Simple: Single-entry (tracking only)
    └── Auditable: Double-entry (debits = credits)

核心工作流

1. 复式记账账本实现

1. 定义会计科目表（资产、负债、权益、收入、费用）
2. 创建包含借方／贷方列的日记账分录表
3. 实现余额验证（借方总额 = 贷方总额）
4. 添加包含不可变交易日志的审计追踪
5. 构建对账查询

2. 支付处理流水线

1. 验证支付请求和幂等键
2. 创建待处理交易记录
3. 使用重试逻辑调用支付处理器
4. 通过 Webhook 处理异步确认
5. 以原子方式更新账本分录
6. 生成收据和审计日志

3. 精度计算设置

1. 选择合适的数值类型（DECIMAL、NUMERIC、BigDecimal）
2. 根据货币定义精度（小数位数）
3. 按司法管辖区实施舍入规则
4. 创建计算辅助函数
5. 添加溢出／下溢验证

最佳实践

• 以最小货币单位（分、派萨）为整数存储金额
• 使用 DECIMAL／NUMERIC 数据库类型，绝不使用 FLOAT
• 为所有金融操作实现幂等性
• 为每笔交易保留不可变的审计日志
• 对多表更新使用数据库事务
• 记录舍入规则并保持一致地应用

反模式

反模式	问题	正确做法
使用浮点数表示金额	精度误差会累积	使用十进制类型或整数分
可变的交易记录	审计追踪被破坏	仅追加日志、软删除
缺少幂等性	可能重复扣款	在所有变更操作中使用幂等键
可审计系统采用单式记账	无法对账或审计	使用余额平衡的复式记账日记账
税率硬编码	导致合规失败	使用配置驱动且带版本管理的规则