diff --git a/city-manual/README.md b/city-manual/README.md index a3f7a72..5df5fc7 100644 --- a/city-manual/README.md +++ b/city-manual/README.md @@ -12,8 +12,19 @@ - 版主审核系统(申请、支持、审核流程) - RESTful API - Django Admin 后台 +- ✅ 示例数据已导入 -⏳ **前端 (React)** - 待开发 +✅ **前端 (React)** - 核心页面完成 +- 首页(Hero、省份导航、精选内容) +- 城市列表页(层级导航、面包屑) +- 区域详情页(标签页、统计信息) +- API 集成 + +⏳ **待开发** +- 文章详情页 +- 服务详情页 +- 用户登录/注册页 +- 个人中心 ## 技术栈 @@ -23,10 +34,11 @@ - JWT 认证 - SQLite (开发环境) -### 前端(计划) +### 前端 - React + Vite -- Ant Design / Material UI +- React Router - Axios +- 原生 CSS ## 快速开始 @@ -37,12 +49,26 @@ 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/ - - 用户名:admin - - 密码:(创建时设置) +- **后端 API**: http://localhost:8000/api/ +- **Admin 后台**: http://localhost:8000/admin/ +- **前端页面**: http://localhost:3000/ (启动后) + +### 测试账号 + +| 用户名 | 密码 | 说明 | +|--------|------|------| +| admin | (创建时设置) | 超级管理员 | +| demo | demo123 | 示例用户 | ## API 端点 @@ -60,10 +86,12 @@ python3 manage.py runserver 0.0.0.0:8000 ### 文章 - `GET /api/articles/` - 文章列表 - `POST /api/articles/` - 创建文章(需登录) +- 查询参数:`?region={id}&type={type}` ### 特色服务 - `GET /api/services/` - 服务列表 - `POST /api/services/` - 创建服务(需登录) +- 查询参数:`?region={id}&category={category}` ### 评论 - `GET /api/comments/` - 评论列表 @@ -76,7 +104,7 @@ python3 manage.py runserver 0.0.0.0:8000 ### 版主申请 - `GET /api/moderator-applications/` - 申请列表 - `POST /api/moderator-applications/` - 创建申请(需登录) -- `POST /api/moderator-applications/{id}/support/` - 支持申请(需登录) +- `POST /api/moderator-applications/{id}/support/` - 支持申请 ## 数据库模型 @@ -100,27 +128,38 @@ python3 manage.py runserver 0.0.0.0:8000 拒绝 拒绝 ``` +## 示例数据 + +已导入以下示例数据: + +**省份 (6 个)** +- 北京市、上海市、广东省、浙江省、四川省、陕西省 + +**城市 (8 个)** +- 广州市、深圳市、杭州市、宁波市、成都市、绵阳市、西安市、咸阳市 + +**文章 (7 篇)** +- 北京故宫游览攻略、上海外滩历史、广州早茶文化等 + +**特色服务 (6 个)** +- 全聚德烤鸭、东方明珠塔、广州塔、楼外楼、宽窄巷子、大唐不夜城 + ## 下一步计划 -1. **前端开发** - React 页面 - - 首页 - - 城市列表 - - 城市详情页 - - 特色服务列表 - - 用户中心 +1. **完善前端页面** + - 文章详情页 + - 服务详情页 + - 登录/注册页 + - 个人中心 -2. **API 完善** - - 搜索功能 - - 分页优化 - - 数据统计 - -3. **AI 审核集成** +2. **AI 审核集成** - 接入 AI 审核 API - 自动审核规则 -4. **数据初始化** - - 导入示例城市数据 - - 创建测试内容 +3. **功能增强** + - 搜索功能 + - 分页优化 + - 数据统计 ## 开发日志 @@ -134,3 +173,8 @@ python3 manage.py runserver 0.0.0.0:8000 - ✅ 实现版主审核系统 - ✅ 配置 REST API - ✅ 启动开发服务器 +- ✅ 创建示例数据导入命令 +- ✅ 导入示例数据(6 省 8 市 7 文章 6 服务) +- ✅ 前端页面开发(首页/城市列表/区域详情) +- ✅ API 集成(axios + react-router) +- ✅ Git 提交