168 lines
7.4 KiB
Markdown
168 lines
7.4 KiB
Markdown
## 用户端（前端：Web/App/小程序）需要的功能规划
|
||
|
||
> 前端技术栈使用 uniapp ，需要对 h5、小程序、app 进行支持
|
||
|
||
前端的目标是让用户“**快速发现地点 → 看懂怎么去怎么拍 → 愿意贡献内容 → 形成互动**”。建议把用户端拆成 6 个页面域：发现、地点、创作、互动、约拍、我的。
|
||
|
||
**阶段 1（MVP 必须有）**
|
||
|
||
* 登录注册：手机号/邮箱/第三方（可后置），基本资料（昵称、头像、城市、身份：coser/摄影/都可）
|
||
* 地图发现：地图点位展示、同城切换、附近/范围检索、地点列表与地图联动
|
||
* 地点详情：场景描述、交通方式、最佳拍摄时间建议、难走路径说明、示例图片/作品、收藏按钮
|
||
* 上传地点：表单（标题、城市、坐标、描述、交通、时间建议、路线困难说明）+ 上传示例图；提交后提示“待审核”
|
||
* 我的：我的收藏、我上传的地点（审核状态：待审/通过/驳回原因）、积分概览（先只显示即可）
|
||
|
||
**阶段 2（社区增强）**
|
||
|
||
* 评论与回复：评论列表、回复、@、评论举报
|
||
* 评分：1~5 星 + 可选短评、展示平均分/评分数
|
||
* 标签筛选：按标签筛地点、热门标签
|
||
* 搜索：关键词（地点名/描述/标签）
|
||
|
||
**阶段 3（约拍）**
|
||
|
||
* 约拍广场：发布约拍单、筛选（城市/时间/风格/预算/互免）
|
||
* 约拍详情：报名、接受/拒绝、状态（开放/匹配/结束）
|
||
* 站内沟通：会话列表、消息、拉黑/举报（可选但通常需要）
|
||
|
||
**阶段 4（活动）**
|
||
|
||
* 活动列表与详情：活动发布、报名、通知、活动相册（作品沉淀回地点）
|
||
|
||
**阶段 5（商业化）**
|
||
|
||
* 商业标识：推广位/商家地点清晰标注
|
||
* 会员中心：权益展示、购买/续费、发票（如需要）
|
||
|
||
---
|
||
|
||
## 后端（服务端）需要的功能规划
|
||
|
||
后端的目标是“**统一数据与规则**”：地图检索、UGC审核、积分、互动、约拍/活动状态机、统计与风控。建议一开始用**单体服务 + 模块化代码结构**，以后按流量再拆。
|
||
|
||
**基础能力（无论哪个阶段都要有）**
|
||
|
||
* 鉴权与权限：JWT/Session、角色（user/admin/moderator）、接口权限控制
|
||
* 地理能力：坐标存储、附近/范围查询、同城筛选、排序（热门/最近/评分/距离）
|
||
* 文件与图片：上传签名、回调入库、图片元信息、缩略图、鉴黄/鉴政（可接第三方）
|
||
* 内容安全与风控：频率限制、防刷、敏感词、黑名单、设备/账号风控（起步先做最基本）
|
||
* 审核体系：所有UGC都有 audit_status（pending/approved/rejected）与驳回原因
|
||
* 通用能力：日志、审计日志、监控、备份、任务队列（生成缩略图/统计汇总）
|
||
|
||
**阶段 1（MVP 的核心 API）**
|
||
|
||
* 用户：注册登录、资料、城市
|
||
* 地点：创建/编辑/删除（软删）、列表、详情、地图点位、附近查询
|
||
* 地点图片：上传、设封面、删除
|
||
* 收藏：收藏/取消收藏、我的收藏列表
|
||
* 积分：上传地点审核通过后发放积分（用积分流水 point_ledger）
|
||
|
||
**阶段 2（社区增强 API）**
|
||
|
||
* 评论：发评论/回复、评论列表、删除、举报
|
||
* 评分：评分写入/更新、地点评分聚合（avg/count 缓存）
|
||
* 标签：标签管理（用户可选/管理员维护）、地点打标签
|
||
* 点赞：地点/评论/图片点赞（可选）
|
||
|
||
**阶段 3（约拍 API）**
|
||
|
||
* 约拍单：发布、编辑、关闭、列表筛选、详情
|
||
* 报名/邀请：报名、接受/拒绝、撤回、状态机
|
||
* 私信：会话、消息、已读、拉黑（如做）
|
||
|
||
**阶段 4（活动 API）**
|
||
|
||
* 活动：发布、报名、取消、通知、活动相册
|
||
* 活动与地点关联：活动绑定集合地点、活动产出作品回流地点
|
||
|
||
**阶段 5（商业化 API）**
|
||
|
||
* 推广：投放创建、排期、展示策略、素材
|
||
* 统计：曝光/点击/收藏转化日统计
|
||
* 会员：权益校验、购买、到期、限制策略（上传额度/置顶次数等）
|
||
|
||
---
|
||
|
||
## 管理端（后台/运营端）需要的功能规划
|
||
|
||
管理端的目标是“**保证内容质量 + 提升运营效率 + 可追溯**”。后台一定要有“列表处理效率”，否则审核会拖垮你。
|
||
|
||
**阶段 1（MVP 必须有）**
|
||
|
||
* 登录与权限：管理员/审核员角色
|
||
* 地点审核：待审列表、详情预览（含地图位置与图片）、通过/驳回（填写原因）、下架/恢复
|
||
* 地点管理：编辑纠错（坐标、城市、描述）、合并重复地点（可后置）
|
||
* 图片审核：图片待审、批量通过/驳回
|
||
* 用户管理：用户列表、封禁/解封、查看用户上传历史
|
||
* 操作日志：谁在什么时候做了什么（审计日志）
|
||
|
||
**阶段 2（社区治理）**
|
||
|
||
* 评论审核：待审/举报队列、批量处理
|
||
* 举报中心：按优先级处理（地点/评论/图片/用户），处理结论记录
|
||
* 标签管理：标签新增、合并、禁用、分类维护
|
||
* 风控面板：高频上传/刷分/异常账号提示（起步可以非常简单）
|
||
|
||
**阶段 3（约拍/活动运营）**
|
||
|
||
* 约拍管理：违规约拍单下架、用户投诉处理、黑名单
|
||
* 活动管理：活动审核（如需要）、报名数据导出、群发通知（站内/短信可选）
|
||
|
||
**阶段 5（商业化运营）**
|
||
|
||
* 推广位管理：排期、素材审核、定价策略
|
||
* 报表：曝光/点击/转化、同城/标签维度分析、ROI
|
||
* 商家/合作方管理：资质、合同/发票信息（如果走到这一步）
|
||
|
||
|
||
# 技术栈要求
|
||
|
||
下面是**仅技术栈规定**
|
||
|
||
## 总体形态
|
||
|
||
* 架构：**前后端分离**
|
||
* 用户端：**uni-app**（优先小程序 + H5，后续可打包 App）
|
||
* 服务端：**Python + FastAPI**（REST API 为主）
|
||
* 管理端：**基于 FastAPI 的管理后台**（可用现成 Admin 组件快速生成）
|
||
|
||
---
|
||
|
||
## 前端（uni-app）技术栈规定
|
||
|
||
* 框架：uni-app（建议 Vue3）
|
||
* UI 组件库：固定选一套（如 uView / thorui / NutUI），避免混用
|
||
* 状态管理：Pinia（Vue3）或 uni-app 官方推荐方案（二选一）
|
||
* 网络请求：统一封装（token 自动携带、错误码统一处理）
|
||
* 地图能力：统一选定一个地图服务（国内优先高德/腾讯），多端适配按同一供应商方案走
|
||
* 图片上传：使用对象存储直传（前端上传、后端签名/回调）
|
||
|
||
---
|
||
|
||
## 后端（FastAPI）技术栈规定
|
||
|
||
* Web 框架：FastAPI
|
||
* ASGI 服务器：Uvicorn（生产可配 Gunicorn + UvicornWorker）
|
||
* ORM：SQLAlchemy 2.x（或 SQLModel，二选一且全项目统一）
|
||
* 数据库迁移：Alembic
|
||
* 数据库：PostgreSQL
|
||
|
||
* 强烈建议：**PostGIS**（地理位置检索/附近查询/范围查询）
|
||
* 缓存与消息：Redis
|
||
|
||
* 用途：限流、验证码、缓存、任务队列 broker（如需）
|
||
* 异步任务（可选但建议预留）：Celery（broker 用 Redis）
|
||
* 对象存储：S3 兼容（MinIO/OSS/COS 任一，统一用 S3 兼容 SDK 方案）
|
||
* 鉴权：JWT（access + refresh）或 OAuth2 password flow（统一规范）
|
||
* 数据校验：Pydantic（FastAPI 自带）
|
||
* 日志：标准 logging + 结构化日志（JSON）
|
||
* 错误监控：Sentry（或同类错误上报方案）
|
||
|
||
---
|
||
|
||
## 管理端技术栈规定（基于 FastAPI）
|
||
|
||
* 管理后台：**sqladmin / fastapi-admin**（二选一且统一）
|
||
* 权限：RBAC（至少 admin / moderator / user）
|
||
* 审计：管理操作写入审计日志表（谁、何时、对什么做了什么）
|