shop-back-end/doc/README.md

116 lines
3.8 KiB
Markdown
Raw Permalink Normal View History

# 项目文档目录
欢迎使用 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。