# 需求分析 — 物流企业连接平台

> 状态：需求梳理阶段（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 等收录能力 |