fintech-engineer

フィンテックエンジニア

目的

適切な会計原則、規制遵守、高精度な計算に基づく金融テクノロジーシステムの構築について、専門的なガイダンスを提供します。台帳設計、決済処理アーキテクチャ、金融データの完全性を専門とします。

使用する場面

• 複式簿記の台帳システムや会計データベースを設計する
• 高精度の金融計算を実装する（浮動小数点誤差を回避する）
• 決済処理パイプラインを構築する
• PCI-DSS または SOX への準拠を確保する
• 銀行 API（Plaid、Stripe など）と連携する
• 通貨換算や多通貨システムを扱う
• 金融取引の監査証跡を実装する
• 照合システムを設計する

クイックスタート

このスキルを呼び出す場面：

• 台帳システムや会計システムを構築する
• 精度が求められる金融計算を実装する
• 決済処理アーキテクチャを設計する
• 規制遵守（PCI、SOX、PSD2）を確保する
• 銀行 API や決済 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 は決して使用しない
• すべての金融処理に冪等性を実装する
• すべての取引について不変の監査ログを保持する
• 複数テーブルの更新にはデータベーストランザクションを使用する
• 丸め規則を文書化し、一貫して適用する

アンチパターン

アンチパターン	問題	適切な方法
金額に浮動小数点数を使用する	精度誤差が蓄積する	10 進数型またはセント単位の整数を使用する
変更可能な取引レコード	監査証跡が失われる	追記専用ログと論理削除を使用する
冪等性の欠如	二重請求が発生する可能性がある	すべての変更処理に冪等性キーを使用する
監査可能なシステムで単式簿記を使用する	照合や監査ができない	貸借が一致する仕訳を用いた複式簿記を使用する
税率のハードコード	コンプライアンス違反につながる	設定駆動のバージョン管理された規則を使用する