workspace/code/link-site/需求分析.md

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

状态：需求梳理阶段（v1.0，2026-08-31，按新定位重写） 说明：本文档为项目需求基线，后续数据库设计、API 设计、开发排期均以此为基础。

一、项目定位

物流行业的 B2B 企业连接平台。 各物流企业在平台内建立自己的企业空间（主页、关于、文章、服务等），平台提供企业目录、搜索发现、资讯内容和企业间沟通（私信、行业群聊）能力，帮助企业找到彼此、建立联系、开展业务交流。

一句话概括：物流企业目录 + 企业内容社区 + 企业间沟通网络。

关键认知：平台是主角，企业是平台内的成员。企业页面不是独立官网，而是平台内的标准化企业空间——产品的核心价值是「连接」（企业越多、越容易找到对方，平台越有价值），而非「建站」。

1.1 与建站 SaaS 的关系

本项目一期不做自由建站：企业空间采用固定页面结构的标准化模板，企业只填表单、发内容。块级可视化编辑作为二期付费增强能力预留（见 6.2），数据模型上预留页面配置的扩展点。

二、核心模式

                    物流连接平台 www.demo.com
                            │
        ┌───────────┬───────┴───────┬────────────┐
        ↓           ↓               ↓            ↓
     企业目录      资讯流          搜索          消息(IM)
        │           │               │            │
        └─────┬─────┴───────┬───────┘            │
              ↓             ↓                    │
        /company/abc   /company/xyz  ← 企业空间   │
              │             │                    │
              └─────────────┴────────────────────┘
                        企业间私信 / 行业群聊

• 企业空间是企业对外展示的窗口（模板化主页 + 内容）；
• 目录、搜索、资讯流负责「发现」，IM 负责「连接」；
• 平台导航全站常驻，企业空间是平台内的子区域，不是独立网站。

三、用户角色

角色	说明	主要诉求
个人用户	注册登录的平台账号，可归属于某企业（成员/管理员）或独立存在	浏览、搜索、关注、聊天、（企业成员）维护本企业空间
企业管理员	企业空间的管理者（企业认证通过后获得）	维护企业信息、发布文章、管理成员、处理消息
平台管理员	平台运营方	企业审核认证、内容审核、群组管理、行业数据维护
访客 / 搜索引擎	未登录访问者	浏览企业空间与文章；搜索引擎收录

四、功能需求

4.1 企业目录与搜索（流量入口）

• 企业列表页：按地区、航线/线路（美线/欧线/东南亚…）、服务类型（海运/空运/陆运/报关/仓储…）、认证状态等维度筛选与排序；
• 关键词搜索：企业名、服务、线路（二期可扩展文章全文搜索）；
• 企业详情卡片：Logo、名称、认证标识、主营线路、服务标签、地区。

目录的检索维度（线路、服务类型）是物流平台最有价值的检索轴，筛选器的数据模型需要可运营维护（平台管理员维护线路/服务字典）。

4.2 企业空间（标准化模板）

固定页面结构，企业通过表单配置内容：

/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。

五、总体布局与信息架构

┌─────────────────────────────────────────┐
│ 平台导航（全站常驻）                        │
│ 首页 / 企业目录 / 资讯 / [搜索框] / 消息 / 我的 │
├─────────────────────────────────────────┤
│                                         │
│   当前页面内容                             │
│   · 平台页面：首页、目录、资讯流、搜索结果       │
│   · 企业空间 /company/abc：               │
│       企业头部（封面/Logo/名称/认证/关注/沟通）  │
│       页内 tab：主页 | 关于 | 文章 | 服务 | 联系 │
│                                         │
├─────────────────────────────────────────┤
│ 平台页脚                                  │
└─────────────────────────────────────────┘

原则：

• 一个平台，一套导航。平台导航不因进入企业空间而消失——访客始终知道自己在哪，搜索、消息入口随时可达；
• 企业空间的「企业头部 + tab 页签」承载企业识别，不做第二套全站导航栏；
• 企业空间主色调等轻量主题可配置，但整体视觉框架与平台一致。

六、总体技术架构

                  用户 / 搜索引擎
                        │
                 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 等收录能力