Product_Management:基于 FastAPI 与 React 的产品管理系统

一个商品转卖的网站

Branch1Tags0

产品管理系统

一个功能完整的产品管理系统,支持商品管理、商家管理、报价管理等功能,采用前后端分离架构。

功能特性

核心功能

  • 用户认证与授权:基于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

后端安装

  1. 克隆项目
git clone <repository-url>
cd product-management/backend
  1. 创建虚拟环境
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
  1. 安装依赖
pip install -r ../requirements.txt
  1. 配置环境变量
cp .env.development.example .env
# 编辑.env文件,配置数据库连接等信息
  1. 初始化数据库
# 创建PostgreSQL数据库
createdb product_management

# 创建数据库表
python -c "from core.database import engine, Base; Base.metadata.create_all(bind=engine)"
  1. 启动后端服务
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

后端API文档:http://localhost:8000/docs

前端安装

  1. 进入前端目录
cd frontend
  1. 安装依赖
npm install
  1. 启动开发服务器
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服务器部署

详细的部署步骤请参考项目文档中的部署指南,主要包括:

  1. 服务器环境准备:安装Python、Node.js、PostgreSQL、Nginx
  2. 数据库配置:创建数据库和用户
  3. 后端部署:上传代码、安装依赖、配置环境变量
  4. 前端部署:构建生产版本、配置Nginx
  5. 配置Systemd服务:实现后端服务的自动启动和监控
  6. 配置SSL证书:使用Let's Encrypt免费证书
  7. 配置防火墙:开放必要端口

详细部署流程请参考项目文档。

API文档

后端提供完整的API文档,访问地址:

主要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 - 加入私有商家

使用说明

用户注册

  1. 访问系统登录页面
  2. 输入邀请码(默认:default-invitation-code)
  3. 填写用户名、密码等信息完成注册

商品管理

  1. 创建商品:在商品管理页面点击"添加商品"
  2. 编辑商品:只能编辑自己创建的商品
  3. 查看详情:点击"查看详情"查看商品完整信息
  4. 加入私有:在商品广场点击"加入私有"将商品添加到私有列表

商家管理

  1. 创建商家:在商家管理页面点击"添加商家"
  2. 编辑商家:只能编辑自己创建的商家
  3. 加入私有:在商家广场点击"加入私有"将商家添加到私有列表

报价管理

  1. 创建报价:点击"添加报价",选择商品后自动计算价格
  2. 价格计算:
    • 商品原价 = 商品单价 + 邮费 + 5元
    • 最低价格 = 商品单价 + 邮费
  3. 导出报价:选中报价单,点击"导出选中报价单"生成JPG格式报价单

数据统计

仪表盘展示以下统计数据:

  • 自己创建的商品数量
  • 加入私有的商品数量
  • 商品总数
  • 自己创建的商家数量
  • 加入私有的商家数量
  • 商家总数
  • 报价数量
  • 分类数量

开发指南

代码规范

  • Python:遵循PEP 8规范
  • JavaScript/React:遵循Airbnb JavaScript规范
  • Git提交:使用清晰的提交信息

测试

# 后端测试
cd backend
pytest

# 前端测试
cd frontend
npm test

添加新功能

  1. 后端:

    • 在对应模块目录下创建 models.py、schemas.py、crud.py、routes.py
    • 在 backend/api/__init__.py 中注册路由
  2. 前端:

    • 在 frontend/src/pages/ 下创建页面组件
    • 在 frontend/src/router/index.jsx 中配置路由

常见问题

后端启动失败

问题:数据库连接失败 解决:检查 .env 文件中的数据库配置是否正确

问题:端口被占用 解决:修改启动命令中的端口号,或停止占用端口的进程

前端启动失败

问题:依赖安装失败 解决:删除 node_modules 目录,重新运行 npm install

问题:API请求失败 解决:检查 request.js 中的 baseURL 是否正确

权限问题

问题:无法编辑商品/商家 解决:确保商品/商家的 user_id 与当前登录用户的ID一致

贡献指南

欢迎贡献代码!请遵循以下步骤:

  1. Fork 本项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

联系方式

如有问题或建议,请通过以下方式联系:

  • 提交 Issue
  • 发送邮件至:[your-email@example.com]

更新日志

v1.0.0 (2024-01-01)

  • 初始版本发布
  • 实现用户认证和授权
  • 实现商品管理功能
  • 实现商家管理功能
  • 实现报价管理功能
  • 实现数据统计功能
  • 实现报价单导出功能

致谢

感谢所有为本项目做出贡献的开发者!

Introduction

一个商品转卖的网站

Customize your domain