feat: 城市手册后端完成 - 用户/区域/内容/服务/审核系统

city-manual/README.md

@@ -0,0 +1,136 @@
+# 城市手册 - City Manual
+
+地方志兼本地生活服务平台
+
+## 项目状态
+
+✅ **后端 (Django)** - 基础框架完成
+- 用户系统（注册、登录、权限）
+- 区域管理（省市区乡镇村层级）
+- 内容管理（文章、评论、评分、点赞、收藏）
+- 特色服务（衣食住行娱乐旅游文化）
+- 版主审核系统（申请、支持、审核流程）
+- RESTful API
+- Django Admin 后台
+
+⏳ **前端 (React)** - 待开发
+
+## 技术栈
+
+### 后端
+- Django 4.2
+- Django REST Framework
+- JWT 认证
+- SQLite (开发环境)
+
+### 前端（计划）
+- React + Vite
+- Ant Design / Material UI
+- Axios
+
+## 快速开始
+
+### 后端启动
+
+```bash
+cd backend
+python3 manage.py runserver 0.0.0.0:8000
+```
+
+### 访问
+
+- **API**: http://localhost:8000/api/
+- **Admin**: http://localhost:8000/admin/
+  - 用户名：admin
+  - 密码：（创建时设置）
+
+## API 端点
+
+### 用户
+- `POST /api/register/` - 用户注册
+- `POST /api/token/` - 获取 JWT token
+- `GET /api/users/me/` - 当前用户信息
+
+### 区域
+- `GET /api/regions/` - 区域列表
+- `GET /api/regions/{id}/` - 区域详情
+- `GET /api/regions/provinces/` - 省级区域
+- `GET /api/regions/{id}/children/` - 子区域
+
+### 文章
+- `GET /api/articles/` - 文章列表
+- `POST /api/articles/` - 创建文章（需登录）
+
+### 特色服务
+- `GET /api/services/` - 服务列表
+- `POST /api/services/` - 创建服务（需登录）
+
+### 评论
+- `GET /api/comments/` - 评论列表
+- `POST /api/comments/` - 创建评论（需登录）
+
+### 评分
+- `GET /api/ratings/` - 评分列表
+- `POST /api/ratings/` - 创建评分（需登录）
+
+### 版主申请
+- `GET /api/moderator-applications/` - 申请列表
+- `POST /api/moderator-applications/` - 创建申请（需登录）
+- `POST /api/moderator-applications/{id}/support/` - 支持申请（需登录）
+
+## 数据库模型
+
+### 核心模型
+- User - 用户
+- Region - 区域（省市区乡镇村）
+- Article - 文章
+- FeaturedService - 特色服务
+- Comment - 评论
+- Rating - 评分
+- Like - 点赞
+- Favorite - 收藏
+- ModeratorApplication - 版主申请
+- ModeratorPermission - 版主权限
+
+## 审核流程
+
+```
+用户提交 → 版主初审 → AI 审核 → 发布
+            ↓          ↓
+         拒绝       拒绝
+```
+
+## 下一步计划
+
+1. **前端开发** - React 页面
+   - 首页
+   - 城市列表
+   - 城市详情页
+   - 特色服务列表
+   - 用户中心
+
+2. **API 完善**
+   - 搜索功能
+   - 分页优化
+   - 数据统计
+
+3. **AI 审核集成**
+   - 接入 AI 审核 API
+   - 自动审核规则
+
+4. **数据初始化**
+   - 导入示例城市数据
+   - 创建测试内容
+
+## 开发日志
+
+### 2026-04-10
+- ✅ 创建 Django 项目结构
+- ✅ 设计数据库模型
+- ✅ 实现用户系统
+- ✅ 实现区域管理
+- ✅ 实现内容管理
+- ✅ 实现特色服务
+- ✅ 实现版主审核系统
+- ✅ 配置 REST API
+- ✅ 启动开发服务器