# AriStockAI

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

## 服务一览

各服务端口信息如下：
- data-service：提供 A 股 / 美股行情数据（Python），端口：8000
- quant-service：量化因子计算服务（Python），端口：8001
- emotion-service：情绪分析服务（Python），端口：8002
- recommend-service：融合推荐服务（C#），端口：8003
- user-service：用户管理服务（C#），端口：8004
- frontend：前端交互界面（Vue.js），端口：80
- gitea-webhook：监听 Gitea Webhook 进行持续部署，未在 docker-compose.yml 中明确端口
- traefik：作为统一网关实现服务发现和路由，主入口端口：80，Dashboard 端口：8080

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

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

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

**通信协议**：
- RESTful API（80% 服务）

## 🔧 环境变量
```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
```


## 📄 许可
[MIT](LICENSE)

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