docs: 更新项目功能清单和部署说明
- 完善项目状态说明(后端/前端/部署) - 添加详细功能清单(用户/区域/内容/服务/版主系统) - 更新开发日志 - 添加生产环境访问地址
This commit is contained in:
@@ -4,27 +4,39 @@
|
||||
|
||||
## 项目状态
|
||||
|
||||
✅ **后端 (Django)** - 基础框架完成
|
||||
- 用户系统(注册、登录、权限)
|
||||
- 区域管理(省市区乡镇村层级)
|
||||
- 内容管理(文章、评论、评分、点赞、收藏)
|
||||
- 特色服务(衣食住行娱乐旅游文化)
|
||||
- 版主审核系统(申请、支持、审核流程)
|
||||
- RESTful API
|
||||
- Django Admin 后台
|
||||
- ✅ 示例数据已导入
|
||||
### ✅ 后端 (Django) - 已完成
|
||||
- ✅ 用户系统(注册、登录、JWT 认证、权限管理)
|
||||
- ✅ 区域管理(省市区乡镇村 5 级层级)
|
||||
- ✅ 内容管理(文章、评论、评分、点赞、收藏)
|
||||
- ✅ 特色服务(衣食住行娱乐旅游文化)
|
||||
- ✅ 版主审核系统(申请、支持、审核流程)
|
||||
- ✅ RESTful API(完整端点)
|
||||
- ✅ Django Admin 后台
|
||||
- ✅ 示例数据(6 省 8 市 7 文章 6 服务)
|
||||
- ✅ PostgreSQL 数据库配置
|
||||
|
||||
✅ **前端 (React)** - 核心页面完成
|
||||
- 首页(Hero、省份导航、精选内容)
|
||||
- 城市列表页(层级导航、面包屑)
|
||||
- 区域详情页(标签页、统计信息)
|
||||
- API 集成
|
||||
### ✅ 前端 (React) - 核心功能完成
|
||||
- ✅ 首页(Hero、省份导航、精选内容)
|
||||
- ✅ 城市列表页(层级导航、面包屑)
|
||||
- ✅ 区域详情页(标签页、统计信息)
|
||||
- ✅ **登录页**(JWT 认证、错误处理)
|
||||
- ✅ **注册页**(表单验证、自动登录)
|
||||
- ✅ **导航栏状态切换**(登录/登出、用户名显示)
|
||||
- ✅ API 集成(Axios + Token 管理)
|
||||
- ✅ 响应式设计
|
||||
|
||||
⏳ **待开发**
|
||||
### ✅ 部署 - 已完成
|
||||
- ✅ Gunicorn(3 workers,端口 8000)
|
||||
- ✅ Nginx(反向代理,端口 81)
|
||||
- ✅ 静态文件服务
|
||||
- ✅ 生产环境配置
|
||||
|
||||
### ⏳ 待开发
|
||||
- 文章详情页
|
||||
- 服务详情页
|
||||
- 用户登录/注册页
|
||||
- 个人中心
|
||||
- 搜索功能
|
||||
- AI 审核集成
|
||||
|
||||
## 技术栈
|
||||
|
||||
@@ -42,33 +54,38 @@
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 后端启动
|
||||
### 开发环境
|
||||
|
||||
**后端启动**
|
||||
```bash
|
||||
cd backend
|
||||
python3 manage.py runserver 0.0.0.0:8000
|
||||
```
|
||||
|
||||
### 前端启动
|
||||
|
||||
**前端启动**
|
||||
```bash
|
||||
cd frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
### 访问
|
||||
### 生产环境(本地部署)
|
||||
|
||||
- **后端 API**: http://localhost:8000/api/
|
||||
- **Admin 后台**: http://localhost:8000/admin/
|
||||
- **前端页面**: http://localhost:3000/ (启动后)
|
||||
**访问地址**
|
||||
- 主页:http://127.0.0.1:81/
|
||||
- Admin: http://127.0.0.1:81/admin/
|
||||
- API: http://127.0.0.1:81/api/
|
||||
|
||||
**服务状态**
|
||||
- Gunicorn: 3 workers, 端口 8000
|
||||
- Nginx: 反向代理,端口 81
|
||||
|
||||
### 测试账号
|
||||
|
||||
| 用户名 | 密码 | 说明 |
|
||||
|--------|------|------|
|
||||
| admin | (创建时设置) | 超级管理员 |
|
||||
| demo | demo123 | 示例用户 |
|
||||
| demo | demo123 | 示例用户(已预创建) |
|
||||
|
||||
## API 端点
|
||||
|
||||
@@ -144,22 +161,68 @@ npm run dev
|
||||
**特色服务 (6 个)**
|
||||
- 全聚德烤鸭、东方明珠塔、广州塔、楼外楼、宽窄巷子、大唐不夜城
|
||||
|
||||
## 下一步计划
|
||||
## 功能清单
|
||||
|
||||
1. **完善前端页面**
|
||||
- 文章详情页
|
||||
- 服务详情页
|
||||
- 登录/注册页
|
||||
- 个人中心
|
||||
### 用户系统
|
||||
- [x] 用户注册
|
||||
- [x] 用户登录(JWT)
|
||||
- [x] 用户登出
|
||||
- [x] Token 自动管理
|
||||
- [x] 登录状态持久化
|
||||
- [x] 401 自动跳转登录
|
||||
- [ ] 个人中心
|
||||
- [ ] 密码修改
|
||||
- [ ] 头像上传
|
||||
|
||||
2. **AI 审核集成**
|
||||
- 接入 AI 审核 API
|
||||
- 自动审核规则
|
||||
### 区域系统
|
||||
- [x] 省市区乡镇村 5 级层级
|
||||
- [x] 区域列表/详情
|
||||
- [x] 父子区域查询
|
||||
- [x] 区域代码管理
|
||||
- [x] 区域激活/禁用
|
||||
|
||||
3. **功能增强**
|
||||
- 搜索功能
|
||||
- 分页优化
|
||||
- 数据统计
|
||||
### 内容系统
|
||||
- [x] 文章 CRUD
|
||||
- [x] 文章按区域筛选
|
||||
- [x] 评论系统
|
||||
- [x] 评分系统
|
||||
- [x] 点赞功能
|
||||
- [x] 收藏功能
|
||||
- [ ] 文章详情页
|
||||
- [ ] 富文本编辑器
|
||||
- [ ] 图片上传
|
||||
|
||||
### 特色服务
|
||||
- [x] 服务 CRUD
|
||||
- [x] 服务分类(衣食住行娱乐旅游文化)
|
||||
- [x] 服务按区域筛选
|
||||
- [ ] 服务详情页
|
||||
- [ ] 服务预约
|
||||
|
||||
### 版主系统
|
||||
- [x] 版主申请
|
||||
- [x] 用户支持申请
|
||||
- [x] 申请状态管理
|
||||
- [ ] AI 审核集成
|
||||
- [ ] 版主审核后台
|
||||
|
||||
### 其他功能
|
||||
- [ ] 搜索功能
|
||||
- [ ] 分页优化
|
||||
- [ ] 数据统计面板
|
||||
- [ ] 消息通知
|
||||
|
||||
## 开发日志
|
||||
|
||||
### 2026-04-12
|
||||
- ✅ 实现登录页面(JWT 认证)
|
||||
- ✅ 实现注册页面(表单验证)
|
||||
- ✅ 导航栏登录状态切换
|
||||
- ✅ 修复 API 路径问题
|
||||
- ✅ 部署到 Nginx 81 端口
|
||||
- ✅ Git 提交并推送
|
||||
|
||||
### 2026-04-10
|
||||
|
||||
## 开发日志
|
||||
|
||||
|
||||
Reference in New Issue
Block a user