OA基管家 (Fund Manager) 项目概览

[双重定位]

1. 🚀 AI全栈开发实战项目：从零构建企业级金融 AI Agent 的最佳教案。
2. 📊 科学持仓管理工具：程序员专用的基金资产分析神器，拒绝情绪化操作。

🎯 项目简介

OA基管家 不仅仅是一个工具，更是一个AI时代的开发范本。本项目演示了如何将大模型（LLM）、LangChain、OCR（光学字符识别）与传统的全栈技术（React + Node.js）深度融合，构建一个解决实际问题的金融类应用。

对于基金持仓用户

• 📊 透明化管理：多维度透视账户持仓，告别糊涂账。
• 📉 科学分析：基于净值的客观回撤与收益分析，不涉及任何主观推荐。
• 📈 ETF 策略：均线与动量模型支持，辅助客观交易决策。
• 🤖 AI日报：每日自动生成资产简报，关键信息一目了然。

对于开发者

它是学习以下技术的最佳实践：

• AI Agent 开发：集成 GPT/Gemini 进行金融数据解读。
• 全栈架构：React 18 (CSR) + Express + SQLite3 轻量化部署。
• 数据工程：爬虫、OCR 识别、定时任务调度。

✨ 核心功能

🛠️ 资产管理 (To User)

• 多账户体系：支持家庭多成员、多平台账户隔离管理。
• 健康度分析：通过标准差、最大回撤等数学模型分析持仓风险。
• 自动化日报：每日定时推送资产变动情况邮件。
• 偏离度追踪：监控官方净值与估算值的偏差。
• ETF 轮动：支持自定义均线与动量参数，自动生成交易信号。

👨‍💻 技术特性 (To Dev)

• OCR 智能识别：截图自动解析持仓信息，精准提取基金名称与金额。
• 动态 SEO：基于 react-helmet-async 的单页应用 SEO 方案。
• 响应式设计：TailwindCSS 驱动的 Mobile First 体验。
• 插件化架构：模块化的数据源与分析策略设计。

🏗️ 技术栈列表

前端 (Frontend)

• Core: React 18, TypeScript, Vite 5
• UI: TailwindCSS, Lucide Icons, Recharts
• AI/SEO: Tesseract.js (OCR), react-helmet-async

后端 (Backend)

• Runtime: Node.js 18+
• Framework: Express.js
• Database: SQLite3
• Services: Nodemailer (邮件), node-cron (调度), Axios (爬虫)

🚀 快速开始

# 1. 克隆仓库
git clone https://github.com/yourusername/oa-fund-manager.git

# 2. 安装依赖
npm install

# 3. 启动开发服务器 (前后端连调)
npm run dev

# 访问地址: http://localhost:5173