530A Model calculator

530A Model

530amodel.com — 一款免费的、隐私优先、移动端优先的情景规划计算器，适用于 530A 监护退休账户（“Trump Accounts”）。

无需登录。不会收集电子邮件。没有商业化。所有计算均在浏览器中运行。

使用公共 API / MCP 服务

该引擎可免费调用——无需密钥，不存储任何内容，并请注明来源为 530amodel.com：

• JSON API — https://api.530amodel.com（POST /v1/project、GET /v1/rules、 GET /v1/returns；OpenAPI 3.1，包含完整的 请求/响应架构）
• MCP 服务 — https://mcp.530amodel.com（可流式传输的 HTTP；工具 project_530a、 explain_530a、search、fetch；注册表名称 com.530amodel/calculator）。可作为 Claude 和 ChatGPT 的自定义连接器使用，也可与 Anthropic/OpenAI Agent API 配合使用。
• 文档和平台快速入门 — 530amodel.com/api · 机器可读映射：llms.txt、 llms-full.txt
• 联系 — [email protected]

结构

packages/
  engine/     # pure TS calculation engine — zero deps, deterministic, integer-cents money
  config/     # legal figures + sources + verifiedAt + feature flags (single source of truth)
  ui/         # design tokens, shared components, charts
apps/
  web/        # Astro static site (widget, advanced model, content pages)
  workers/    # Cloudflare Workers: analytics beacon, rollup cron, newsfeed cron, email
  api/        # public calculator API (wraps the engine; OpenAPI; cache-by-input-hash)
  mcp/        # read-only MCP server (project_530a / explain_530a)
reference/    # Python reference implementation + golden-vector generator
e2e/          # Playwright specs (user journeys UC-1..UC-7)

不可妥协的原则

1. 财务计算必须精确、确定，并经过独立测试（Python 参考实现的黄金测试向量必须与 TS 引擎 精确到分）。
2. 静态优先：计算在客户端完成；一百万名用户的成本与一名用户相同。
3. 依赖项尽可能少，不含 PII，攻击面小，所有内容均在 CI 中扫描。
4. 所有面向用户的声明都必须诚实：范围需标注为估算值，法律数据须注明来源，未经验证的条目须通过 OFF 功能标志隐藏（packages/config/src/flags.ts）。

开发

pnpm install
pnpm check     # lint + typecheck + test + build (same as CI)
pnpm --filter @530a/web dev

Node ≥ 22、pnpm ≥ 11。引擎数值规范：金额以整分表示（bigint），余额在每个月度步骤都按四舍六入五成双规则量化，显示格式仅通过 formatMoney 处理。

免责声明

此工具仅提供教育用途的估算，不构成财务、税务或法律建议。市场预测具有概率性，并非保证。