268 lines
6.1 KiB
Markdown
268 lines
6.1 KiB
Markdown
# 智能项目定价模型
|
||
|
||
医美行业智能项目定价系统，帮助机构精准核算成本、分析市场行情、智能生成定价建议。
|
||
|
||
## 功能特性
|
||
|
||
- **成本核算**：精准计算项目成本，明确最低成本线
|
||
- **市场行情**：收集竞品价格，分析市场定价区间
|
||
- **智能定价**：AI 智能分析，生成定价建议
|
||
- **利润模拟**：模拟不同定价的利润情况，敏感性分析
|
||
|
||
## 技术栈
|
||
|
||
### 后端
|
||
- Python 3.11 + FastAPI
|
||
- SQLAlchemy + MySQL 8.0
|
||
- 遵循瑞小美 AI 接入规范
|
||
|
||
### 前端
|
||
- Vue 3 + TypeScript + Vite
|
||
- Element Plus + Tailwind CSS
|
||
- Pinia + Axios
|
||
- ESLint（已配置）
|
||
|
||
### 部署
|
||
- Docker + Docker Compose
|
||
- Nginx 反向代理
|
||
- Let's Encrypt SSL
|
||
|
||
## 快速开始
|
||
|
||
### 开发环境
|
||
|
||
1. 复制环境配置文件
|
||
|
||
```bash
|
||
cp env.dev.example .env.dev
|
||
```
|
||
|
||
2. 启动开发环境
|
||
|
||
```bash
|
||
docker-compose -f docker-compose.dev.yml up -d
|
||
```
|
||
|
||
3. 访问应用
|
||
- 前端：http://localhost:3000（支持热重载）
|
||
- 后端 API：http://localhost:8000
|
||
- API 文档：http://localhost:8000/docs
|
||
|
||
### 生产环境部署
|
||
|
||
#### 方式一：使用部署脚本（推荐）
|
||
|
||
1. 配置环境变量
|
||
|
||
```bash
|
||
cp env.example .env
|
||
# 编辑 .env 文件，修改数据库密码、密钥等
|
||
vim .env
|
||
chmod 600 .env
|
||
```
|
||
|
||
2. 执行部署
|
||
|
||
```bash
|
||
./scripts/deploy.sh deploy
|
||
```
|
||
|
||
3. 配置 SSL 证书
|
||
|
||
```bash
|
||
DOMAIN=pricing.yourcompany.com EMAIL=admin@yourcompany.com ./scripts/setup-ssl.sh request
|
||
```
|
||
|
||
#### 方式二：手动部署
|
||
|
||
1. 复制并修改环境配置
|
||
|
||
```bash
|
||
cp env.example .env
|
||
# 编辑 .env 文件
|
||
vim .env
|
||
# 修改以下配置：
|
||
# - MYSQL_ROOT_PASSWORD: 数据库 root 密码
|
||
# - MYSQL_PASSWORD: 应用数据库密码
|
||
# - SECRET_KEY: 应用密钥（32位以上随机字符串）
|
||
# - CORS_ORIGINS: 允许的跨域来源
|
||
|
||
chmod 600 .env
|
||
```
|
||
|
||
2. 创建外部网络（如未创建）
|
||
|
||
```bash
|
||
docker network create scrm_network
|
||
```
|
||
|
||
3. 启动服务
|
||
|
||
```bash
|
||
docker-compose up -d
|
||
```
|
||
|
||
4. 配置 Nginx 反向代理
|
||
- 将 `nginx.conf` 添加到主机 Nginx 配置中
|
||
- 修改域名为实际域名
|
||
- 配置 SSL 证书
|
||
|
||
5. 刷新 Nginx DNS 缓存
|
||
|
||
```bash
|
||
docker exec nginx_proxy nginx -s reload
|
||
```
|
||
|
||
## 运维管理
|
||
|
||
### 服务管理
|
||
|
||
```bash
|
||
# 查看状态
|
||
./scripts/deploy.sh status
|
||
|
||
# 重启服务
|
||
./scripts/deploy.sh restart
|
||
|
||
# 停止服务
|
||
./scripts/deploy.sh stop
|
||
|
||
# 查看日志
|
||
./scripts/deploy.sh logs
|
||
```
|
||
|
||
### 数据库备份
|
||
|
||
```bash
|
||
# 执行备份
|
||
./scripts/backup.sh backup
|
||
|
||
# 查看备份列表
|
||
./scripts/backup.sh list
|
||
|
||
# 恢复备份
|
||
./scripts/backup.sh restore <备份文件>
|
||
```
|
||
|
||
### 监控检查
|
||
|
||
```bash
|
||
# 完整监控报告
|
||
./scripts/monitor.sh report
|
||
|
||
# 快速检查
|
||
./scripts/monitor.sh quick
|
||
```
|
||
|
||
### 定时任务（建议配置）
|
||
|
||
```bash
|
||
# 每日凌晨 2 点备份
|
||
0 2 * * * /opt/pricing-model/scripts/backup.sh backup
|
||
|
||
# 每 5 分钟健康检查
|
||
*/5 * * * * /opt/pricing-model/scripts/monitor.sh quick
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
智能项目定价模型/
|
||
├── 后端服务/ # FastAPI 后端
|
||
│ ├── app/
|
||
│ │ ├── main.py # 应用入口
|
||
│ │ ├── config.py # 配置管理
|
||
│ │ ├── database.py # 数据库连接
|
||
│ │ ├── models/ # SQLAlchemy 模型
|
||
│ │ ├── schemas/ # Pydantic 模型
|
||
│ │ ├── routers/ # API 路由
|
||
│ │ ├── services/ # 业务逻辑
|
||
│ │ └── middleware/ # 中间件
|
||
│ ├── prompts/ # AI 提示词
|
||
│ ├── tests/ # 单元测试
|
||
│ ├── Dockerfile
|
||
│ └── requirements.txt
|
||
├── 前端应用/ # Vue 3 前端
|
||
│ ├── src/
|
||
│ │ ├── views/ # 页面组件
|
||
│ │ ├── components/ # 通用组件
|
||
│ │ ├── stores/ # Pinia 状态
|
||
│ │ ├── api/ # API 封装
|
||
│ │ └── router/ # 路由配置
|
||
│ ├── eslint.config.js # ESLint 配置
|
||
│ ├── Dockerfile
|
||
│ └── package.json
|
||
├── scripts/ # 运维脚本
|
||
│ ├── deploy.sh # 部署脚本
|
||
│ ├── backup.sh # 备份脚本
|
||
│ ├── setup-ssl.sh # SSL 配置
|
||
│ └── monitor.sh # 监控脚本
|
||
├── docs/ # 文档
|
||
│ ├── 用户操作手册.md
|
||
│ └── 系统管理手册.md
|
||
├── docker-compose.yml # 生产环境编排
|
||
├── docker-compose.dev.yml # 开发环境编排
|
||
├── nginx.conf # Nginx 反向代理配置
|
||
└── init.sql # 数据库初始化脚本
|
||
```
|
||
|
||
## 功能模块
|
||
|
||
| 阶段 | 模块 | 状态 |
|
||
|------|------|------|
|
||
| M1 | 基础搭建（框架、基础数据管理） | ✅ 已完成 |
|
||
| M2 | 核心功能（成本核算、市场行情） | ✅ 已完成 |
|
||
| M3 | 智能功能（智能定价、利润模拟） | ✅ 已完成 |
|
||
| M4 | 测试优化（单元测试、性能优化） | ✅ 已完成 |
|
||
| M5 | 上线部署（部署脚本、文档） | ✅ 已完成 |
|
||
|
||
## API 文档
|
||
|
||
启动后端服务后访问：
|
||
- Swagger UI：http://localhost:8000/docs
|
||
- ReDoc：http://localhost:8000/redoc
|
||
|
||
> 生产环境默认关闭 API 文档，如需开启请设置 `DEBUG=true`
|
||
|
||
## 文档
|
||
|
||
- [用户操作手册](docs/用户操作手册.md) - 功能使用指南
|
||
- [系统管理手册](docs/系统管理手册.md) - 部署运维指南
|
||
|
||
## 规范遵循
|
||
|
||
本项目严格遵循：
|
||
- 《瑞小美系统技术栈标准与字符标准》
|
||
- 《瑞小美 AI 接入规范》
|
||
|
||
## 环境要求
|
||
|
||
### 硬件
|
||
|
||
| 资源 | 最低配置 | 推荐配置 |
|
||
|------|----------|----------|
|
||
| CPU | 2 核 | 4 核 |
|
||
| 内存 | 4 GB | 8 GB |
|
||
| 磁盘 | 40 GB | 100 GB |
|
||
|
||
### 软件
|
||
|
||
- Docker 24.0+
|
||
- Docker Compose 2.20+
|
||
- Linux (推荐 Ubuntu 22.04 / Debian 12)
|
||
|
||
## 安全注意事项
|
||
|
||
- `.env` 文件权限必须设置为 600
|
||
- 禁止将 `.env` 文件提交到 Git
|
||
- 生产环境必须修改默认密码
|
||
- API Key 从门户系统获取，禁止硬编码
|
||
|
||
## License
|
||
|
||
Copyright © 2026 瑞小美技术团队
|
||
|
||
---
|
||
|
||
*瑞小美技术团队 · 2026*
|