2026-03-27 22:20:25 +08:00
|
|
|
# 项目文档索引
|
|
|
|
|
|
|
|
|
|
本目录包含项目后端的所有指南和文档。
|
|
|
|
|
|
|
|
|
|
## 📚 文档分类
|
|
|
|
|
|
|
|
|
|
### 🚀 快速开始
|
|
|
|
|
|
|
|
|
|
- **[QUICK_START_ENV.md](./QUICK_START_ENV.md)** - 环境配置快速参考
|
|
|
|
|
- 快速创建开发和生产环境配置
|
|
|
|
|
- 环境区分总结表
|
|
|
|
|
- 关键区别说明
|
|
|
|
|
|
|
|
|
|
### 🗄️ 数据库相关
|
|
|
|
|
|
|
|
|
|
- **[DATABASE_SETUP.md](./DATABASE_SETUP.md)** - 数据库配置指南
|
|
|
|
|
- 创建数据库
|
|
|
|
|
- DATABASE_URL 格式说明
|
|
|
|
|
- 初始化数据库步骤
|
|
|
|
|
- 验证连接方法
|
|
|
|
|
|
|
|
|
|
- **[DATABASE_URL_SOURCE.md](./DATABASE_URL_SOURCE.md)** - DATABASE_URL 来源说明
|
|
|
|
|
- DATABASE_URL 的定义位置
|
|
|
|
|
- 加载流程详解
|
|
|
|
|
- 配置文件优先级
|
|
|
|
|
- 验证方法
|
|
|
|
|
|
|
|
|
|
- **[SCHEMA_CHANGE_GUIDE.md](./SCHEMA_CHANGE_GUIDE.md)** - Prisma Schema 修改指南
|
|
|
|
|
- 修改 schema.prisma 后的操作步骤
|
|
|
|
|
- 生成 Prisma Client
|
|
|
|
|
- 应用数据库迁移
|
|
|
|
|
- 验证迁移是否成功
|
|
|
|
|
|
|
|
|
|
- **[ENV_CHANGE_GUIDE.md](./ENV_CHANGE_GUIDE.md)** - 修改 DATABASE_URL 后的操作指南
|
|
|
|
|
- 操作决策树
|
|
|
|
|
- 不同场景的处理方法
|
|
|
|
|
- 完整操作流程
|
|
|
|
|
- 常见错误解决
|
|
|
|
|
|
|
|
|
|
### ⚙️ 环境配置
|
|
|
|
|
|
|
|
|
|
- **[ENVIRONMENT_CONFIG.md](./ENVIRONMENT_CONFIG.md)** - 环境配置指南
|
|
|
|
|
- 环境区分方案
|
|
|
|
|
- 配置文件结构
|
|
|
|
|
- 配置优先级
|
|
|
|
|
- 开发/生产环境配置示例
|
|
|
|
|
- 安全注意事项
|
|
|
|
|
|
|
|
|
|
### 🔐 权限管理
|
|
|
|
|
|
|
|
|
|
- **[RBAC_GUIDE.md](./RBAC_GUIDE.md)** - RBAC 权限系统指南
|
|
|
|
|
- 权限系统架构
|
|
|
|
|
- 权限模型说明
|
|
|
|
|
- 使用示例
|
|
|
|
|
- 最佳实践
|
|
|
|
|
|
|
|
|
|
- **[RBAC_EXAMPLES.md](./RBAC_EXAMPLES.md)** - RBAC 使用示例
|
|
|
|
|
- 完整的权限配置示例
|
|
|
|
|
- 常见场景实现
|
|
|
|
|
- 代码示例
|
|
|
|
|
|
|
|
|
|
### 👤 账户管理
|
|
|
|
|
|
|
|
|
|
- **[ADMIN_ACCOUNT.md](./ADMIN_ACCOUNT.md)** - 管理员账户指南
|
|
|
|
|
- 初始化管理员账户
|
|
|
|
|
- 验证管理员账户
|
|
|
|
|
- 账户管理说明
|
|
|
|
|
|
|
|
|
|
## 📖 文档使用建议
|
|
|
|
|
|
|
|
|
|
### 新项目设置流程
|
|
|
|
|
|
|
|
|
|
1. **环境配置** → [QUICK_START_ENV.md](./QUICK_START_ENV.md)
|
|
|
|
|
2. **数据库设置** → [DATABASE_SETUP.md](./DATABASE_SETUP.md)
|
|
|
|
|
3. **初始化管理员** → [ADMIN_ACCOUNT.md](./ADMIN_ACCOUNT.md)
|
|
|
|
|
4. **权限配置** → [RBAC_GUIDE.md](./RBAC_GUIDE.md)
|
|
|
|
|
|
|
|
|
|
### 日常开发流程
|
|
|
|
|
|
|
|
|
|
- **修改数据库结构** → [SCHEMA_CHANGE_GUIDE.md](./SCHEMA_CHANGE_GUIDE.md)
|
|
|
|
|
- **修改环境变量** → [ENV_CHANGE_GUIDE.md](./ENV_CHANGE_GUIDE.md)
|
|
|
|
|
- **配置权限** → [RBAC_EXAMPLES.md](./RBAC_EXAMPLES.md)
|
|
|
|
|
|
|
|
|
|
### 问题排查
|
|
|
|
|
|
|
|
|
|
- **数据库连接问题** → [DATABASE_URL_SOURCE.md](./DATABASE_URL_SOURCE.md)
|
|
|
|
|
- **环境配置问题** → [ENVIRONMENT_CONFIG.md](./ENVIRONMENT_CONFIG.md)
|
|
|
|
|
- **迁移问题** → [SCHEMA_CHANGE_GUIDE.md](./SCHEMA_CHANGE_GUIDE.md)
|
|
|
|
|
|
|
|
|
|
## 🔍 快速查找
|
|
|
|
|
|
|
|
|
|
| 需求 | 文档 |
|
|
|
|
|
|------|------|
|
|
|
|
|
| 如何设置开发环境？ | [QUICK_START_ENV.md](./QUICK_START_ENV.md) |
|
|
|
|
|
| 如何配置数据库？ | [DATABASE_SETUP.md](./DATABASE_SETUP.md) |
|
|
|
|
|
| DATABASE_URL 从哪里来？ | [DATABASE_URL_SOURCE.md](./DATABASE_URL_SOURCE.md) |
|
|
|
|
|
| 修改 schema 后做什么？ | [SCHEMA_CHANGE_GUIDE.md](./SCHEMA_CHANGE_GUIDE.md) |
|
|
|
|
|
| 修改环境变量后做什么？ | [ENV_CHANGE_GUIDE.md](./ENV_CHANGE_GUIDE.md) |
|
|
|
|
|
| 如何配置权限？ | [RBAC_GUIDE.md](./RBAC_GUIDE.md) |
|
|
|
|
|
| 如何创建管理员？ | [ADMIN_ACCOUNT.md](./ADMIN_ACCOUNT.md) |
|
|
|
|
|
|
|
|
|
|
## 📝 文档更新记录
|
|
|
|
|
|
|
|
|
|
- 2024-11-19: 创建文档索引，归档所有指南文件
|
|
|
|
|
|
