mcpField
D
dinero-currency-patterns

dinero-currency-patterns

github.com/dinerojs开发2345 次安装35 周前更新
代码仓库

关于 dinero-currency-patterns

面向 Dinero.js 开发者的货币处理模式参考,涵盖类型安全、汇率转换、数据库存储和支付服务映射。

主要功能

  1. 01定义类型安全的自定义货币
  2. 02验证货币代码
  3. 03使用缩放金额处理汇率
  4. 04数据库存储模式
  5. 05映射支付服务格式

适用场景

  1. 01定义自定义货币类型
  2. 02按小数汇率进行转换
  3. 03在数据库存储多币种金额
  4. 04将 Dinero 对象映射为支付格式

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/dinerojs/skills --skill dinero-currency-patterns

安装后在 Claude Code 中输入/dinero-currency-patterns确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

rules/
_sections.md
convert-reusable.md
convert-scaled-rates.md
payment-services.md
storage-database.md
storage-no-money-type.md
types-as-const.md
types-currency-mismatch.md
types-lookup-validation.md

详细介绍

Dinero.js 货币模式

使用 Dinero.js 处理货币的模式:类型安全、转换、自定义货币、数据库存储和支付服务集成。

适用场景

在以下情况下,请参考这些指南:

  • 使用 convert 在不同货币之间转换
  • 定义自定义货币(例如,加密货币、忠诚度积分)
  • 根据外部输入动态查找货币
  • 在数据库中存储货币值
  • 集成支付服务(Stripe、PayPal、Square)

按优先级划分的规则类别

优先级类别影响前缀
1类型安全高types-
2转换高convert-
3存储高storage-
4支付集成中payment-

快速参考

1. 类型安全(高)
  • types-as-const - 使用 as const satisfies 定义自定义货币,确保编译时安全
  • types-currency-mismatch - TypeScript 会在编译时捕获操作中的货币不匹配问题
  • types-lookup-validation - 在运行时验证来自外部来源的货币代码
2. 转换(高)
  • convert-scaled-rates - 对于小数汇率,请使用缩放金额,而不是浮点数
  • convert-reusable - 使用高阶模式构建可复用的转换器函数
3. 存储(高)
  • storage-database - 将金额、货币代码和精度分别存储在不同的列中
  • storage-no-money-type - 在多币种应用中避免使用 PostgreSQL 的 money 类型
4. 支付集成(中)
  • payment-services - 使用专用辅助函数将 Dinero 对象映射为支付服务格式

使用方法

阅读各规则文件,了解详细说明和代码示例:

rules/types-as-const.md
rules/convert-scaled-rates.md

每个规则文件都包含:

  • 简要说明其重要性
  • 错误代码示例及说明
  • 正确代码示例及说明
  • 补充背景信息和参考资料

评论

支持 Markdown