Rust金融科技开发指南：FinTech领域约束、设计模式与最佳实践

domain-fintech by zhanghandong/rust-skills

422 周安装量

920 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/zhanghandong/rust-skills --skill domain-fintech

系统架构金融科技 Rust

🇨🇳中文介绍

FinTech 领域

第 3 层：领域约束

领域约束 → 设计影响

领域规则	设计约束	Rust 实现含义
审计追踪	不可变记录	Arc，无突变
精确性	不使用浮点数	rust_decimal
一致性	事务边界	清晰的所有权
合规性	完整日志记录	结构化追踪
可复现性	确定性执行	无竞态条件

关键约束

金融精度

RULE: Never use f64 for money
WHY: Floating point loses precision
RUST: Use rust_decimal::Decimal

审计要求

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

PostgreSQL表设计最佳实践：核心规则、数据类型选择与常见陷阱详解

9,600 周安装

Flutter状态管理教程：MVVM与Provider实现单向数据流和架构模式

1,100 周安装

股票分析工具 - 一键生成NVDA、TSLA、AAPL等股票情感分析报告

759 周安装

专业交易计划生成器：创建纪律严明、基于规则的风险管理交易策略

714 周安装

"Need immutable transaction records"
    ↓ m09-domain: Model as Value Objects
    ↓ m01-ownership: Use Arc for shared immutable data

"Need precise decimal math"
    ↓ m05-type-driven: Newtype for Currency/Amount
    ↓ rust_decimal: Use Decimal type

"Need transaction boundaries"
    ↓ m12-lifecycle: RAII for transaction scope
    ↓ m09-domain: Aggregate boundaries

用途	库
十进制数学运算	rust_decimal
日期/时间	chrono, time
UUID	uuid
序列化	serde
验证	validator

模式	目的	实现
货币新类型	类型安全	`struct Amount(Decimal);`
事务	原子操作	事件溯源
审计日志	可追踪性	带追踪 ID 的结构化日志
分类账	复式记账	借方/贷方余额

use rust_decimal::Decimal;

#[derive(Clone, Debug, PartialEq)]
pub struct Amount {
    value: Decimal,
    currency: Currency,
}

impl Amount {
    pub fn new(value: Decimal, currency: Currency) -> Self {
        Self { value, currency }
    }

    pub fn add(&self, other: &Amount) -> Result<Amount, CurrencyMismatch> {
        if self.currency != other.currency {
            return Err(CurrencyMismatch);
        }
        Ok(Amount::new(self.value + other.value, self.currency))
    }
}

错误	领域违规	修复方法
使用 f64	精度丢失	rust_decimal
可变事务	审计追踪中断	不可变 + 事件
使用字符串表示金额	无验证	已验证的新类型
静默溢出	资金消失	检查算术运算

约束	第 2 层模式	第 1 层实现
不可变记录	事件溯源	Arc, Clone
事务范围	聚合	拥有的子对象
精度	值对象	rust_decimal 新类型
线程安全共享	共享不可变	Arc (非 Rc)

何时使用	参见
值对象设计	m09-domain
不可变数据的所有权	m01-ownership
共享的 Arc	m02-resource
错误处理	m13-domain-error

🇺🇸English

FinTech Domain

Layer 3: Domain Constraints

Domain Constraints → Design Implications

Domain Rule	Design Constraint	Rust Implication
Audit trail	Immutable records	Arc, no mutation
Precision	No floating point	rust_decimal
Consistency	Transaction boundaries	Clear ownership
Compliance	Complete logging	Structured tracing
Reproducibility	Deterministic execution	No race conditions

Critical Constraints

Financial Precision

RULE: Never use f64 for money
WHY: Floating point loses precision
RUST: Use rust_decimal::Decimal

Audit Requirements

RULE: All transactions must be immutable and traceable
WHY: Regulatory compliance, dispute resolution
RUST: Arc<T> for sharing, event sourcing pattern

Consistency

RULE: Money can't disappear or appear
WHY: Double-entry accounting principles
RUST: Transaction types with validated totals

Trace Down ↓

From constraints to design (Layer 2):

"Need immutable transaction records"
    ↓ m09-domain: Model as Value Objects
    ↓ m01-ownership: Use Arc for shared immutable data

"Need precise decimal math"
    ↓ m05-type-driven: Newtype for Currency/Amount
    ↓ rust_decimal: Use Decimal type

"Need transaction boundaries"
    ↓ m12-lifecycle: RAII for transaction scope
    ↓ m09-domain: Aggregate boundaries

Key Crates

Purpose	Crate
Decimal math	rust_decimal
Date/time	chrono, time
UUID	uuid
Serialization	serde
Validation	validator

Design Patterns

Pattern	Purpose	Implementation
Currency newtype	Type safety	`struct Amount(Decimal);`
Transaction	Atomic operations	Event sourcing
Audit log	Traceability	Structured logging with trace IDs
Ledger	Double-entry	Debit/credit balance

Code Pattern: Currency Type

use rust_decimal::Decimal;

#[derive(Clone, Debug, PartialEq)]
pub struct Amount {
    value: Decimal,
    currency: Currency,
}

impl Amount {
    pub fn new(value: Decimal, currency: Currency) -> Self {
        Self { value, currency }
    }

    pub fn add(&self, other: &Amount) -> Result<Amount, CurrencyMismatch> {
        if self.currency != other.currency {
            return Err(CurrencyMismatch);
        }
        Ok(Amount::new(self.value + other.value, self.currency))
    }
}

Common Mistakes

Mistake	Domain Violation	Fix
Using f64	Precision loss	rust_decimal
Mutable transaction	Audit trail broken	Immutable + events
String for amount	No validation	Validated newtype
Silent overflow	Money disappears	Checked arithmetic

Trace to Layer 1

Constraint	Layer 2 Pattern	Layer 1 Implementation
Immutable records	Event sourcing	Arc, Clone
Transaction scope	Aggregate	Owned children
Precision	Value Object	rust_decimal newtype
Thread-safe sharing	Shared immutable	Arc (not Rc)

Related Skills

When	See
Value Object design	m09-domain
Ownership for immutable	m01-ownership
Arc for sharing	m02-resource
Error handling	m13-domain-error

Weekly Installs

422

Repository

zhanghandong/rust-skills

GitHub Stars

920

First Seen

Jan 20, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode383

codex371

gemini-cli365

github-copilot355

amp318

kimi-cli314