211 lines
11 KiB
Markdown
211 lines
11 KiB
Markdown
# 需求分析 — 物流企业连接平台
|
||
|
||
> 状态：需求梳理阶段（v1.0，2026-08-31，按新定位重写）
|
||
> 说明：本文档为项目需求基线，后续数据库设计、API 设计、开发排期均以此为基础。
|
||
|
||
## 一、项目定位
|
||
|
||
> **物流行业的 B2B 企业连接平台。** 各物流企业在平台内建立自己的企业空间（主页、关于、文章、服务等），平台提供企业目录、搜索发现、资讯内容和企业间沟通（私信、行业群聊）能力，帮助企业找到彼此、建立联系、开展业务交流。
|
||
|
||
一句话概括：**物流企业目录 + 企业内容社区 + 企业间沟通网络**。
|
||
|
||
关键认知：平台是主角，企业是平台内的成员。企业页面**不是独立官网**，而是平台内的标准化企业空间——产品的核心价值是「连接」（企业越多、越容易找到对方，平台越有价值），而非「建站」。
|
||
|
||
### 1.1 与建站 SaaS 的关系
|
||
|
||
本项目一期**不做**自由建站：企业空间采用固定页面结构的标准化模板，企业只填表单、发内容。块级可视化编辑作为**二期付费增强能力**预留（见 6.2），数据模型上预留页面配置的扩展点。
|
||
|
||
## 二、核心模式
|
||
|
||
```text
|
||
物流连接平台 www.demo.com
|
||
│
|
||
┌───────────┬───────┴───────┬────────────┐
|
||
↓ ↓ ↓ ↓
|
||
企业目录 资讯流 搜索 消息(IM)
|
||
│ │ │ │
|
||
└─────┬─────┴───────┬───────┘ │
|
||
↓ ↓ │
|
||
/company/abc /company/xyz ← 企业空间 │
|
||
│ │ │
|
||
└─────────────┴────────────────────┘
|
||
企业间私信 / 行业群聊
|
||
```
|
||
|
||
- 企业空间是企业对外展示的窗口（模板化主页 + 内容）；
|
||
- 目录、搜索、资讯流负责「发现」，IM 负责「连接」；
|
||
- 平台导航全站常驻，企业空间是平台内的子区域，不是独立网站。
|
||
|
||
## 三、用户角色
|
||
|
||
| 角色 | 说明 | 主要诉求 |
|
||
|---|---|---|
|
||
| 个人用户 | 注册登录的平台账号，可归属于某企业（成员/管理员）或独立存在 | 浏览、搜索、关注、聊天、（企业成员）维护本企业空间 |
|
||
| 企业管理员 | 企业空间的管理者（企业认证通过后获得） | 维护企业信息、发布文章、管理成员、处理消息 |
|
||
| 平台管理员 | 平台运营方 | 企业审核认证、内容审核、群组管理、行业数据维护 |
|
||
| 访客 / 搜索引擎 | 未登录访问者 | 浏览企业空间与文章；搜索引擎收录 |
|
||
|
||
## 四、功能需求
|
||
|
||
### 4.1 企业目录与搜索（流量入口）
|
||
|
||
- 企业列表页：按**地区、航线/线路（美线/欧线/东南亚…）、服务类型（海运/空运/陆运/报关/仓储…）、认证状态**等维度筛选与排序；
|
||
- 关键词搜索：企业名、服务、线路（二期可扩展文章全文搜索）；
|
||
- 企业详情卡片：Logo、名称、认证标识、主营线路、服务标签、地区。
|
||
|
||
> 目录的检索维度（线路、服务类型）是物流平台最有价值的检索轴，筛选器的数据模型需要可运营维护（平台管理员维护线路/服务字典）。
|
||
|
||
### 4.2 企业空间（标准化模板）
|
||
|
||
固定页面结构，企业通过表单配置内容：
|
||
|
||
```text
|
||
/company/abc
|
||
├── 主页：企业封面、简介、主营服务、优势线路、最新文章
|
||
├── 关于：公司介绍、资质证照、发展历程、团队
|
||
├── 文章：企业发布的资讯/案例（列表 + 详情）
|
||
├── 服务：服务项目与线路明细
|
||
└── 联系：联系方式、地址、地图、（登录后）在线沟通入口
|
||
```
|
||
|
||
- 页面结构一期固定，企业只填内容（文字、图片、标签选择）；
|
||
- 数据模型上为页面配置预留结构化扩展点（JSON 配置字段），二期接入块编辑器时平滑升级；
|
||
- 企业空间内导航为页内 tab（非独立导航栏），平台导航全站常驻。
|
||
|
||
### 4.3 用户体系与认证
|
||
|
||
- 个人账号注册/登录（手机号/邮箱）；
|
||
- 个人可申请绑定企业成为成员，企业管理员可邀请/管理成员与角色；
|
||
- **企业认证**：提交营业执照等材料，平台管理员审核；认证通过后获得认证标识并可管理企业空间；
|
||
- 个人侧「我的」：个人资料、我的消息、我的企业、浏览/关注记录。
|
||
|
||
### 4.4 企业间交流（IM）
|
||
|
||
- **一对一私信**：用户（企业成员）之间的点对点聊天；
|
||
- **行业群聊**：按线路/航线/服务主题建群（如「美线交流群」「华南拖车群」），支持平台建群（官方群）与企业用户建群；
|
||
- 消息能力：文字、图片（一期）；未读提醒、离线消息、消息记录；
|
||
- 会话入口：企业空间「在线沟通」按钮、目录卡片、消息中心；
|
||
- 内容安全：消息与文章需可审计（平台管理员可依规处置违规内容）。
|
||
|
||
> 结构化询价/报价单（起运地→目的地、柜型、时效）未列入一期，作为后续业务化方向在 6.2 预留。
|
||
|
||
### 4.5 资讯流
|
||
|
||
- 各企业发布文章的聚合流，按时间/标签浏览；
|
||
- 文章类型：行业资讯、公司动态、案例分享（可由平台设定分类字典）；
|
||
- 平台管理员可置顶/推荐文章。
|
||
|
||
### 4.6 SEO（平台级能力）
|
||
|
||
- 企业空间页、文章详情页 SSR 渲染，搜索引擎可见完整 HTML；
|
||
- 平台自动生成每页 Title/Description/Open Graph；企业名、线路类关键词（如「美线 海运 物流公司」）是天然长尾流量来源；
|
||
- `/sitemap.xml` 聚合企业空间与文章页；robots.txt 自动生成。
|
||
|
||
### 4.7 管理端（平台运营后台）
|
||
|
||
- 企业管理与认证审核
|
||
- 用户管理
|
||
- 内容（文章）审核与管理
|
||
- 群组管理与违规处置
|
||
- 字典维护：线路/航线、服务类型、文章分类等运营数据
|
||
- 平台数据看板（企业数、活跃、消息量）
|
||
|
||
管理端形态：Vue 3 + Vite 独立后台，对接 Spring Boot API。
|
||
|
||
## 五、总体布局与信息架构
|
||
|
||
```text
|
||
┌─────────────────────────────────────────┐
|
||
│ 平台导航（全站常驻） │
|
||
│ 首页 / 企业目录 / 资讯 / [搜索框] / 消息 / 我的 │
|
||
├─────────────────────────────────────────┤
|
||
│ │
|
||
│ 当前页面内容 │
|
||
│ · 平台页面：首页、目录、资讯流、搜索结果 │
|
||
│ · 企业空间 /company/abc： │
|
||
│ 企业头部（封面/Logo/名称/认证/关注/沟通） │
|
||
│ 页内 tab：主页 | 关于 | 文章 | 服务 | 联系 │
|
||
│ │
|
||
├─────────────────────────────────────────┤
|
||
│ 平台页脚 │
|
||
└─────────────────────────────────────────┘
|
||
```
|
||
|
||
原则：
|
||
|
||
- **一个平台，一套导航**。平台导航不因进入企业空间而消失——访客始终知道自己在哪，搜索、消息入口随时可达；
|
||
- 企业空间的「企业头部 + tab 页签」承载企业识别，不做第二套全站导航栏；
|
||
- 企业空间主色调等轻量主题可配置，但整体视觉框架与平台一致。
|
||
|
||
## 六、总体技术架构
|
||
|
||
```text
|
||
用户 / 搜索引擎
|
||
│
|
||
www.demo.com
|
||
│
|
||
┌───────┴────────┐
|
||
│ Nuxt 4 │
|
||
│ 企业空间 SSR │
|
||
│ SEO / 目录/资讯 │
|
||
└───────┬────────┘
|
||
│
|
||
API Server（Spring Boot）
|
||
│
|
||
┌───────────────┼───────────────┐
|
||
↓ ↓ ↓
|
||
Database Redis OSS
|
||
│ │ │
|
||
用户/企业/认证 会话/缓存 图片素材
|
||
文章/字典数据 IM 在线状态
|
||
│
|
||
IM 服务（WebSocket，Spring 生态内实现或独立网关）
|
||
私信 / 群聊 / 离线消息 / 未读推送
|
||
```
|
||
|
||
| 层 | 技术选型 | 职责 |
|
||
|---|---|---|
|
||
| 网站端 | Nuxt 4 + Nuxt UI v4（本仓库 `link-nuxt`） | 平台门户、目录、资讯、企业空间 SSR、SEO |
|
||
| 管理端 | Vue 3 + Vite | 平台运营后台 |
|
||
| API 层 | Spring Boot | 业务接口、认证鉴权、审核流 |
|
||
| IM 层 | Spring 生态 WebSocket（或独立网关） | 私信、群聊、消息存储与推送 |
|
||
| 数据层 | Database / Redis / OSS | 业务数据、缓存与在线状态、素材 |
|
||
|
||
架构要点：
|
||
|
||
- 企业空间页面为**运行时 SSR**（数据在库、构建时不可知），部署形态为 Node 服务器或支持 SSR 的运行时；
|
||
- IM 与业务 API 分离部署，长连接不占用业务请求线程；消息先落库再推送，保证可靠性与离线消息；
|
||
- Redis 承担会话缓存、IM 在线状态、热门目录/文章缓存。
|
||
|
||
## 七、边界与非目标（一期）
|
||
|
||
| 事项 | 一期决策 | 说明 |
|
||
|---|---|---|
|
||
| 可视化建站（块编辑器） | 不做，二期付费增强 | 一期标准化模板 + 表单；数据模型预留 JSON 配置扩展点 |
|
||
| 自定义域名 | 不做 | 企业空间始终在平台域名下，无独立域名诉求 |
|
||
| 询价/报价单 | 不做，预留 | 私信中先以文字沟通，结构化询价为后续业务化方向 |
|
||
| 文章全文搜索 | 不做，预留 | 一期关键词匹配，后续接入搜索引擎（如 ES） |
|
||
| 多语言 / 国际化 | 不做 | 视运营需要后置 |
|
||
|
||
## 八、建议实施顺序
|
||
|
||
1. **基础链路**：用户/企业数据模型 + 企业空间标准化模板页，跑通 `/company/abc` 的 SSR 渲染；
|
||
2. **目录与搜索**：企业列表、筛选器、线路/服务字典；
|
||
3. **用户体系**：注册登录、企业认证流、成员角色；
|
||
4. **资讯流与文章**：企业发文、聚合流、文章详情 SSR + SEO（sitemap/meta）；
|
||
5. **IM**：私信 → 群聊 → 离线/未读，独立 WebSocket 服务；
|
||
6. **管理端**：审核流、字典维护、数据看板；
|
||
7. **二期**：块级可视化编辑器（付费）、结构化询价、全文搜索。
|
||
|
||
## 九、术语表
|
||
|
||
| 术语 | 含义 |
|
||
|---|---|
|
||
| 企业空间（Company Space） | 企业在平台内的展示空间：主页/关于/文章/服务/联系，URL 为 `/company/{slug}` |
|
||
| 企业认证 | 企业提交营业执照等材料、平台审核后获得认证标识与空间管理权 |
|
||
| 目录（Directory） | 企业列表与筛选检索，平台的流量入口 |
|
||
| 字典 | 平台运营维护的枚举数据：线路/航线、服务类型、文章分类等 |
|
||
| IM | 站内即时通讯：一对一私信与行业群聊 |
|
||
| 行业群 | 按线路/服务主题组建的群聊，官方或用户创建 |
|
||
| SEO 层 | 平台自动为企业空间与文章生成的 meta、sitemap 等收录能力 |
|