《智能 AI 商业服务系统建设项目》完整开发规划 V1.0
项目规划版本:V1.0 · 规划状态:待确认 · 项目阶段:开发前规划
本规划根据目前已经确认的业务需求重新整理,并纳入刚才提出的调整:互联网信息搜索由后台统一控制,支持配置和选择多个主流 AI 服务,而不是固定依赖某一家 AI 或某一个搜索引擎。
本项目采用模块化、分阶段开发方式。先明确业务逻辑、系统架构、文件职责和数据结构,再逐项实施。
一、项目基本定位
1.1 项目名称
智能 AI 商业服务系统建设项目
项目提出方:
陕西渭南临渭多模态智能技术研发工作室
Multimodal Intelligent Technology R&D Studio, Linwei District, Weinan, Shaanxi, China
1.2 项目定位
建设一个面向普通用户的 AI 商业服务发现与推荐系统。
用户通过自然语言描述自己需要的产品或服务,系统理解用户需求,优先从后台维护的服务商资料中寻找匹配对象。
如果后台没有合适的服务商,则根据管理员配置调用外部 AI 服务进行互联网信息搜索,发现可能符合需求的服务商,整理真实来源信息后向用户展示。
系统的核心业务是:
理解需求 → 发现服务商 → 匹配服务商 → 推荐服务商 → 展示信息。
1.3 服务对象
-
普通产品需求用户。
-
普通服务需求用户。
-
有明确商业服务需求的个人用户。
本系统不是企业入驻平台,不是电商交易平台,也不是传统 B2B 供需撮合平台。
二、第一版建设目标
第一版只实现核心服务发现和推荐能力,不进行无关功能扩展。
第一版必须实现的功能
-
用户能够通过自然语言输入产品或服务需求。
-
系统能够通过 AI 理解用户需求。
-
系统能够查询后台维护的服务商资料。
-
系统优先推荐后台已有的匹配服务商。
-
后台没有匹配结果时,调用管理员选择的外部 AI 联网搜索服务。
-
系统能够整理搜索结果、服务商介绍及真实来源链接。
-
前台能够展示推荐结果并提供原始信息来源。
-
管理员能够管理服务商和 AI 服务配置。
第一版明确不建设的功能
-
用户会员注册和登录。
-
用户积分、等级及会员体系。
-
购物车、订单和支付。
-
商品交易及在线结算。
-
厂家自主入驻。
-
商家会员收费。
-
用户查询记录数据库(目前不纳入第一版)。
-
企业 CRM。
-
无关的统计分析和营销模块。
三、总体系统架构
系统采用前后台分离的模块化架构。
3.1 前台系统
前台面向普通用户,只负责:
-
接收用户需求。
-
提交需求。
-
接收系统处理结果。
-
展示 AI 回复。
-
展示服务商信息。
-
展示服务商官网及信息来源链接。
前台不直接持有任何 AI API 密钥。
3.2 后台管理系统
后台由管理员使用,负责:
-
管理员身份验证。
-
服务商资料管理。
-
服务商推荐状态管理。
-
服务商推荐优先级管理。
-
AI 服务配置。
-
AI 服务用途设置。
-
AI 服务选择和切换。
-
API 密钥管理。
-
系统运行日志查看。
3.3 应用服务层
负责协调各个业务模块:
-
用户需求处理。
-
AI 语义理解。
-
服务商资料查询。
-
动态语义匹配。
-
外部 AI 搜索调用。
-
搜索结果整理。
-
推荐结果生成。
3.4 数据层
使用 MySQL 保存:
-
管理员账户信息。
-
服务商资料。
-
AI 服务配置。
-
AI 服务用途与选择状态。
-
系统必要的配置及运行记录。
第一版不保存普通用户的历史查询记录。
四、核心业务逻辑规划
这是整个项目最重要的部分。
4.1 用户需求处理流程
用户在前台输入:
例如:
“我想找一家能够生产儿童电动牙刷的厂家。”
系统接收原始需求,交由当前配置的 AI 语义理解服务处理。
语义理解需要识别:
-
用户需要什么。
-
用户描述的产品或服务是什么。
-
用户提出了哪些限制条件。
-
用户希望得到什么类型的推荐结果。
这里不建立固定行业分类,也不预设牙刷、医疗、机械、电子等行业专用字段。
AI 应根据用户实际表达动态理解需求。
4.2 后台服务商优先匹配
需求理解完成后,系统查询后台服务商数据库。
后台服务商资料采用通用信息结构,例如:
| 信息 | 用途 |
|---|---|
| 服务商名称 | 识别服务商 |
| 服务商介绍 | 理解业务内容 |
| 业务描述 | 描述提供的产品或服务 |
| 业务关键词 | 提供辅助匹配信息 |
| 官网地址 | 提供访问入口 |
| 信息来源 | 记录资料来源 |
| 推荐状态 | 控制是否参与推荐 |
| 推荐优先级 | 控制推荐顺序 |
| 创建及更新时间 | 资料管理 |
这些是通用管理属性,不是固定行业字段。
业务内容由管理员按实际服务商情况填写,不把某个行业的专属属性固化到代码中。
匹配原则
-
AI 理解用户当前需求。
-
根据需求动态理解后台服务商资料。
-
判断服务商是否符合用户需求。
-
排除已停用或不参与推荐的服务商。
-
对符合要求的服务商按推荐优先级排序。
-
将符合条件的服务商交给结果生成模块。
不允许仅仅因为关键词相同,就直接认定服务商符合用户需求。
4.3 后台没有匹配结果时的联网搜索
如果后台没有找到符合需求的服务商,系统进入外部信息发现流程。
处理逻辑:
-
读取后台当前 AI 服务配置。
-
获取管理员选择的联网搜索服务。
-
将用户需求及必要的语义信息发送给对应服务。
-
调用该服务支持的联网搜索能力。
-
获取搜索结果。
-
整理服务商名称、业务介绍、官网和来源链接。
-
交给结果组织模块。
-
返回前台展示。
这里要明确:
AI 模型本身不一定具备联网搜索能力。
后台选择服务时,必须区分普通 AI 模型和实际支持联网搜索的服务或接口。不能仅凭模型名称就认定它能够搜索互联网。
五、AI 服务管理系统规划
这是本次重新规划的重点。
5.1 多 AI 服务配置
系统不固定绑定某一个 AI 服务商。
后台允许管理员配置多个 AI 服务,例如:
AI 服务配置示意
智谱 AI
语义理解、结果整理;联网搜索以具体接口能力为准。
DeepSeek
AI 语义处理;是否支持联网搜索取决于实际接入服务。
通义千问
AI 语义处理及具体接口支持的搜索能力。
Kimi
可根据实际开放的 API 和联网搜索能力接入。
其他 AI 服务
通过新增适配器扩展,不要求修改核心业务流程。
以上是候选服务清单,并非已经确认所有服务均有可用的联网搜索 API。具体接入时再核实各服务商的正式接口、授权和能力。
5.2 AI 服务用途划分
每个 AI 服务可以配置不同用途:
| 服务用途 | 具体工作 |
|---|---|
| 需求语义理解 | 理解用户需求 |
| 联网信息搜索 | 发现互联网服务商 |
| 结果组织 | 整理搜索结果并生成回复 |
同一家 AI 服务可以承担多个用途,前提是其接口实际支持。
不同 AI 服务也可以分别承担不同用途。
例如:
-
智谱 AI:需求理解。
-
Kimi:联网搜索。
-
智谱 AI:推荐结果组织。
也可以由一个服务完成全部支持的任务。
5.3 后台 AI 服务管理功能
管理员可以:
-
新增 AI 服务。
-
编辑 AI 服务。
-
删除 AI 服务。
-
配置服务商名称。
-
配置 API 地址。
-
配置 API 密钥。
-
配置模型名称。
-
设置服务用途。
-
设置是否启用。
-
设置当前默认服务。
-
调整服务优先级。
-
查看调用状态。
-
查看错误信息。
-
更换 AI 服务而不修改核心业务代码。
API 密钥必须保存在服务器端,前台不得输出密钥。
5.4 AI 服务适配架构
采用独立适配器:
app/adapters/
AI服务适配器
智谱适配器
DeepSeek适配器
通义千问适配器
Kimi适配器
其他AI适配器
以上是逻辑职责示意,具体文件名称和类结构需要在详细设计阶段确定。
核心业务模块不直接依赖某个 AI 服务商的请求格式。
这样未来增加或更换 AI 服务时,不需要重写整个推荐系统。
六、后台服务商管理规划
6.1 服务商资料管理
后台可以:
-
新增服务商。
-
编辑服务商。
-
删除服务商。
-
启用或停用服务商。
-
设置是否参与推荐。
-
设置推荐优先级。
-
查看服务商详细资料。
6.2 服务商资料原则
不预设行业字段。
例如:
儿童电动牙刷生产商、网站建设服务商、设备维修商、法律咨询服务商,都使用同一套通用资料管理机制。
具体业务信息通过服务商介绍和业务描述表达。
系统根据用户的实际需求动态理解这些资料,而不是通过固定的行业字段匹配。
6.3 服务商资料来源
后台服务商信息由管理员维护。
互联网搜索发现的信息则作为外部搜索结果处理。
两者应当区分:
-
后台已维护服务商。
-
外部搜索发现服务商。
未经管理员确认的外部搜索结果,不自动写入后台服务商数据库。
七、推荐结果生成规划
7.1 后台服务商推荐结果
当后台存在匹配服务商时,优先展示后台服务商。
7.2 互联网搜索推荐结果
当后台没有匹配服务商时,展示外部搜索发现的服务商。
7.3 推荐信息展示内容
| 展示项目 | 内容 |
|---|---|
| 服务商名称 | 搜索发现的名称 |
| 业务介绍 | 与用户需求相关的业务描述 |
| 官网地址 | 服务商官方网站 |
| 信息来源 | 原始网页或搜索来源 |
| 推荐说明 | 说明与用户需求的关联 |
需要特别注意:
-
搜索摘要不能直接当作已核实事实。
-
不得凭空生成官网地址。
-
不得把不存在的服务商说成真实服务商。
-
应保留可访问的原始来源链接。
-
搜索结果缺乏证据时,应明确标注信息待核实。
八、数据库规划
第一版使用 MySQL。
初步规划以下数据实体:
| 数据实体 | 主要用途 |
|---|---|
| 管理员 | 后台登录与身份验证 |
| 服务商 | 保存后台服务商资料 |
| AI 服务 | 保存 AI 服务商配置 |
| AI 服务用途 | 记录不同服务承担的业务职责 |
| 系统配置 | 保存必要的系统运行设置 |
| 系统日志 | 记录必要的系统运行情况 |
具体表结构、字段、索引及关联关系,必须在数据库详细设计阶段确定。
不增加用户历史查询记录表,除非以后明确提出需求。
九、系统文件目录规划
目前已经建立的目录保持不变。
在此基础上,进一步明确各目录的职责。
AICommercialService/
│
├─ app/
│ ├─ controllers/
│ │ ├─ 前台请求控制
│ │ ├─ 后台管理控制
│ │ └─ API请求控制
│ │
│ ├─ services/
│ │ ├─ 需求理解服务
│ │ ├─ 服务商匹配服务
│ │ ├─ 联网搜索协调服务
│ │ └─ 推荐结果组织服务
│ │
│ ├─ adapters/
│ │ ├─ AI服务适配器
│ │ └─ 外部搜索能力适配器
│ │
│ ├─ repositories/
│ │ ├─ 服务商数据访问
│ │ ├─ AI配置数据访问
│ │ └─ 管理员数据访问
│ │
│ └─ helpers/
│ └─ 通用辅助功能
│
├─ config/
│ ├─ 系统配置
│ ├─ 数据库配置
│ └─ 安全配置
│
├─ database/
│ └─ migrations/
│ └─ 数据库初始化及变更
│
├─ public/
│ ├─ api/
│ ├─ assets/
│ │ ├─ css/
│ │ ├─ js/
│ │ └─ images/
│ └─ index.php
│
├─ admin/
│ ├─ assets/
│ └─ index.php
│
├─ templates/
│ ├─ frontend/
│ └─ admin/
│
├─ storage/
│ └─ logs/
│
└─ .htaccess
说明:这是逻辑结构规划,不是要求一次性创建所有文件。每个文件的真实名称、职责和调用关系将在对应阶段确认后再创建。
十、系统安全规划
第一版至少考虑以下安全要求:
-
后台管理员登录验证。
-
管理员密码安全存储。
-
后台页面访问权限控制。
-
API 密钥仅保存在服务器端。
-
数据库使用参数化查询。
-
防范 SQL 注入。
-
防范跨站脚本攻击。
-
后台操作进行必要的输入验证。
-
对外部 AI API 请求进行超时及异常处理。
-
对 AI API 返回内容进行结构验证。
-
对外部链接进行安全处理。
-
日志不记录完整 API 密钥。
安全措施应当随着对应功能开发逐步实施,不留到项目最后才处理。
十一、开发实施阶段规划
项目按照独立逻辑功能逐步实施,不一次性开发整套系统。
-
第一阶段:系统基础架构
-
确定 PHP 程序入口。
-
建立初始化机制。
-
建立配置加载机制。
-
建立基础请求处理机制。
-
建立统一异常处理机制。
验收:服务器能够正常加载系统基础入口。
-
-
第二阶段:数据库基础
-
建立数据库连接管理。
-
建立数据库初始化机制。
-
创建管理员数据结构。
-
创建服务商数据结构。
-
创建 AI 服务配置数据结构。
验收:服务器能够正常完成数据库连接及实际读写。
-
-
第三阶段:后台管理基础
-
管理员登录。
-
登录状态管理。
-
后台首页。
-
后台退出登录。
-
后台权限控制。
验收:管理员能够安全登录并使用后台。
-
-
第四阶段:服务商管理
-
服务商新增。
-
服务商编辑。
-
服务商删除。
-
服务商启用与停用。
-
推荐状态管理。
-
推荐优先级管理。
验收:服务商数据能够真实保存、读取和修改。
-
-
第五阶段:AI 服务配置管理
-
多 AI 服务配置。
-
API 地址和密钥配置。
-
模型配置。
-
服务用途配置。
-
默认服务选择。
-
服务启用和停用。
-
服务调用优先级。
验收:后台能够管理和切换 AI 服务配置。
-
-
第六阶段:AI 适配器
-
建立统一 AI 调用接口。
-
实现智谱适配器。
-
按确认的服务清单增加其他适配器。
-
区分语义理解、联网搜索和结果组织能力。
-
处理接口错误及返回数据。
验收:能够通过配置选择对应 AI 服务并完成实际接口调用。
-
-
第七阶段:需求语义理解
-
接收用户原始需求。
-
调用后台选择的语义理解服务。
-
动态理解需求内容。
-
输出供匹配模块使用的结构化需求信息。
验收:不同类型的自然语言需求能够被正确理解,不依赖固定行业分类。
-
-
第八阶段:后台服务商动态匹配
-
查询后台服务商资料。
-
动态理解服务商业务描述。
-
根据当前需求判断匹配程度。
-
按推荐状态和优先级筛选。
-
输出符合需求的服务商。
验收:后台存在符合条件的服务商时,优先推荐后台资料。
-
-
第九阶段:互联网信息发现
-
后台没有匹配结果时启动搜索。
-
读取管理员选择的联网搜索服务。
-
调用对应 AI 服务的联网搜索能力。
-
获取服务商信息和原始来源。
-
处理重复信息及无效结果。
验收:后台没有匹配服务商时,系统能够通过已配置的外部搜索服务发现相关信息。
-
-
第十阶段:前台需求和结果展示
-
前台需求输入页面。
-
用户需求提交。
-
请求处理状态展示。
-
AI 推荐结果展示。
-
服务商信息展示。
-
官网和来源链接展示。
验收:用户能够完成从输入需求到查看推荐结果的完整流程。
-
-
第十一阶段:整体验收
-
完整业务流程验证。
-
后台服务商推荐验证。
-
外部 AI 搜索验证。
-
AI 服务切换验证。
-
API 异常处理验证。
-
数据库读写验证。
-
安全检查。
-
修复问题并重新验证。
验收:第一版核心业务流程在服务器真实环境中通过测试。
-
十二、统一开发与验证规范
本项目严格执行《人工主导、AI辅助的软件工程开发规范 V1.0》和《软件项目开发与验证规范 V1.0》。
| 环节 | 执行要求 |
|---|---|
| 需求确认 | 先确认当前功能需求 |
| 现状检查 | 检查实际项目文件 |
| 逻辑设计 | 先确定调用关系和处理逻辑 |
| 文件设计 | 明确文件职责和代码约束 |
| 编码实施 | 按独立功能逐步开发 |
| 本地检查 | 只进行 PHP 语法检查 |
| 本地运行 | 不启动本地服务器,不做本地接口测试 |
| 服务器验证 | 上传后实际运行页面、接口和数据库 |
| 问题修复 | 修复后重新上传并验证 |
| 阶段验收 | 当前功能通过后再进入下一阶段 |
每个功能完成后,必须向用户报告:
-
实际完成了什么。
-
实际修改了哪些文件。
-
实现了什么业务逻辑。
-
本地语法检查结果。
-
服务器运行验证结果。
-
尚未解决的问题。
-
下一步准备实施的功能。
不得把语法检查通过等同于功能完成,也不得把代码编写完成等同于上线成功。
十三、目前已确认与待确认事项
为了避免规划阶段就产生未经确认的设计,下面区分现有决定与待确定内容。
已确认事项
-
项目名称及业务定位。
-
面向普通用户提供产品和服务发现推荐。
-
后台服务商优先推荐。
-
后台没有匹配结果时再进行互联网搜索。
-
支持后台配置多个 AI 服务。
-
后台能够选择不同 AI 服务承担不同用途。
-
AI 服务采用适配器方式接入。
-
服务商资料采用通用结构,不固定行业字段。
-
使用 PHP 和 MySQL。
-
本地 PHP CLI 为 7.0.10。
-
本地只进行语法检查。
-
服务器进行实际运行验证。
-
不建设会员、支付和订单系统。
-
第一版不保存用户查询历史。
需要进一步确认的事项
1. 前后台模板技术
2. AI 服务配置方式
3. 联网搜索方式
3. 联网搜索方式
4. 其他补充要求(选填)
提交确认
**规划完成后的下一步:**根据确认结果,制定第一阶段的详细技术设计,包括文件清单、每个文件的职责、类与函数设计、调用顺序和验收标准。确认之前不创建业务代码文件。