一个商品转卖的网站
Access rate limit exceeded. Please log in to continue.
产品管理系统
一个功能完整的产品管理系统,支持商品管理、商家管理、报价管理等功能,采用前后端分离架构。
功能特性
核心功能
- 用户认证与授权:基于JWT的身份验证,支持邀请码注册
- 商品管理:商品的增删改查,支持查看详情、加入私有
- 商家管理:商家信息管理,支持加入私有功能
- 报价管理:创建报价单,自动计算价格,支持导出JPG格式报价单
- 商品分类:商品分类管理
- 数据统计:仪表盘展示各类数据统计信息
权限控制
- 用户只能编辑自己创建的商品和商家
- 支持私有资源管理,加入私有的资源仅自己可见
- 公共广场隐藏私有资源
报价功能
- 自动计算商品原价(单价+邮费+5元)
- 自动计算最低价格(单价+邮费)
- 支持手动报价和数量管理
- 自动计算三个总和价格
- 支持选中报价单导出为JPG格式
技术栈
后端
- 框架:FastAPI 0.110.0
- 数据库:PostgreSQL + SQLAlchemy 2.0.25
- 认证:JWT (python-jose)
- 密码加密:Passlib
- ASGI服务器:Uvicorn
- 数据库迁移:Alembic
前端
- 框架:React 18.2.0
- 构建工具:Vite 5.2.0
- UI组件库:Material UI 5.15.18
- 路由:React Router DOM 6.23.1
- HTTP客户端:Axios 1.7.2
- 图片导出:html2canvas 1.4.1
开发工具
- Python版本:3.8+
- Node.js版本:16+
项目结构
product-management/
├── backend/ # 后端代码
│ ├── api/ # API路由
│ │ ├── __init__.py
│ │ ├── health.py # 健康检查
│ │ └── versioning_example.py
│ ├── categories/ # 商品分类模块
│ │ ├── crud.py
│ │ ├── models.py
│ │ ├── routes.py
│ │ └── schemas.py
│ ├── core/ # 核心功能
│ │ ├── config.py # 配置管理
│ │ ├── database.py # 数据库连接
│ │ ├── auth.py # 认证相关
│ │ ├── logger.py # 日志系统
│ │ └── ...
│ ├── products/ # 商品模块
│ │ ├── crud.py
│ │ ├── models.py
│ │ ├── routes.py
│ │ └── schemas.py
│ ├── shops/ # 商家模块
│ │ ├── crud.py
│ │ ├── models.py
│ │ ├── routes.py
│ │ └── schemas.py
│ ├── quotes/ # 报价模块
│ │ ├── crud.py
│ │ ├── models.py
│ │ ├── routes.py
│ │ └── schemas.py
│ ├── users/ # 用户模块
│ │ ├── crud.py
│ │ ├── models.py
│ │ ├── routes.py
│ │ └── schemas.py
│ ├── shared/ # 共享资源模块
│ │ ├── crud.py
│ │ ├── models.py
│ │ ├── routes.py
│ │ └── schemas.py
│ ├── services/ # 业务服务层
│ ├── tests/ # 测试代码
│ ├── main.py # 应用入口
│ └── .env.production.example # 生产环境配置示例
├── frontend/ # 前端代码
│ ├── src/
│ │ ├── components/ # 公共组件
│ │ │ └── AppLayout.jsx
│ │ ├── pages/ # 页面组件
│ │ │ ├── Dashboard.jsx # 仪表盘
│ │ │ ├── Login.jsx # 登录页
│ │ │ ├── ProductInfo.jsx # 商品管理
│ │ │ ├── ProductPlaza.jsx # 商品广场
│ │ │ ├── ShopInfo.jsx # 商家管理
│ │ │ ├── ShopPlaza.jsx # 商家广场
│ │ │ ├── Quote.jsx # 报价管理
│ │ │ └── ProductCategory.jsx # 商品分类
│ │ ├── router/ # 路由配置
│ │ │ ├── index.jsx
│ │ │ └── PrivateRoute.jsx
│ │ ├── utils/ # 工具函数
│ │ │ ├── request.js # API请求封装
│ │ │ └── message.jsx # 消息提示
│ │ ├── App.jsx # 根组件
│ │ ├── main.jsx # 入口文件
│ │ └── index.css # 全局样式
│ ├── index.html
│ ├── package.json
│ └── vite.config.js
├── requirements.txt # Python依赖
└── README.md # 项目文档
快速开始
环境要求
- Python 3.8+
- Node.js 16+
- PostgreSQL 12+
- Git
后端安装
- 克隆项目
git clone <repository-url>
cd product-management/backend
- 创建虚拟环境
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
- 安装依赖
pip install -r ../requirements.txt
- 配置环境变量
cp .env.development.example .env
# 编辑.env文件,配置数据库连接等信息
- 初始化数据库
# 创建PostgreSQL数据库
createdb product_management
# 创建数据库表
python -c "from core.database import engine, Base; Base.metadata.create_all(bind=engine)"
- 启动后端服务
uvicorn main:app --host 0.0.0.0 --port 8000 --reload
后端API文档:http://localhost:8000/docs
前端安装
- 进入前端目录
cd frontend
- 安装依赖
npm install
- 启动开发服务器
npm run dev
前端访问地址:http://localhost:5173
配置说明
后端配置
后端配置文件位于 backend/core/config.py,支持多环境配置:
- 开发环境:
.env.development - 测试环境:
.env.testing - 生产环境:
.env.production
主要配置项:
# 数据库配置
DATABASE_URL=postgresql+pg8000://user:password@localhost:5432/product_management
# JWT配置
SECRET_KEY=your-secret-key-here
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30
# CORS配置
CORS_ORIGINS=["http://localhost:3000", "http://localhost:5173"]
# 邀请码配置
INVITATION_CODE=default-invitation-code
# 日志配置
LOG_LEVEL=INFO
LOG_DIR=./logs
前端配置
前端API地址配置位于 frontend/src/utils/request.js:
const baseURL = 'http://localhost:8000'; // 修改为实际后端地址
部署指南
Linux服务器部署
详细的部署步骤请参考项目文档中的部署指南,主要包括:
- 服务器环境准备:安装Python、Node.js、PostgreSQL、Nginx
- 数据库配置:创建数据库和用户
- 后端部署:上传代码、安装依赖、配置环境变量
- 前端部署:构建生产版本、配置Nginx
- 配置Systemd服务:实现后端服务的自动启动和监控
- 配置SSL证书:使用Let's Encrypt免费证书
- 配置防火墙:开放必要端口
详细部署流程请参考项目文档。
API文档
后端提供完整的API文档,访问地址:
- Swagger UI:http://localhost:8000/docs
- ReDoc:http://localhost:8000/redoc
主要API端点
用户认证
POST /users/register- 用户注册POST /users/login- 用户登录GET /users/me- 获取当前用户信息
商品管理
GET /products/- 获取商品列表POST /products/- 创建商品GET /products/{id}- 获取商品详情PUT /products/{id}- 更新商品DELETE /products/{id}- 删除商品
商家管理
GET /shops/- 获取商家列表POST /shops/- 创建商家GET /shops/{id}- 获取商家详情PUT /shops/{id}- 更新商家DELETE /shops/{id}- 删除商家
报价管理
GET /quotes/- 获取报价列表POST /quotes/- 创建报价GET /quotes/{id}- 获取报价详情PUT /quotes/{id}- 更新报价DELETE /quotes/{id}- 删除报价
共享资源
POST /shared/products/{id}/add- 加入私有商品POST /shared/shops/{id}/add- 加入私有商家
使用说明
用户注册
- 访问系统登录页面
- 输入邀请码(默认:
default-invitation-code) - 填写用户名、密码等信息完成注册
商品管理
- 创建商品:在商品管理页面点击"添加商品"
- 编辑商品:只能编辑自己创建的商品
- 查看详情:点击"查看详情"查看商品完整信息
- 加入私有:在商品广场点击"加入私有"将商品添加到私有列表
商家管理
- 创建商家:在商家管理页面点击"添加商家"
- 编辑商家:只能编辑自己创建的商家
- 加入私有:在商家广场点击"加入私有"将商家添加到私有列表
报价管理
- 创建报价:点击"添加报价",选择商品后自动计算价格
- 价格计算:
- 商品原价 = 商品单价 + 邮费 + 5元
- 最低价格 = 商品单价 + 邮费
- 导出报价:选中报价单,点击"导出选中报价单"生成JPG格式报价单
数据统计
仪表盘展示以下统计数据:
- 自己创建的商品数量
- 加入私有的商品数量
- 商品总数
- 自己创建的商家数量
- 加入私有的商家数量
- 商家总数
- 报价数量
- 分类数量
开发指南
代码规范
- Python:遵循PEP 8规范
- JavaScript/React:遵循Airbnb JavaScript规范
- Git提交:使用清晰的提交信息
测试
# 后端测试
cd backend
pytest
# 前端测试
cd frontend
npm test
添加新功能
-
后端:
- 在对应模块目录下创建
models.py、schemas.py、crud.py、routes.py - 在
backend/api/__init__.py中注册路由
- 在对应模块目录下创建
-
前端:
- 在
frontend/src/pages/下创建页面组件 - 在
frontend/src/router/index.jsx中配置路由
- 在
常见问题
后端启动失败
问题:数据库连接失败
解决:检查 .env 文件中的数据库配置是否正确
问题:端口被占用 解决:修改启动命令中的端口号,或停止占用端口的进程
前端启动失败
问题:依赖安装失败
解决:删除 node_modules 目录,重新运行 npm install
问题:API请求失败
解决:检查 request.js 中的 baseURL 是否正确
权限问题
问题:无法编辑商品/商家
解决:确保商品/商家的 user_id 与当前登录用户的ID一致
贡献指南
欢迎贡献代码!请遵循以下步骤:
- Fork 本项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
许可证
本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。
联系方式
如有问题或建议,请通过以下方式联系:
- 提交 Issue
- 发送邮件至:[your-email@example.com]
更新日志
v1.0.0 (2024-01-01)
- 初始版本发布
- 实现用户认证和授权
- 实现商品管理功能
- 实现商家管理功能
- 实现报价管理功能
- 实现数据统计功能
- 实现报价单导出功能
致谢
感谢所有为本项目做出贡献的开发者!