# AriStockAI

面向个人投资者的智能选股分析系统，采用微服务架构构建。

## 服务一览
- data-service：提供 A 股 / 美股行情数据（Python）
- quant-service：量化因子计算服务（Python）
- emotion-service：情绪分析服务（Python）
- recommend-service：融合推荐服务（C#）
- user-service：用户管理服务（C#）
- frontend：前端交互界面（Vue.js）
- gitea-webhook：监听 Gitea Webhook 进行持续部署
- traefik：作为统一网关实现服务发现和路由

## 使用方式
```bash
docker compose up --build
```

## 📦 技术架构
![架构图](docs/architecture.svg)

**核心组件**：
- 服务发现：Consul
- API网关：Traefik with Let's Encrypt
- 消息队列：RabbitMQ
- 数据存储：PostgreSQL + Redis

**通信协议**：
- RESTful API（80% 服务）
- gRPC（quant-service 与 data-service）

## 🔧 环境变量
```env
CONSUL_HTTP_ADDR=consul:8500
ALPHAVANTAGE_API_KEY=your_key
```

## 📚 API 文档
访问统一入口：`http://localhost/docs`

## 🛠 开发指南
```bash
# Python 服务
pip install -r requirements.txt
uvicorn app:app --reload

# C# 服务
dotnet run
```

## 🤝 贡献规范
1. 分支命名：feat/xxx, fix/xxx
2. 提交信息遵循 Conventional Commits
3. 提交 PR 前需通过 SonarQube 检测

## 📄 许可
[MIT](LICENSE)

访问入口：`http://localhost` 或你的服务器域名（如 AriStockAI.com）