Bookstore 2.0

Bookstore 2.0是一个基于 Flask + MySQL 的线上书店后端，实现了课程要求的 60% 基础功能，并在此基础上扩展发货/收货闭环、全文检索、自动化订单管理、推荐系统与书名提取器等高级能力。系统通过 127 条 pytest 用例和 bench/JMeter 压测验证，在 128 并发下单/支付延迟约 0.3s/0.4s，整体覆盖率 96%。

---

✨ 功能总览

---

🏗️ 架构与目录

bookstore/
├── be/                # 后端：Flask + SQLAlchemy
│   ├── model/         # 业务实现（buyer/seller/recommend/...）
│   ├── view/          # REST API 路由
│   └── serve.py       # APScheduler、应用入口
├── fe/                # 测试与脚本
│   ├── access/        # HTTP 客户端封装
│   ├── bench/         # 性能测试脚本
│   ├── data/          # 导入数据与工具
│   └── test/          # pytest 用例（用户/买家/卖家/附加功能）
├── script/            # 运行、日志脚本
├── requirements.txt
└── README.md

关键技术栈：

• 后端：Flask 2.x、SQLAlchemy、PyJWT、APScheduler
• 数据库：MySQL 8.0（InnoDB），FULLTEXT + 组合索引
• 工具链：pytest、coverage、bench、JMeter、Git

---

🚀 快速开始

1. 环境准备

• Python 3.11+
• MySQL 8.0（确保已创建目标数据库并具备写入权限）

git clone <repo>
cd bookstore
python -m venv venv && source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. 导入基础数据

# 将 SQLite 中的图书数据迁移到 MySQL
python fe/data/create_table.py \
  --sqlite fe/data/book.db \
  --mysql-url mysql+pymysql://user:password@localhost:3306/bookstore

常用环境变量：

3. 启动后端

export FLASK_APP=be.serve  # Windows 使用 set
flask run --host 0.0.0.0 --port 5000

APScheduler 会在启动时注册订单超时检查等后台任务。

4. 运行测试

pytest fe/test -n auto                 # 127 条单元 / 集成测试
coverage run -m pytest fe/test && coverage html  # 生成 96% 覆盖率
python fe/bench/run.py                 # bench 下单/支付压测
sh script/test_log.sh                  # JMeter 结果解析（可选）

---

🔍 主要接口

更多细节请参考 bookstore2报告.md 或 be/view/*.py。

---

🧪 测试与性能

• 功能测试：127 条 pytest 用例覆盖用户、买家、卖家、推荐、搜索、发货、自动取消等场景，覆盖率 96%。
• 性能压测：bench 脚本展示 TPS_C≈3.1k req/s；JMeter 对比显示 MySQL 版本吞吐量 ~10k req/s，显著优于 MongoDB 基线。
• 监控 & 日志：关键事务、自动任务、推荐服务均输出结构化日志到 logs/，便于回溯。

---

👥 分工

---

📚 参考资料

• MySQL 官方文档
• SQLAlchemy
• Flask
• PyJWT
• JMeter