OpenStock

OpenStock 是一款面向开发者、学生和独立投资者的开源股票市场分析工具，旨在成为昂贵商业金融平台（如 Bloomberg、TradingView 高级版）的轻量替代方案。

它基于现代 Web 技术栈构建，支持实时股价追踪、自定义提醒、公司基本面查看与个性化观察列表管理，所有功能永久免费，代码完全公开，致力于推动金融信息的开放与可及性。

⚠️ 温馨提示：
OpenStock 不是券商，也不提供交易功能。数据来源于第三方 API（如 Finnhub），可能存在延迟，不构成任何投资建议。

为什么做 OpenStock？

在当前的金融市场中，高质量的数据分析工具往往被高昂的订阅费用所垄断。初学者难以入门，独立研究者缺乏可靠资源，而社区协作的空间也因封闭系统而受限。

开发者相信：

• 知识不应被付费墙封锁
• 工具应服务于所有人，而非少数人
• 开源可以成为金融普惠的技术路径

因此，开发团队发起了 OpenStock —— 一个由社区驱动、透明运作、永不收费的开源项目。

✅ 开发团队的承诺

• 永久免费使用，无隐藏功能
• 不收集用户行为数据用于商业化
• 不封锁核心功能或设置试用期限
• 所有代码托管于 GitHub，欢迎审查与贡献

开发团队依靠捐赠和志愿者维护运行，目标是打造一个真正属于公众的金融数据平台。

技术架构

OpenStock 采用现代化全栈技术组合，兼顾性能、可维护性与用户体验：

💡 项目以 TypeScript 为主（占比约 93%），确保类型安全与开发效率。

核心功能一览

用户认证与个性化设置

• 支持邮箱+密码注册/登录
• 使用 Better Auth + MongoDB 实现安全身份验证
• 首次登录后引导填写偏好：
  • 所在国家
  • 投资目标（成长型/稳健型）
  • 风险承受能力
  • 偏好行业（科技、医疗、能源等）

这些信息将用于后续内容个性化。

全局搜索与快捷操作

• 支持通过股票代码或公司名称快速查找
• 内置 Cmd/Ctrl + K 命令面板，一键跳转页面、搜索股票
• 输入时自动防抖，减少无效请求
• 空闲状态下展示热门股票推荐

观察列表（Watchlist）

• 每位用户拥有独立的观察列表
• 数据存储于 MongoDB，支持跨设备同步
• 可随时添加/删除股票，实时更新价格变动

股票详情页

进入个股页面后，可查看以下信息：

• TradingView 图表集成：
  • K线图（日/周/月）
  • 技术指标（MACD、RSI、布林带等）
  • 与标普500等基准对比
• 公司基本信息：
  • 行业分类、市值、市盈率
  • 高管团队、总部位置
• 财务摘要：
  • 收入趋势、净利润、资产负债表关键项
• 最新市场新闻（来自 Finnhub）

市场概览面板

首页提供全局视角：

• 市场热力图：可视化各大板块涨跌情况
• 实时报价滚动栏：关注主流指数与热门股
• 头条新闻流：聚合财经媒体与官方公告

所有图表均使用 TradingView 小部件渲染，保证专业级视觉体验。

邮件通知与自动化

通过 Inngest 实现后台任务调度：

• 每日市场摘要邮件：
  • 包含用户观察列表中股票的当日表现
  • 主要指数走势回顾
  • 关键财经新闻摘要
• AI 个性化欢迎邮件：
  • 基于用户填写的投资偏好，调用 Gemini 生成定制化内容

提示：邮件功能需用户主动启用，并绑定有效邮箱。

用户体验细节

• 默认启用深色主题，保护长时间阅读视力
• 支持键盘快捷键操作（如 Esc 关闭弹窗、/ 聚焦搜索）
• 响应式布局，适配桌面与平板浏览器
• 界面简洁，去除冗余广告与推广内容