YaoXiang/backend/CHANGELOG.md

# 药箱后端修改记录

## 版本历史

### v1.0.0 (2026-06-15)

#### 新增功能

**核心框架**
- 创建 FastAPI 应用入口 (`app/main.py`)
- 实现配置管理系统 (`app/config.py`)
- 实现数据库连接和会话管理 (`app/database.py`)
- 实现异常处理器 (`app/core/exceptions.py`)

**数据模型**
- 用户模型 (`app/models/user.py`)
- 药品模型 (`app/models/medicine.py`)
- 批次模型 (`app/models/batch.py`)
- 分类模型 (`app/models/category.py`)
- 审计日志模型 (`app/models/audit_log.py`)
- 通知模型 (`app/models/notification.py`)
- 设置模型 (`app/models/setting.py`)

**Pydantic 模式**
- 用户请求/响应模式 (`app/schemas/user.py`)
- 药品请求/响应模式 (`app/schemas/medicine.py`)
- 批次请求/响应模式 (`app/schemas/batch.py`)
- 分类请求/响应模式 (`app/schemas/category.py`)
- 认证请求模式 (`app/schemas/auth.py`)

**数据访问层**
- 用户仓库 (`app/repositories/user.py`)
- 药品仓库 (`app/repositories/medicine.py`)
- 批次仓库 (`app/repositories/batch.py`)
- 分类仓库 (`app/repositories/category.py`)
- 审计日志仓库 (`app/repositories/audit_log.py`)
- 通知仓库 (`app/repositories/notification.py`)

**服务层**
- 认证服务 (`app/services/auth.py`)
- 用户服务 (`app/services/user.py`)
- 药品服务 (`app/services/medicine.py`)
- 批次服务 (`app/services/batch.py`)
- 分类服务 (`app/services/category.py`)
- 审计日志服务 (`app/services/audit.py`)
- 通知服务 (`app/services/notification.py`)

**API 接口**
- 认证接口 (`app/api/v1/auth.py`)
  - POST /api/v1/auth/login - 用户登录
  - GET /api/v1/auth/me - 获取当前用户信息
  - PUT /api/v1/auth/password - 修改密码

- 药品管理接口 (`app/api/v1/medicines.py`)
  - GET /api/v1/medicines - 获取药品列表
  - GET /api/v1/medicines/{id} - 获取药品详情
  - POST /api/v1/medicines - 创建药品
  - PUT /api/v1/medicines/{id} - 更新药品
  - DELETE /api/v1/medicines/{id} - 删除药品

- 批次管理接口 (`app/api/v1/batches.py`)
  - GET /api/v1/batches/medicine/{medicine_id} - 获取药品的所有批次
  - GET /api/v1/batches/{id} - 获取批次详情
  - POST /api/v1/batches/medicine/{medicine_id} - 创建批次
  - PUT /api/v1/batches/{id} - 更新批次
  - DELETE /api/v1/batches/{id} - 删除批次
  - POST /api/v1/batches/{id}/dispense - 取药
  - POST /api/v1/batches/{id}/add-stock - 入库

- 分类管理接口 (`app/api/v1/categories.py`)
  - GET /api/v1/categories - 获取分类列表
  - GET /api/v1/categories/tree - 获取分类树
  - GET /api/v1/categories/{id} - 获取分类详情
  - POST /api/v1/categories - 创建分类
  - PUT /api/v1/categories/{id} - 更新分类
  - DELETE /api/v1/categories/{id} - 删除分类

- 搜索接口 (`app/api/v1/search.py`)
  - GET /api/v1/search - 关键词搜索
  - POST /api/v1/search/natural - 自然语言搜索

- AI 识别接口 (`app/api/v1/ai.py`)
  - POST /api/v1/ai/recognize-medicine - 识别药盒
  - POST /api/v1/ai/recognize-dates - 识别日期
  - POST /api/v1/ai/recognize-leaflet - 识别说明书

- 用户管理接口 (`app/api/v1/users.py`)
  - GET /api/v1/users - 获取用户列表
  - GET /api/v1/users/{id} - 获取用户详情
  - POST /api/v1/users - 创建用户
  - PUT /api/v1/users/{id} - 更新用户
  - DELETE /api/v1/users/{id} - 删除用户
  - POST /api/v1/users/{id}/reset-password - 重置密码

- 通知接口 (`app/api/v1/notifications.py`)
  - GET /api/v1/notifications - 获取通知列表
  - PUT /api/v1/notifications/{id}/read - 标记为已读
  - PUT /api/v1/notifications/read-all - 全部标记为已读
  - DELETE /api/v1/notifications/{id} - 删除通知

- 系统设置接口 (`app/api/v1/settings.py`)
  - GET /api/v1/settings - 获取所有设置
  - GET /api/v1/settings/{key} - 获取单个设置
  - PUT /api/v1/settings/{key} - 更新设置

**AI Provider 模块**
- 抽象基类 (`app/ai/base.py`)
- OpenAI Provider 实现 (`app/ai/openai_provider.py`)
- Provider 管理器 (`app/ai/manager.py`)

**通知系统**
- 抽象基类 (`app/notifications/base.py`)
- Server酱 Provider (`app/notifications/serverchan.py`)
- PushPlus Provider (`app/notifications/pushplus.py`)
- 通知管理器 (`app/notifications/manager.py`)

**文件存储**
- 抽象基类 (`app/storage/base.py`)
- 本地存储实现 (`app/storage/local.py`)
- 存储管理器 (`app/storage/manager.py`)

**安全模块**
- JWT 和密码工具 (`app/core/security.py`)
- 依赖注入 (`app/core/deps.py`)

**定时任务**
- 到期检查任务 (`app/tasks/expiry_check.py`)

**项目配置**
- requirements.txt - Python 依赖
- .env.example - 环境变量示例
- .gitignore - Git 忽略文件
- pytest.ini - 测试配置
- tests/conftest.py - 测试配置

**文档**
- DEVELOPMENT.md - 开发文档
- CHANGELOG.md - 修改记录

---

## 待开发功能

### 计划中

- [ ] 文件上传接口
- [ ] 审计日志查询接口
- [ ] Gemini Provider 实现
- [ ] Claude Provider 实现
- [ ] DeepSeek Provider 实现
- [ ] Ollama Provider 实现
- [ ] Bark 通知 Provider
- [ ] 企业微信通知 Provider
- [ ] Telegram 通知 Provider
- [ ] 邮件通知 Provider
- [ ] 数据库迁移支持 (Alembic)
- [ ] 单元测试用例
- [ ] 集成测试用例

### 已知问题

- 暂无

---

## 更新说明

### 2026-06-15

**初始版本发布**

完成药箱后端系统的初始开发，包括：

1. **核心功能实现**
   - 用户认证和授权 (JWT)
   - 药品 CRUD 操作
   - 批次管理（含取药、入库）
   - 分类管理（支持二级分类）
   - 搜索功能（关键词搜索）
   - 通知系统框架
   - AI 识别接口框架

2. **架构设计**
   - 采用分层架构：路由层 → 服务层 → 数据访问层
   - 使用 SQLAlchemy 2.0 异步 ORM
   - 支持多种 AI Provider 扩展
   - 支持多种通知渠道扩展

3. **代码规范**
   - 遵循 PEP 8 编码规范
   - 使用 Pydantic 进行数据验证
   - 完整的类型注解
   - 清晰的模块划分

4. **安全特性**
   - 密码 bcrypt 加密
   - JWT Token 认证
   - 基于角色的访问控制
   - 输入验证和过滤

---

## 贡献指南

如需提交修改，请遵循以下规范：

1. 代码风格遵循 PEP 8
2. 提交信息使用中文
3. 新增功能请添加相应的测试
4. 修改记录请更新此文档

---

## 联系方式

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

- 项目地址: https://github.com/your-username/yaoxiang
- 问题反馈: https://github.com/your-username/yaoxiang/issues