137 lines
2.9 KiB
Markdown
137 lines
2.9 KiB
Markdown
|
# 城市手册 - 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
|
|||
|
|
- ✅ 启动开发服务器
|