shop-back-end/doc/README.md

116 lines
3.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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