223 lines
5.4 KiB
Markdown
223 lines
5.4 KiB
Markdown
# 外卖SaaS系统 - 文档中心
|
||
|
||
欢迎查阅外卖SaaS系统的完整文档。本文档中心包含了项目的所有技术文档和开发指南。
|
||
|
||
## 📚 文档目录
|
||
|
||
### 1. [项目概述](01_项目概述.md)
|
||
- 项目简介与背景
|
||
- 核心业务模块介绍
|
||
- 用户角色说明
|
||
- 系统特性
|
||
- 技术选型
|
||
- 项目里程碑
|
||
|
||
**适合人群**：项目经理、产品经理、新加入的开发人员
|
||
|
||
---
|
||
|
||
### 2. [技术架构](02_技术架构.md)
|
||
- 技术栈详解
|
||
- 系统架构设计
|
||
- 分层架构说明
|
||
- 核心设计模式
|
||
- 数据访问策略（EF Core + Dapper）
|
||
- 缓存策略
|
||
- 消息队列应用
|
||
- 安全设计
|
||
|
||
**适合人群**：架构师、技术负责人、高级开发人员
|
||
|
||
---
|
||
|
||
### 3. [数据库设计](03_数据库设计.md)
|
||
- 数据库设计原则
|
||
- 命名规范
|
||
- 核心表结构
|
||
- 租户管理
|
||
- 商家管理
|
||
- 菜品管理
|
||
- 订单管理
|
||
- 配送管理
|
||
- 支付管理
|
||
- 营销管理
|
||
- 系统管理
|
||
- 索引策略
|
||
- 数据库优化
|
||
- 备份策略
|
||
|
||
**适合人群**：数据库管理员、后端开发人员
|
||
|
||
---
|
||
|
||
### 4A. [管理后台 API 设计](04A_管理后台API.md)
|
||
- 角色与权限（平台/租户/商家）
|
||
- 租户与商家管理
|
||
- 菜品与分类管理
|
||
- 订单流转与售后
|
||
- 优惠券与评价管理
|
||
- 统计报表与文件上传
|
||
|
||
### 4B. [小程序/用户端 API 设计](04B_小程序API.md)
|
||
- 小程序登录与用户信息
|
||
- 商家与门店浏览
|
||
- 菜品与分类列表
|
||
- 购物车同步
|
||
- 订单创建/查询/取消
|
||
- 支付对接（微信/支付宝）
|
||
- 优惠券领取与使用、评价发布
|
||
|
||
**适合人群**：前端开发人员（小程序/Web用户端）、后端开发人员、接口对接人员
|
||
|
||
---
|
||
|
||
### 5. [部署运维](05_部署运维.md)
|
||
- 环境要求
|
||
- 本地开发环境搭建
|
||
- Docker部署
|
||
- Nginx配置
|
||
- 数据库部署（主从复制）
|
||
- Redis部署（哨兵模式）
|
||
- CI/CD配置
|
||
- 监控告警（Prometheus + Grafana）
|
||
- 日志管理（ELK Stack）
|
||
- 安全加固
|
||
- 性能优化
|
||
- 故障恢复
|
||
|
||
**适合人群**：运维工程师、DevOps工程师、系统管理员
|
||
|
||
---
|
||
|
||
### 6. [开发规范](06_开发规范.md)
|
||
- 代码规范
|
||
- 命名规范
|
||
- 代码组织
|
||
- 代码注释
|
||
- 异常处理
|
||
- Git工作流
|
||
- 分支管理
|
||
- 提交信息规范
|
||
- 代码审查标准
|
||
- 单元测试规范
|
||
- 性能优化规范
|
||
- 安全规范
|
||
- 日志规范
|
||
- 配置管理
|
||
- API设计规范
|
||
|
||
**适合人群**：所有开发人员
|
||
|
||
---
|
||
|
||
### 7. [系统架构图](07_系统架构图.md)
|
||
- 整体架构图
|
||
- 应用分层架构
|
||
- 订单处理流程图
|
||
- 数据流转图
|
||
- 多租户数据隔离架构
|
||
- 缓存架构
|
||
- 消息队列架构
|
||
- 部署架构
|
||
- 监控架构
|
||
|
||
**适合人群**：架构师、技术负责人、所有开发人员
|
||
|
||
---
|
||
|
||
### 8. [API 边界与自检清单](15_API边界与自检清单.md)
|
||
- AdminApi / UserApi / MiniApi 职责边界
|
||
- 路由前缀与鉴权约定
|
||
- DTO/租户/安全自检项
|
||
|
||
**适合人群**：后端开发人员、接口对接人员
|
||
|
||
---
|
||
|
||
### 9. [仓库拆分与子模块使用说明](16_仓库拆分与子模块使用说明.md)
|
||
- AdminApi / TenantApi / Gateway 拆分说明
|
||
- BuildingBlocks / Docs 子模块策略
|
||
- 克隆、更新与提交流程
|
||
|
||
**适合人群**：所有开发人员、DevOps
|
||
|
||
---
|
||
|
||
### 10. [后台菜单 & RBAC：Portal 拆分与套餐权限白名单设计](17_后台菜单RBAC_Portal拆分与套餐白名单设计.md)
|
||
- Admin/Tenant 两套后台菜单隔离
|
||
- 权限码全局唯一与 RBAC 同表 Portal 化
|
||
- 套餐权限白名单与菜单过滤链路
|
||
|
||
**适合人群**：架构师、后端开发人员、DevOps
|
||
|
||
---
|
||
|
||
## 🚀 快速导航
|
||
|
||
### 我是新人，从哪里开始？
|
||
1. 先阅读 [项目概述](01_项目概述.md) 了解项目背景和业务
|
||
2. 查看 [系统架构图](07_系统架构图.md) 理解系统整体架构
|
||
3. 阅读 [开发规范](06_开发规范.md) 了解开发要求
|
||
4. 参考 [部署运维](05_部署运维.md) 搭建本地开发环境
|
||
|
||
### 我要开发新功能
|
||
1. 查看 [数据库设计](03_数据库设计.md) 了解数据模型
|
||
2. 参考 [API接口设计](04_API接口设计.md) 设计接口
|
||
3. 遵循 [开发规范](06_开发规范.md) 编写代码
|
||
4. 参考 [技术架构](02_技术架构.md) 选择合适的技术方案
|
||
|
||
### 我要部署系统
|
||
1. 阅读 [部署运维](05_部署运维.md) 了解部署流程
|
||
2. 参考 [系统架构图](07_系统架构图.md) 理解部署架构
|
||
3. 按照文档配置监控和日志系统
|
||
|
||
### 我要对接API
|
||
1. 查看 [API接口设计](04_API接口设计.md) 了解接口规范
|
||
2. 参考接口文档进行开发和测试
|
||
|
||
---
|
||
|
||
## 📖 文档更新记录
|
||
|
||
### v1.0.0 (2024-01-01)
|
||
- ✅ 完成项目概述文档
|
||
- ✅ 完成技术架构文档
|
||
- ✅ 完成数据库设计文档
|
||
- ✅ 完成API接口设计文档
|
||
- ✅ 完成部署运维文档
|
||
- ✅ 完成开发规范文档
|
||
- ✅ 完成系统架构图文档
|
||
|
||
---
|
||
|
||
## 💡 文档贡献
|
||
|
||
如果您发现文档有任何问题或需要改进的地方，欢迎：
|
||
1. 提交 Issue 反馈问题
|
||
2. 提交 Pull Request 改进文档
|
||
3. 联系项目负责人
|
||
|
||
---
|
||
|
||
## 📞 联系方式
|
||
|
||
- 项目地址：https://github.com/your-org/takeout-saas
|
||
- 问题反馈：https://github.com/your-org/takeout-saas/issues
|
||
- 邮箱：dev@example.com
|
||
|
||
---
|
||
|
||
## 📝 文档规范
|
||
|
||
本文档使用 Markdown 格式编写，遵循以下规范：
|
||
- 使用清晰的标题层级
|
||
- 代码示例使用语法高亮
|
||
- 重要内容使用加粗或引用
|
||
- 保持文档简洁易读
|
||
- 及时更新文档内容
|
||
|
||
---
|
||
|
||
**最后更新时间**：2024-01-01
|
||
**文档版本**：v1.0.0
|