molong/vibe_coding
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
vibe_coding/docs/vision/PRD.md
molong 130de0fd5d 初始化
2026-03-05 21:27:11 +08:00

229 lines
12 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Product Requirements Document (PRD)
> **设计库** — 建筑与室内设计案例资产管理平台
>
> 本文档是 AI Agent 理解项目需求的核心入口。功能总览在此，各模块详规见 `docs/specs/`。
---
## 1. 项目概述
### 1.1 项目名称
**设计库** — 面向别墅、民宿、农村自建房、庭院等建筑类型的标准化设计案例数字资产平台
### 1.2 项目愿景
建筑与室内设计行业的案例资产高度碎片化：设计师的作品散落在各类社交平台、本地硬盘和企业内网中，缺乏统一的结构化沉淀；业主在选型时缺少专业、可信赖的案例参考源。
**设计库**致力于构建一个标准化、强结构化的设计案例数字资产平台，让每一个设计案例都成为可检索、可对比、可复用的数字资产，同时为设计师提供专业的作品展示与商机转化通路。
### 1.3 目标用户
| 用户类型 | 描述 | 核心需求 |
|----------|------|----------|
| 设计师（建筑/室内） | 专业设计从业者，需要检索参考案例、沉淀个人作品集 | 高效检索、专业源文件下载、个人品牌展示 |
| 业主 / 建房者 | 计划建房或装修的个人用户，需要灵感参考与设计师对接 | 浏览灵感、筛选户型、了解造价、联系设计师 |
| 平台运营 | 负责案例审核、内容运营、用户管理的后台管理人员 | 案例 CRUD、内容审核、数据统计、用户管理 |
---
## 2. 终端与平台规划
基于业务场景的多样性，采取**分阶段多端覆盖**策略：
| 版本 | 终端 | 定位 | 状态 |
|------|------|------|------|
| V1.0 | PC Web 端 | **生产力中心** — 沉浸式大屏浏览、高阶多维筛选、大体积源文件下载 | 🔵 当前版本 |
| V2.0 | 微信小程序 | **传播与裂变中心** — 碎片化浏览、扫码协同、一键转发、轻量社区互动 | ⚪ 远期规划 |
| V3.0 | Revit / CAD 插件 | **专业工具集成** — 打破信息孤岛、设计资产复用、降低重复设计成本 | ⚪ 远期规划 |
> V1.0 聚焦 PC Web 端，对应脚手架：`Case-Database-Backend`（后端）+ `Case-Database-Frontend-user`（用户端）+ `Case-Database-Frontend-admin`（管理端）+ `Case-Database-Frontend-shared`（共享层）。
---
## 3. 核心功能
> **终端归属说明**：F1 ~ F4 为用户端功能（`Case-Database-Frontend-user`），F5 为管理端功能（`Case-Database-Frontend-admin`）。后端 API（`Case-Database-Backend`）同时服务两端，共享层（`Case-Database-Frontend-shared`）提供类型定义与公共逻辑。
>
> **详规入口**：每个模块的用户故事、功能描述、交互细节、验收标准见对应详规文件。
| 优先级 | 模块 | 功能 | 状态 | 详规 |
|--------|------|------|------|------|
| P0 | F1 认证 | 账号密码登录 | ⚪ 待开发 | [F1-认证与账户](../specs/F1-认证与账户.md) |
| P0 | F1 认证 | 短信验证码登录 | ⚪ 待开发 | [F1-认证与账户](../specs/F1-认证与账户.md) |
| P0 | F1 认证 | 扫码登录 | ⚪ 待开发 | [F1-认证与账户](../specs/F1-认证与账户.md) |
| P1 | F1 认证 | 微信 / QQ 第三方授权 | ⚪ 待开发 | [F1-认证与账户](../specs/F1-认证与账户.md) |
| P1 | F1 认证 | 自动登录保持 / 忘记密码 | ⚪ 待开发 | [F1-认证与账户](../specs/F1-认证与账户.md) |
| P1 | F1 认证 | 深色 / 浅色主题切换 | ⚪ 待开发 | [F1-认证与账户](../specs/F1-认证与账户.md) |
| P0 | F2 首页 | 分类频道导航 | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P0 | F2 首页 | 全局模糊搜索 | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P0 | F2 首页 | Hero 焦点推荐位 | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P0 | F2 首页 | 富数据项目卡片网格 | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P0 | F2 首页 | 风格 Tab 快捷筛选 | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P1 | F2 首页 | 高级多维筛选器 | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P1 | F2 首页 | 网格 / 列表视图切换 | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P1 | F2 首页 | 收藏夹快捷入口 | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P2 | F2 首页 | 热门标签 / 搜索预设热词 | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P2 | F2 首页 | 底部订阅资讯（邮箱收集） | ⚪ 待开发 | [F2-首页](../specs/F2-首页.md) |
| P0 | F3 详情 | 富媒体多维图库 | ⚪ 待开发 | [F3-案例详情](../specs/F3-案例详情.md) |
| P0 | F3 详情 | 5 维专业参数看板 | ⚪ 待开发 | [F3-案例详情](../specs/F3-案例详情.md) |
| P0 | F3 详情 | 侧边栏核心信息聚合 | ⚪ 待开发 | [F3-案例详情](../specs/F3-案例详情.md) |
| P0 | F3 详情 | 数字资产分发中心（文件下载） | ⚪ 待开发 | [F3-案例详情](../specs/F3-案例详情.md) |
| P1 | F3 详情 | 用户评论区 | ⚪ 待开发 | [F3-案例详情](../specs/F3-案例详情.md) |
| P1 | F3 详情 | 点赞 / 收藏 / 分享 | ⚪ 待开发 | [F3-案例详情](../specs/F3-案例详情.md) |
| P1 | F3 详情 | 设计理念 & 主创团队展示 | ⚪ 待开发 | [F3-案例详情](../specs/F3-案例详情.md) |
| P2 | F3 详情 | 智能相似推荐 | ⚪ 待开发 | [F3-案例详情](../specs/F3-案例详情.md) |
| P0 | F4 设计师 | 设计师名片档案 | ⚪ 待开发 | [F4-设计师档案](../specs/F4-设计师档案.md) |
| P0 | F4 设计师 | 作品集矩阵展示 | ⚪ 待开发 | [F4-设计师档案](../specs/F4-设计师档案.md) |
| P1 | F4 设计师 | 资历标签 / 设计理念 / 荣誉奖项 | ⚪ 待开发 | [F4-设计师档案](../specs/F4-设计师档案.md) |
| P2 | F4 设计师 | 关注按钮 / 联系设计师入口 | ⚪ 待开发 | [F4-设计师档案](../specs/F4-设计师档案.md) |
| P0 | F5 管理端 | 案例 CRUD（创建 / 编辑 / 发布 / 下架） | ⚪ 待开发 | [F5-内容运营](../specs/F5-内容运营.md) |
| P0 | F5 管理端 | 分阶段文件上传体系 | ⚪ 待开发 | [F5-内容运营](../specs/F5-内容运营.md) |
| P0 | F5 管理端 | 案例结构化参数录入 | ⚪ 待开发 | [F5-内容运营](../specs/F5-内容运营.md) |
| P0 | F5 管理端 | 首页轮播管理 | ⚪ 待开发 | [F5-内容运营](../specs/F5-内容运营.md) |
| P0 | F5 管理端 | 专题与精选管理 | ⚪ 待开发 | [F5-内容运营](../specs/F5-内容运营.md) |
| P0 | F5 管理端 | 分类与标签字典 | ⚪ 待开发 | [F5-内容运营](../specs/F5-内容运营.md) |
| P1 | F5 管理端 | 设计师档案管理 | ⚪ 待开发 | [F5-用户权限](../specs/F5-用户权限.md) |
| P1 | F5 管理端 | 评论审核 | ⚪ 待开发 | [F5-用户权限](../specs/F5-用户权限.md) |
| P1 | F5 管理端 | 用户管理与权限分配 | ⚪ 待开发 | [F5-用户权限](../specs/F5-用户权限.md) |
| P1 | F5 管理端 | 系统配置（站点信息 / SEO / 水印） | ⚪ 待开发 | [F5-系统运维](../specs/F5-系统运维.md) |
| P2 | F5 管理端 | 数据仪表盘 | ⚪ 待开发 | [F5-系统运维](../specs/F5-系统运维.md) |
| P2 | F5 管理端 | 操作日志与审计 | ⚪ 待开发 | [F5-系统运维](../specs/F5-系统运维.md) |
---
## 4. 非功能需求
### 4.1 性能要求
| 指标 | 目标 |
|------|------|
| 首屏加载（FCP） | < 2s |
| API 响应（P95） | < 200ms |
| 图片加载策略 | 懒加载 + WebP 格式优先 |
| 列表渲染 | 虚拟滚动（长列表场景） |
| 并发用户 | 1000+ |
### 4.2 安全要求
- [ ] JWT + Refresh Token 双令牌认证机制
- [ ] RBAC 角色权限控制（管理端）
- [ ] HTTPS 全站强制
- [ ] 敏感操作审计日志（登录、下载、删除）
- [ ] 文件下载防盗链
- [ ] API 接口限流（令牌桶 / 滑动窗口）
### 4.3 兼容性
- 浏览器：Chrome 90+、Firefox 88+、Safari 14+、Edge 90+
- 分辨率：最小支持 1280px 宽度（PC 端优先）
### 4.4 设计系统
| 项目 | 规范 |
|------|------|
| 主色 | `#C41E3A`（红色系） |
| 金色辅助 | `#C5A059`（精选标识） |
| 标题字体 | Noto Serif SC |
| 正文字体 | Inter / Noto Sans SC |
| 数据字体 | IBM Plex Mono |
| 主题 | 支持深色模式（Dark Mode） |
---
## 5. 技术约束
### 5.1 技术栈
- **前端**: Vue 3 + Vite + TypeScript + Tailwind CSS + Pinia
- 管理端：Element Plus（标准后台）
- 用户端：Headless UI + 自定义组件（品牌化设计）
- **后端**: PHP 8.1+ / Hyperf 3.1 / Swoole 5.0+
- **数据库**: MySQL 8.1 + Redis 7.x
- **部署**: Docker Compose / Nginx
> 详见 [系统架构](../architecture/system-design.md)
### 5.2 第三方服务
| 服务 | 用途 | 状态 |
|------|------|------|
| 微信开放平台 | OAuth 登录授权 | ⚪ 待集成 |
| QQ 互联 | OAuth 登录授权 | ⚪ 待集成 |
| 阿里云 SMS | 短信验证码 | ⚪ 待集成 |
| 阿里云 OSS / MinIO | 文件存储（CAD / PDF / 图片） | ⚪ 待集成 |
| CDN | 静态资源与图片加速 | ⚪ 待集成 |
---
## 6. 里程碑
| 里程碑 | 用户端交付物 | 管理端交付物 |
|--------|-------------|-------------|
| Alpha | 登录 + 首页（频道 / 搜索 / 卡片 / 筛选）+ 详情页（图库 / 参数 / 下载） | 案例 CRUD + 分阶段文件上传 + 轮播管理 + 分类标签字典 |
| Beta | 设计师主页 + 收藏体系 + 评论系统 + 高级筛选 + 主题切换 | 专题精选管理 + 设计师管理 + 评论审核 + 用户管理 + 系统配置 |
| GA | 性能优化 + 安全加固 + 第三方登录 + 智能推荐 | 数据仪表盘 + 操作日志审计 + 全链路安全加固 |
---
## 7. 术语表
| 术语 | 定义 |
|------|------|
| 面宽（开间） | 建筑物主要朝向的外墙面宽度，通常为房屋正面的宽度 |
| 进深 | 建筑物垂直于面宽方向的深度，即从前墙到后墙的距离 |
| 占地面积 | 建筑物底层（首层）的外墙外围水平投影面积 |
| 建筑总面积 | 各楼层建筑面积之和 |
| 户型布局 | 房屋的功能房间配置，通常以"X 室 X 厅 X 卫"表示 |
| 户型逻辑 | 房间功能分区与动线组织的设计合理性 |
| 结构类型 | 建筑的主体承重结构形式（如框架结构、砖混结构、钢结构等） |
| 基础类型 | 建筑地基的构造形式（如条形基础、筏板基础、独立基础等） |
| 抗震设防 | 建筑设计中针对地震灾害所采取的结构措施等级 |
| 外立面材料 | 建筑外墙的饰面材料（如真石漆、文化石、面砖等） |
| 屋面构造 | 屋顶的结构组成和防水保温做法 |
| 造价预估 | 建筑施工的预计总费用（不含土地成本） |
| 数字资产 | 案例相关的可下载专业文件（CAD 图纸、PDF 方案、高清效果图等） |
| 设计阶段 | 案例数字资产的生产环节分类，包括平面、外观、施工图、结构、室内、庭院等阶段 |
| 数字资产包 | 一个案例按设计阶段归集的全部可下载文件的集合 |
| CAD (.dwg) | AutoCAD 原生图纸格式，建筑设计行业的标准工程图文件 |
| Revit (.rvt) | Autodesk Revit 建筑信息模型文件，包含三维参数化建筑数据 |
| 精选标记 | 运营人员在管理端为优质案例添加的推荐标识，在用户端显示为金色徽章 |
| 专题 | 运营策划的主题内容合集，关联多个案例并附带编辑性描述 |
| RBAC | 基于角色的访问控制（Role-Based Access Control），通过角色分配管理端操作权限 |
---
## 8. 参考文档
### 架构与技术
- [系统架构](../architecture/system-design.md)
- [数据模型](../architecture/data-model.md)
- [API 契约](../architecture/api-contracts.md)
- [双前端架构策略](../architecture/frontend-strategy.md)
### 设计规范
- [管理端 UI 规范](../guides/ui-specs-admin.md)
- [用户端 UI 规范](../guides/ui-specs-user.md)
### 功能模块详规
- [F1 — 认证与账户中心](../specs/F1-认证与账户.md)
- [F2 — 首页](../specs/F2-首页.md)
- [F3 — 案例详情引擎](../specs/F3-案例详情.md)
- [F4 — 设计师数字档案](../specs/F4-设计师档案.md)
- [F5 — 内容运营管理](../specs/F5-内容运营.md)
- [F5 — 用户与权限管理](../specs/F5-用户权限.md)
- [F5 — 系统配置与监控](../specs/F5-系统运维.md)
### 参考原型
- `docs/reference/` 目录下 HTML 文件
---
*最后更新: 2026-03-02*
*文档负责人: 产品团队*
Reference in New Issue View Git Blame Copy Permalink