# 项目文档目录

欢迎使用 AgileBoot 电商后端系统文档。本文档提供了项目的完整说明和使用指南。

## 📚 文档列表

### 核心文档

1. **[项目概述](./项目概述.md)** - 项目整体介绍、技术栈、架构特点
2. **[快速启动指南](./快速启动指南.md)** - 快速上手，环境配置和启动步骤
3. **[API接口文档](./API接口文档.md)** - 完整的API接口说明和使用示例

### 功能模块文档

4. **[企业微信集成指南](./企业微信集成指南.md)** - 企业微信应用集成详细指南
5. **[微信支付集成指南](./微信支付集成指南.md)** - 微信支付功能集成和使用说明
6. **[智能柜系统指南](./智能柜系统指南.md)** - 智能柜设备管理和操作指南
7. **[缓存系统指南](./缓存系统指南.md)** - Caffeine缓存系统使用和优化

### 运维部署文档

8. **[部署运维指南](./部署运维指南.md)** - 生产环境部署、监控和运维指南

### 第三方文档

9. **[第三方文档](./thirdParty/)** - 第三方服务集成文档
   - [支付网关](./thirdParty/支付网关.md)
   - [企业微信开发文档](./thirdParty/simpread-三：如何获取第三方应用凭证 - 教程 - 企业微信开发者中心.md)
   - [汇邦数字身份平台](./thirdParty/汇邦数字身份平台登录接口文档.md)

## 🚀 快速开始

如果你是第一次接触本项目，建议按以下顺序阅读文档：

1. **首先阅读**: [项目概述](./项目概述.md) - 了解项目整体情况
2. **然后阅读**: [快速启动指南](./快速启动指南.md) - 快速搭建开发环境
3. **接着阅读**: [API接口文档](./API接口文档.md) - 了解系统功能接口

## 🔧 功能模块

### 电商核心功能
- 商品管理：商品分类、商品信息、库存管理
- 订单管理：订单创建、支付、退款、物流跟踪
- 用户管理：微信用户信息、会员体系
- 支付系统：微信支付集成、支付回调处理

### 企业微信集成
- 企微认证：企业微信应用授权管理
- 部门管理：企微部门同步和管理
- 消息推送：企微应用消息发送
- 用户同步：企微用户与系统用户关联

### 智能柜系统
- 柜体管理：智能柜设备管理
- 格口操作：柜体格口状态监控
- 企业微信集成：支持corpid字段的企业微信对接

### 系统管理
- 用户权限：RBAC权限模型
- 数据字典：系统常量管理
- 操作日志：完整的操作审计
- 系统监控：缓存监控、服务状态监控

## 🛠️ 技术特性

### 架构特点
- **DDD领域驱动设计**: 采用CQRS模式，分离查询和命令操作
- **多级缓存**: Caffeine本地缓存 + Redis分布式缓存
- **权限控制**: 基于注解的菜单权限和数据权限
- **企业微信集成**: 完整的企微应用集成方案
- **微信支付**: 支持JSAPI支付和退款功能

### 性能优化
- Caffeine本地缓存提升访问性能
- 数据库连接池优化
- 异步处理耗时操作
- 合理的索引设计

## 📋 环境要求

### 开发环境
- JDK 1.8+
- MySQL 8.0+
- Redis 6.0+
- Maven 3.6+
- Node.js 16+ (前端)

### 生产环境
- 支持Docker容器化部署
- 支持多环境配置
- 内置监控和健康检查

## 🔍 问题排查

如果在使用过程中遇到问题，可以：

1. 查看对应模块的详细文档
2. 检查日志文件中的错误信息
3. 参考常见问题解决方案
4. 联系技术支持

## 📞 技术支持

- **项目地址**: [GitHub Repository]
- **问题反馈**: 通过GitHub Issues提交问题
- **交流群**: 参考项目README中的联系方式

## 📄 许可证

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

---

**最后更新**: 2025-10-15

如果发现文档有误或需要补充，欢迎提交Pull Request或Issue。