34 KiB
34 KiB
智能项目定价模型 - 系统架构设计
版本：v1.0
创建日期：2026-01-19
最后更新：2026-01-19
负责人：待定
1. 架构概述
1.1 设计原则
| 原则 | 说明 |
|---|---|
| 前后端分离 | 前端 Vue 3 + 后端 FastAPI，独立部署 |
| 容器化部署 | 所有服务运行在 Docker 容器中 |
| 统一 AI 服务 | 通过 shared_backend.AIService 调用 AI 能力 |
| 配置集中管理 | API Key 等配置从门户系统统一获取 |
1.2 技术选型
遵循《瑞小美系统技术栈标准与字符标准》：
后端技术栈
| 技术 | 版本/说明 |
|---|---|
| Python | 3.11 |
| FastAPI | 异步 Web 框架 |
| SQLAlchemy | ORM |
| MySQL | 8.0 |
| Pydantic | 数据验证 |
前端技术栈
| 技术 | 说明 |
|---|---|
| Vue 3 | 前端框架 |
| TypeScript | 类型安全 |
| Vite | 构建工具 |
| pnpm | 包管理器 |
| Element Plus | UI 组件库 |
| Tailwind CSS | 样式方案 |
| Axios | HTTP 客户端 |
| Pinia | 状态管理 |
| ESLint | 代码规范（必须配置） |
| ECharts | 图表可视化 |
基础设施
| 技术 | 说明 |
|---|---|
| Docker | 容器运行时 |
| Docker Compose | 服务编排 |
| Nginx | 反向代理 |
2. 系统架构图
2.1 整体架构
┌─────────────────────────────────┐
│ 用户浏览器 │
└────────────────┬────────────────┘
│ HTTPS
▼
┌──────────────────────────────────────────────────────────────────────────────┐
│ Nginx 反向代理容器 │
│ - SSL 终止 │
│ - 路由分发：pricing.xxx.com → 对应服务 │
│ - 静态资源缓存 │
└────────────────┬──────────────────────────────────────┬──────────────────────┘
│ │
│ / │ /api/*
▼ ▼
┌────────────────────────────────┐ ┌────────────────────────────────────────┐
│ 前端容器 (Vue 3) │ │ 后端容器 (FastAPI) │
│ │ │ │
│ - 定价系统 SPA 应用 │ │ - RESTful API │
│ - 端口：80 │ │ - 业务逻辑处理 │
│ │ │ - 端口：8000 │
└────────────────────────────────┘ └──────────────────┬─────────────────────┘
│
┌───────────────────────────────────────┼───────────────────┐
│ │ │
▼ ▼ ▼
┌────────────────────────────┐ ┌──────────────────────────────┐ ┌─────────────┐
│ MySQL 数据库容器 │ │ 门户系统 (SCRM) │ │ AI 服务商 │
│ │ │ │ │ │
│ - 业务数据存储 │ │ GET /api/ai/internal/config │ │ 4sapi.com │
│ - AI 调用日志 │ │ - API Key 配置 │ │ OpenRouter │
│ - 端口：3306 │ │ - AI 配置管理 │ │ │
└────────────────────────────┘ └──────────────────────────────┘ └─────────────┘
2.2 后端架构（分层设计）
┌─────────────────────────────────────────────────────────────────────────────┐
│ API Layer (FastAPI Routers) │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ /cost/* │ │ /market/* │ │ /pricing/* │ │ /profit/* │ │
│ │ 成本核算 │ │ 市场行情 │ │ 智能定价 │ │ 利润模拟 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└────────────────────────────────────────┬────────────────────────────────────┘
│
┌────────────────────────────────────────▼────────────────────────────────────┐
│ Service Layer (业务逻辑) │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
│ │ CostService │ │ MarketService │ │ PricingService │ │
│ │ 成本计算服务 │ │ 市场分析服务 │ │ 定价建议服务 │ │
│ └─────────────────┘ └─────────────────┘ └─────────────────┘ │
│ ┌─────────────────┐ ┌─────────────────────────────────────┐ │
│ │ ProfitService │ │ shared_backend.AIService │ │
│ │ 利润模拟服务 │ │ AI 服务（统一调用） │ │
│ └─────────────────┘ └─────────────────────────────────────┘ │
└────────────────────────────────────────┬────────────────────────────────────┘
│
┌────────────────────────────────────────▼────────────────────────────────────┐
│ Repository Layer (数据访问) │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
│ │ CostRepository │ │MarketRepository │ │PricingRepository│ │
│ └─────────────────┘ └─────────────────┘ └─────────────────┘ │
└────────────────────────────────────────┬────────────────────────────────────┘
│
┌────────────────────────────────────────▼────────────────────────────────────┐
│ Model Layer (SQLAlchemy Models) │
│ Project | Material | Equipment | FixedCost | Competitor | PricingPlan ... │
└────────────────────────────────────────┬────────────────────────────────────┘
│
▼
┌─────────────────────┐
│ MySQL Database │
└─────────────────────┘
2.3 前端架构
┌─────────────────────────────────────────────────────────────────────────────┐
│ Vue 3 Application │
├─────────────────────────────────────────────────────────────────────────────┤
│ Views (页面组件) │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Dashboard │ │ Cost │ │ Market │ │ Pricing │ │ Profit │ │
│ │ 仪表盘 │ │ 成本核算 │ │ 市场行情 │ │ 智能定价 │ │ 利润模拟 │ │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
├─────────────────────────────────────────────────────────────────────────────┤
│ Components (通用组件) │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Charts │ │ Forms │ │ Tables │ │ Dialogs │ ... │
│ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │
├─────────────────────────────────────────────────────────────────────────────┤
│ Composables (组合式函数) │
│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
│ │ useCost() │ │ useMarket() │ │ usePricing() │ │
│ └──────────────────┘ └──────────────────┘ └──────────────────┘ │
├─────────────────────────────────────────────────────────────────────────────┤
│ Stores (Pinia 状态管理) │
│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
│ │ costStore │ │ marketStore │ │ pricingStore │ │
│ └──────────────────┘ └──────────────────┘ └──────────────────┘ │
├─────────────────────────────────────────────────────────────────────────────┤
│ API (Axios 封装) │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ api/cost.ts | api/market.ts | api/pricing.ts | api/profit.ts │ │
│ └──────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘
3. 目录结构
3.1 项目根目录
智能项目定价模型/
├── 规划文档/ # 规划文档目录
│ ├── 01_产品需求文档(PRD).md
│ ├── 02_系统架构设计.md
│ ├── 03_数据库设计.md
│ ├── 04_开发计划与进度.md
│ └── 05_API接口设计.md
│
├── 后端服务/ # FastAPI 后端
│ ├── app/
│ │ ├── __init__.py
│ │ ├── main.py # 应用入口
│ │ ├── config.py # 配置管理
│ │ ├── database.py # 数据库连接
│ │ │
│ │ ├── models/ # SQLAlchemy 模型
│ │ │ ├── __init__.py
│ │ │ ├── project.py
│ │ │ ├── cost.py
│ │ │ ├── market.py
│ │ │ └── pricing.py
│ │ │
│ │ ├── schemas/ # Pydantic 模型
│ │ │ ├── __init__.py
│ │ │ ├── project.py
│ │ │ ├── cost.py
│ │ │ ├── market.py
│ │ │ └── pricing.py
│ │ │
│ │ ├── routers/ # API 路由
│ │ │ ├── __init__.py
│ │ │ ├── cost.py
│ │ │ ├── market.py
│ │ │ ├── pricing.py
│ │ │ └── profit.py
│ │ │
│ │ ├── services/ # 业务逻辑
│ │ │ ├── __init__.py
│ │ │ ├── cost_service.py
│ │ │ ├── market_service.py
│ │ │ ├── pricing_service.py
│ │ │ └── profit_service.py
│ │ │
│ │ └── repositories/ # 数据访问
│ │ ├── __init__.py
│ │ └── ...
│ │
│ ├── prompts/ # AI 提示词（必须）
│ │ ├── pricing_advice_prompts.py
│ │ ├── market_analysis_prompts.py
│ │ └── profit_forecast_prompts.py
│ │
│ ├── tests/ # 测试
│ │ └── ...
│ │
│ ├── Dockerfile
│ ├── requirements.txt
│ └── .env.example
│
├── 前端应用/ # Vue 3 前端
│ ├── src/
│ │ ├── main.ts
│ │ ├── App.vue
│ │ │
│ │ ├── views/ # 页面组件
│ │ │ ├── Dashboard.vue
│ │ │ ├── cost/
│ │ │ ├── market/
│ │ │ ├── pricing/
│ │ │ └── profit/
│ │ │
│ │ ├── components/ # 通用组件
│ │ │ └── ...
│ │ │
│ │ ├── composables/ # 组合式函数
│ │ │ └── ...
│ │ │
│ │ ├── stores/ # Pinia 状态管理
│ │ │ └── ...
│ │ │
│ │ ├── api/ # API 封装
│ │ │ └── ...
│ │ │
│ │ ├── router/ # 路由配置
│ │ │ └── index.ts
│ │ │
│ │ ├── styles/ # 样式
│ │ │ └── ...
│ │ │
│ │ └── types/ # TypeScript 类型
│ │ └── ...
│ │
│ ├── public/
│ ├── index.html
│ ├── vite.config.ts
│ ├── tailwind.config.js
│ ├── tsconfig.json
│ ├── eslint.config.js # ESLint 配置（必须）
│ ├── package.json
│ ├── Dockerfile
│ └── .env.example
│
├── docker-compose.yml # 服务编排
├── nginx.conf # Nginx 配置
├── .env.example # 环境变量模板
└── .gitignore # Git 忽略配置（含 .env）
4. 部署架构
4.1 Docker Compose 服务定义
version: '3.8'
services:
# 前端服务
pricing-frontend:
build: ./前端应用
container_name: pricing-frontend
restart: unless-stopped
networks:
- pricing_network
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:80"]
interval: 30s
timeout: 10s
retries: 3
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"
deploy:
resources:
limits:
memory: 256M
# 后端服务
pricing-backend:
build: ./后端服务
container_name: pricing-backend
restart: unless-stopped
env_file:
- .env
environment:
- DATABASE_URL=${DATABASE_URL}
- PORTAL_CONFIG_API=${PORTAL_CONFIG_API}
depends_on:
pricing-mysql:
condition: service_healthy
networks:
- pricing_network
- scrm_network # 连接门户系统网络
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
interval: 30s
timeout: 10s
retries: 3
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"
deploy:
resources:
limits:
memory: 512M
# 数据库服务
pricing-mysql:
image: mysql:8.0.36
container_name: pricing-mysql
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
MYSQL_DATABASE: pricing_model
MYSQL_USER: ${MYSQL_USER}
MYSQL_PASSWORD: ${MYSQL_PASSWORD}
volumes:
- pricing_mysql_data:/var/lib/mysql
networks:
- pricing_network
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
interval: 30s
timeout: 10s
retries: 3
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"
networks:
pricing_network:
driver: bridge
scrm_network:
external: true # 连接已存在的 SCRM 网络
volumes:
pricing_mysql_data:
4.2 Nginx 配置示例
# pricing.xxx.com
server {
listen 443 ssl http2;
server_name pricing.xxx.com;
ssl_certificate /etc/nginx/ssl/xxx.com.pem;
ssl_certificate_key /etc/nginx/ssl/xxx.com.key;
# 前端静态资源
location / {
proxy_pass http://pricing-frontend:80;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
# 后端 API
location /api/ {
proxy_pass http://pricing-backend:8000/api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# WebSocket 支持（如需流式输出）
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 300s;
}
}
# HTTP 重定向
server {
listen 80;
server_name pricing.xxx.com;
return 301 https://$server_name$request_uri;
}
4.3 环境变量配置
# .env.example
# 数据库配置
DATABASE_URL=mysql+pymysql://pricing_user:password@pricing-mysql:3306/pricing_model?charset=utf8mb4
MYSQL_ROOT_PASSWORD=root_password
MYSQL_USER=pricing_user
MYSQL_PASSWORD=password
# 门户系统配置
PORTAL_CONFIG_API=http://portal-backend:8000/api/ai/internal/config
# 应用配置
APP_ENV=production
DEBUG=false
SECRET_KEY=your-secret-key
⚠️ 敏感信息管理规范：
.env文件权限必须设置为 600：chmod 600 .env.env文件禁止提交到 Git（已在.gitignore中排除）- 生产环境建议使用 Docker Secrets 管理敏感数据
4.4 镜像源配置（强制）
遵循《瑞小美系统技术栈标准》，Dockerfile 中必须配置国内镜像源：
后端 Dockerfile 示例：
FROM python:3.11.9-slim
# 配置阿里云 APT 源
RUN sed -i 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list.d/debian.sources
# 配置阿里云 pip 源
RUN pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
# ... 其余配置
前端 Dockerfile 示例：
FROM node:20.11-alpine
# 配置阿里云 npm 源
RUN npm config set registry https://registry.npmmirror.com
# 使用 pnpm
RUN npm install -g pnpm
RUN pnpm config set registry https://registry.npmmirror.com
# ... 其余配置
Docker 镜像源（在 /etc/docker/daemon.json 配置）：
{
"registry-mirrors": [
"https://kjphlxn2.mirror.aliyuncs.com",
"https://docker.m.daocloud.io"
]
}
⚠️ 禁用 latest 标签：必须使用具体版本号，如
python:3.11.9-slim、node:20.11-alpine、mysql:8.0.36
4.5 网络配置补充说明
DNS 刷新（重要）： 后端容器重启后，Nginx 可能缓存旧的 DNS 解析，需执行以下命令刷新：
docker exec nginx_proxy nginx -s reload
建议在部署脚本中自动执行此操作。
4.6 前端 ESLint 配置（必须）
遵循《瑞小美系统技术栈标准》，前端必须配置 ESLint：
eslint.config.js 示例：
import js from '@eslint/js'
import vue from 'eslint-plugin-vue'
import typescript from '@typescript-eslint/eslint-plugin'
import typescriptParser from '@typescript-eslint/parser'
import vueParser from 'vue-eslint-parser'
export default [
js.configs.recommended,
...vue.configs['flat/recommended'],
{
files: ['**/*.{ts,tsx,vue}'],
languageOptions: {
parser: vueParser,
parserOptions: {
parser: typescriptParser,
ecmaVersion: 'latest',
sourceType: 'module',
},
},
plugins: {
'@typescript-eslint': typescript,
},
rules: {
'vue/multi-word-component-names': 'off',
'@typescript-eslint/no-unused-vars': 'warn',
'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
},
},
]
package.json scripts：
{
"scripts": {
"lint": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx",
"lint:fix": "eslint . --ext .vue,.js,.jsx,.cjs,.mjs,.ts,.tsx --fix"
}
}
⚠️ 提交代码前必须执行
pnpm lint检查
5. AI 服务集成架构
5.1 集成方式
遵循《瑞小美 AI 接入规范》，通过 shared_backend.AIService 统一调用：
┌─────────────────────────────────────────────────────────────────────────────┐
│ 定价系统后端 │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ PricingService │ │
│ │ │ │
│ │ # 调用 AI 生成定价建议 │ │
│ │ ai = AIService(module_code="pricing_model", db_session=db) │ │
│ │ response = await ai.chat(messages, prompt_name="pricing_advice") │ │
│ │ │ │
│ └──────────────────────────────────┬───────────────────────────────────┘ │
└─────────────────────────────────────┼───────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ shared_backend.AIService │
│ │
│ 1. 从门户系统获取 API Key 配置 │
│ 2. 降级策略：4sapi.com → OpenRouter.ai │
│ 3. 模型名称自动转换 │
│ 4. 调用日志记录到 ai_call_logs 表 │
│ │
└──────────────────────────────────────┬──────────────────────────────────────┘
│
┌────────────────────────┴────────────────────────┐
│ │
▼ ▼
┌─────────────────────────────────┐ ┌─────────────────────────────────┐
│ 4sapi.com（首选） │ │ OpenRouter.ai（备选） │
│ https://4sapi.com/v1/chat/... │ │ https://openrouter.ai/api/... │
└─────────────────────────────────┘ └─────────────────────────────────┘
5.2 提示词文件规范
文件位置：后端服务/prompts/
示例：pricing_advice_prompts.py
"""定价建议生成提示词"""
PROMPT_META = {
"name": "pricing_advice",
"display_name": "智能定价建议",
"description": "综合成本、市场、目标利润率，生成项目定价建议",
"module": "pricing_model",
"variables": ["project_name", "cost_data", "market_data", "target_margin"],
}
SYSTEM_PROMPT = """你是一位专业的医美行业定价分析师。你需要根据提供的成本数据、市场行情数据，
结合目标利润率，给出专业的定价建议。
分析时请考虑：
1. 成本结构的合理性
2. 市场竞争态势
3. 目标客群定位
4. 不同定价策略的适用场景
输出格式要求：
- 定价建议区间
- 推荐价格及理由
- 不同策略下的建议价格（引流款/利润款/高端款）
- 风险提示"""
USER_PROMPT = """请为以下项目生成定价建议：
## 项目信息
项目名称：{project_name}
## 成本数据
{cost_data}
## 市场行情
{market_data}
## 目标利润率
{target_margin}%
请给出详细的定价分析和建议。"""
6. 安全架构
6.1 网络安全
┌──────────────────────────────────────┐
│ 公网 │
└───────────────────┬──────────────────┘
│
│ 443 (HTTPS)
▼
┌───────────────────────────────────────────────────────────────────────────────┐
│ Nginx 容器 │
│ - SSL 终止 │
│ - 仅暴露 80/443 端口 │
│ - 请求过滤 │
└───────────────────────────────────────────┬───────────────────────────────────┘
│
│ Docker 内网
▼
┌───────────────────────────────────────────────────────────────────────────────┐
│ Docker Bridge Network (pricing_network) │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Frontend │ │ Backend │ │ MySQL │ │
│ │ 内网端口 │ │ 内网端口 │ │ 内网端口 │ │
│ │ 不暴露公网 │ │ 不暴露公网 │ │ 不暴露公网 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
└───────────────────────────────────────────────────────────────────────────────┘
6.2 认证授权
- 使用 OAuth 认证，与瑞小美 SCRM 系统统一
- JWT Token 进行 API 认证
- 基于角色的访问控制（RBAC）
6.3 敏感数据保护
| 数据类型 | 保护措施 |
|---|---|
| API Key | 从门户系统获取，禁止硬编码 |
| 数据库密码 | 环境变量，.env 文件权限 600 |
| 业务数据 | MySQL 加密传输，敏感字段脱敏 |
7. 监控与日志
7.1 健康检查
所有服务配置健康检查端点：
| 服务 | 端点 | 检查内容 |
|---|---|---|
| 后端 | /health |
应用运行状态、数据库连接 |
| 前端 | / |
Nginx 响应状态 |
| 数据库 | mysqladmin ping |
MySQL 服务状态 |
7.2 日志管理
- 格式：JSON 格式，便于收集分析
- 轮转：max-size 10MB，保留 3 个文件
- AI 调用日志：记录到
ai_call_logs表
7.3 监控指标
| 指标类型 | 监控内容 |
|---|---|
| 应用指标 | 请求量、响应时间、错误率 |
| AI 调用 | Token 消耗、成本、延迟、降级频率 |
| 资源指标 | CPU、内存、磁盘使用率 |
8. 扩展性设计
8.1 水平扩展
- 后端服务可多实例部署，通过 Nginx 负载均衡
- 前端静态资源可部署 CDN
8.2 功能扩展
- 模块化设计，新功能以独立模块形式添加
- AI 能力扩展通过新增提示词文件实现
9. 附录
9.1 参考文档
- 《瑞小美 AI 接入规范》
- 《瑞小美系统技术栈标准与字符标准》
- FastAPI 官方文档
- Vue 3 官方文档
瑞小美技术团队 · 2026-01-19