# CMS API 2.0 - 新数据库结构版本

## 🎉 项目概述

基于新数据库结构重新开发的企业级CMS API系统，采用GoFrame v2.6.4框架，支持完整的RBAC权限管理、内容管理、产品管理等功能。

## 🚀 主要特性

### ✅ 已完成功能
- **规范化数据库设计**：统一的表结构和命名规范
- **RBAC权限系统**：用户-角色-权限完整模型
- **JWT认证**：安全的Token认证机制
- **用户管理**：完整的用户CRUD操作
- **中间件支持**：CORS、认证、响应处理
- **企业官网功能**：产品、服务、案例、团队管理

### 🔄 数据库结构优势
- **用户管理模块**：统一用户表 + RBAC权限系统
- **内容管理模块**：文章、页面、分类、标签、媒体文件
- **企业官网模块**：产品、服务、案例、团队、询价、友情链接
- **系统管理模块**：配置管理、操作日志

## 📋 快速开始

### 1. 数据库初始化
```bash
# 执行数据库初始化脚本
mysql -u root -p < database_design_new.sql
```

### 2. 启动服务器
```bash
# 使用启动脚本
./start_new_server.ps1

# 或手动启动
go mod tidy
go run main_new.go
```

### 3. 测试API
```bash
# 运行测试脚本
./test_new_api.ps1
```

## 🔧 配置说明

### 数据库配置 (config/config.yaml)
```yaml
database:
  default:
    host: "127.0.0.1"
    port: "3306"
    user: "root"
    pass: "root"
    name: "cc_cms_gf"  # 数据库名称
    type: "mysql"
```

### JWT配置
```yaml
jwt:
  signingKey: "cms_jwt_signing_key_2024"
  expire: 7200  # 2小时
```

## 📡 API接口

### 公开接口
- `GET /` - 服务状态检查
- `GET /test/db` - 数据库连接测试
- `POST /api/public/login` - 用户登录
- `GET /api/public/configs` - 获取公开配置

### 用户接口（需要认证）
- `GET /api/user/profile` - 获取用户信息
- `PUT /api/user/profile` - 更新用户信息
- `POST /api/user/change-password` - 修改密码
- `POST /api/user/logout` - 用户登出

### 管理员接口（需要认证）
- `GET /api/admin/users` - 用户列表
- `POST /api/admin/users` - 创建用户
- `GET /api/admin/users/:id` - 用户详情
- `PUT /api/admin/users/:id` - 更新用户
- `DELETE /api/admin/users/:id` - 删除用户

## 🗄️ 数据库表结构

### 核心表
- `users` - 用户表（统一管理）
- `roles` - 角色表
- `permissions` - 权限表
- `user_roles` - 用户角色关联
- `role_permissions` - 角色权限关联

### 内容管理
- `categories` - 分类表
- `tags` - 标签表
- `articles` - 文章表
- `pages` - 页面表
- `media_files` - 媒体文件表

### 企业官网
- `products` - 产品表
- `services` - 服务表
- `cases` - 案例表
- `team_members` - 团队成员表
- `inquiries` - 客户询价表
- `links` - 友情链接表

### 系统管理
- `system_configs` - 系统配置表
- `operation_logs` - 操作日志表

## 🔐 默认账号

- **用户名**: admin
- **密码**: admin123
- **角色**: 超级管理员

## 📁 项目结构

```
cms-api/
├── config/                 # 配置文件
├── internal/
│   ├── controller/         # 控制器层
│   ├── service/           # 服务层
│   ├── dao/               # 数据访问层
│   ├── model/             # 数据模型
│   └── middleware/        # 中间件
├── database_design_new.sql # 数据库初始化脚本
├── main_new.go            # 主程序入口
├── start_new_server.ps1   # 启动脚本
├── test_new_api.ps1       # 测试脚本
└── README_NEW.md          # 项目说明
```

## 🔄 版本对比

| 功能 | 旧版本 | 新版本 |
|------|--------|--------|
| 数据库设计 | 不规范，表结构混乱 | 规范化设计，统一命名 |
| 用户管理 | 分离的users和admins表 | 统一的users表 |
| 权限系统 | 简单的JSON字符串 | 完整的RBAC模型 |
| 企业功能 | 缺失 | 完整的企业官网功能 |
| 扩展性 | 差 | 高度可扩展 |

## 🚧 待开发功能

- [ ] 文章管理API
- [ ] 产品管理API
- [ ] 服务管理API
- [ ] 案例管理API
- [ ] 系统配置API
- [ ] 文件上传功能
- [ ] 邮件通知功能

## 🐛 问题排查

### 常见问题
1. **数据库连接失败**
   - 检查MySQL服务是否启动
   - 确认数据库配置正确
   - 确保数据库cc_cms_gf已创建

2. **Token认证失败**
   - 检查JWT配置
   - 确认Token格式正确
   - 验证用户状态是否正常

3. **权限不足**
   - 检查用户角色分配
   - 确认权限配置正确

## 📞 技术支持

如有问题，请检查：
1. 数据库是否正确初始化
2. 配置文件是否正确
3. 依赖是否完整安装
4. 服务器端口是否被占用

---

**CMS API 2.0** - 企业级内容管理系统后端API