diff --git a/city-manual/README.md b/city-manual/README.md index 5df5fc7..acc9d82 100644 --- a/city-manual/README.md +++ b/city-manual/README.md @@ -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 ## 开发日志