Skip to content

README_zh.md

Latest commit

 

History

History
164 lines (114 loc) · 3.91 KB

README_zh.md

File metadata and controls

164 lines (114 loc) · 3.91 KB

Cart Service

Python FastAPI PostgreSQL License

高性能电商购物车微服务

基于 FastAPI + SQLAlchemy 2.0 异步架构，支持购物车全生命周期管理

English | 中文 | Русский | 한국어 | 日本語

✨ 功能特性

  • 🛒 购物车管理 - 创建、查询、清空购物车
  • 📦 商品操作 - 添加、更新数量、移除商品
  • 🔄 购物车合并 - 支持匿名购物车与用户购物车合并
  • ⚡ 异步架构 - 基于 async/await 的高性能设计
  • 📊 价格快照 - 记录商品加入时的单价

🛠️ 技术栈

技术 版本 用途
Python 3.10+ 运行环境
FastAPI 0.109+ 高性能异步 Web 框架
PostgreSQL 15+ 关系型数据库
SQLAlchemy 2.0+ 异步 ORM
Pydantic v2 数据验证
Alembic 1.13+ 数据库迁移

🏗️ 项目结构

cart-service/
├── app/
│   ├── api/v1/endpoints/    # API 路由层
│   ├── core/                # 配置管理
│   ├── db/                  # 数据库连接
│   ├── models/              # ORM 模型
│   ├── schemas/             # Pydantic 模型
│   ├── services/            # 业务逻辑层
│   └── main.py              # 应用入口
├── alembic/                 # 数据库迁移脚本
├── .env.example             # 环境变量模板
├── alembic.ini              # Alembic 配置
└── requirements.txt         # 依赖清单

🚀 快速开始

1. 安装依赖

cd projects/cart-service
pip install -r requirements.txt

2. 配置数据库

创建 PostgreSQL 数据库：

CREATE DATABASE cart_db;

配置环境变量：

copy .env.example .env
# 编辑 .env 文件，设置正确的数据库连接信息

3. 数据库迁移

alembic upgrade head

4. 启动服务

uvicorn app.main:app --reload

5. 访问 API

📡 API 接口

方法 路径 说明
GET /api/v1/carts/{cart_id} 获取购物车详情
POST /api/v1/carts 创建购物车
POST /api/v1/carts/{cart_id}/items 添加商品
PATCH /api/v1/carts/{cart_id}/items/{item_id} 更新商品数量
DELETE /api/v1/carts/{cart_id}/items/{item_id} 移除商品
DELETE /api/v1/carts/{cart_id} 清空购物车
POST /api/v1/carts/{cart_id}/merge 合并购物车

🗃️ 数据模型

carts 表

字段 类型 说明
id UUID 主键
user_id UUID 用户 ID (可为空)
status VARCHAR 状态
created_at DATETIME 创建时间
updated_at DATETIME 更新时间

cart_items 表

字段 类型 说明
id UUID 主键
cart_id UUID 购物车 ID
product_id VARCHAR 商品 SKU
quantity INTEGER 数量
unit_price DECIMAL 单价
added_at DATETIME 添加时间

📖 开发文档

📄 许可证

本项目采用 MIT 许可证。

Made with ❤️ using Python and FastAPI