docs: 更新项目功能清单和部署说明

- 完善项目状态说明(后端/前端/部署)
- 添加详细功能清单(用户/区域/内容/服务/版主系统)
- 更新开发日志
- 添加生产环境访问地址
This commit is contained in:
maoshen
2026-04-12 11:23:36 +00:00
parent 72b9c25262
commit 1639775a39

View File

@@ -4,27 +4,39 @@
## 项目状态 ## 项目状态
**后端 (Django)** - 基础框架完成 ### ✅ 后端 (Django) - 已完成
- 用户系统(注册、登录、权限 - 用户系统(注册、登录、JWT 认证、权限管理
- 区域管理(省市区乡镇村层级) - 区域管理(省市区乡镇村 5 级层级)
- 内容管理(文章、评论、评分、点赞、收藏) - 内容管理(文章、评论、评分、点赞、收藏)
- 特色服务(衣食住行娱乐旅游文化) - 特色服务(衣食住行娱乐旅游文化)
- 版主审核系统(申请、支持、审核流程) - 版主审核系统(申请、支持、审核流程)
- RESTful API - RESTful API(完整端点)
- Django Admin 后台 - Django Admin 后台
- ✅ 示例数据已导入 - ✅ 示例数据6 省 8 市 7 文章 6 服务)
- ✅ PostgreSQL 数据库配置
**前端 (React)** - 核心页面完成 ### ✅ 前端 (React) - 核心功能完成
- 首页Hero、省份导航、精选内容 - 首页Hero、省份导航、精选内容
- 城市列表页(层级导航、面包屑) - 城市列表页(层级导航、面包屑)
- 区域详情页(标签页、统计信息) - 区域详情页(标签页、统计信息)
- API 集成 - **登录页**JWT 认证、错误处理)
-**注册页**(表单验证、自动登录)
-**导航栏状态切换**(登录/登出、用户名显示)
- ✅ API 集成Axios + Token 管理)
- ✅ 响应式设计
**待开发** ### ✅ 部署 - 已完成
- ✅ Gunicorn3 workers端口 8000
- ✅ Nginx反向代理端口 81
- ✅ 静态文件服务
- ✅ 生产环境配置
### ⏳ 待开发
- 文章详情页 - 文章详情页
- 服务详情页 - 服务详情页
- 用户登录/注册页
- 个人中心 - 个人中心
- 搜索功能
- AI 审核集成
## 技术栈 ## 技术栈
@@ -42,33 +54,38 @@
## 快速开始 ## 快速开始
### 后端启动 ### 开发环境
**后端启动**
```bash ```bash
cd backend cd backend
python3 manage.py runserver 0.0.0.0:8000 python3 manage.py runserver 0.0.0.0:8000
``` ```
### 前端启动 **前端启动**
```bash ```bash
cd frontend cd frontend
npm install npm install
npm run dev npm run dev
``` ```
### 访问 ### 生产环境(本地部署)
- **后端 API**: http://localhost:8000/api/ **访问地址**
- **Admin 后台**: http://localhost:8000/admin/ - 主页http://127.0.0.1:81/
- **前端页面**: http://localhost:3000/ (启动后) - Admin: http://127.0.0.1:81/admin/
- API: http://127.0.0.1:81/api/
**服务状态**
- Gunicorn: 3 workers, 端口 8000
- Nginx: 反向代理,端口 81
### 测试账号 ### 测试账号
| 用户名 | 密码 | 说明 | | 用户名 | 密码 | 说明 |
|--------|------|------| |--------|------|------|
| admin | (创建时设置) | 超级管理员 | | admin | (创建时设置) | 超级管理员 |
| demo | demo123 | 示例用户 | | demo | demo123 | 示例用户(已预创建) |
## API 端点 ## API 端点
@@ -144,22 +161,68 @@ npm run dev
**特色服务 (6 个)** **特色服务 (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
## 开发日志 ## 开发日志