项目概览
GoldWatch.live 是一个用于监控黄金（XAU/USD）核心驱动因素的实时宏观仪表盘。它把市场价格、利率、美元强弱、风险情绪、大宗商品、持仓、技术趋势、交易时段、提醒、新闻与 AI 辅助分析整合到同一个操作界面中。
这个产品具备 SaaS 特征，例如账户、分层方案、订阅、提醒与认证后的实时访问。但我会将它主要归类为数据工作流项目，因为它的核心价值来自采集、标准化、评分、推送与解释市场输入的 pipeline。
这是一个由我个人企划、设计、编码、部署并持续维护的产品。
产品架构
- Monorepo 产品系统 - 项目使用 pnpm workspaces 与 Turborepo 组织，包含 React Router 仪表盘、Hono REST API、独立 Hono SSE 服务、crawler pipeline、Laravel 认证与账单网关，以及用于 schema、常量、套餐层级和评分配置的共享 TypeScript packages。
- 读写分离 - crawler 按计划将市场与宏观记录写入 PostgreSQL。API 只从数据库读取，不会因为用户请求直接触发外部数据抓取，因此延迟更可控，数据供给层的使用也更容易管理。
- Provider 抽象 - 数据输入通过 provider interface 和指标配置管理。每个 symbol 或指标可以定义抓取频率、fallback 行为、历史覆盖与计算值，而不把 UI 绑定到具体采集细节。
- Gold Score 模型 - factor-weighted score 将宏观输入转换为 0-100 分数，并提供 bias、coverage、freshness 与因子拆解。评分综合了真实利率、美元强弱、风险情绪、大宗商品环境、持仓与技术趋势，并使用有界 normalization。
- 实时推送层 - 独立 SSE 服务只对最新价格表进行单点轮询，再将变化 fan-out 给已连接客户端。这样可以避免每个客户端各自建立 polling loop，使实时推送下的数据库负载接近 O(1)。
- 分层数据服务 - 匿名、免费与 Pro 用户会获得不同的 polling 与 streaming 行为。系统结合 activity state、tab coordination、CDN caching、rate limit 与 graceful degradation，在实时体验和基础设施成本之间取得平衡。
- AI 新闻工作流 - 新闻 pipeline 抓取公开财经标题，进行去重、黄金相关性过滤、情绪评分、影响摘要，并通过 API 与 dashboard drawer 提供给用户。
- 认证与账单边界 - Laravel 签发 ES256 JWT，API 与 SSE 服务可在本地验证 token，无需每次查询数据库。Stripe billing 与 plan claims 则用于驱动 Pro 用户的实时连接和进阶功能。
关键功能
- 黄金宏观仪表盘 - 在同一个 dashboard 中查看 XAUUSD、宏观因子卡片、市场时段、精选指标与上下文状态。
- 可解释 Gold Score - 除了单一 0-100 分数，也能查看因子级 bias、coverage、freshness 与底层信号贡献。
- 实时价格更新 - 认证用户通过 SSE 接收实时更新，访客和后台状态用户则根据层级策略切换为 polling。
- 交易时段上下文 - 仪表盘显示主要交易时段与市场状态，帮助用户把价格变化放回时间背景中理解。
- AI 辅助分析 - 支持按需或定时生成宏观条件摘要，解释当前环境对黄金的潜在压力方向。
- 过滤后的新闻流 - 公开财经标题会先经过相关性过滤、评分、摘要与标签处理，而不是直接展示噪声较高的原始 feed。
- 提醒与订阅 - 账户、提醒行为和 Pro 订阅功能让这个数据工作流具备持续使用的 SaaS 产品形态。
