根据最新确认,正式更新项目技术路线和开发规划。此次更新将原生 PHP 模板、多 AI 服务协同配置、AI 联网搜索优先策略纳入正式架构。
项目名称:智能 AI 商业服务系统建设项目
项目提出方:陕西渭南临渭多模态智能技术研发工作室
一、正式确认的技术决策
以下内容作为后续开发的约束,不再作为待讨论选项。
|
项目 |
正式确定方案 |
|---|---|
|
后端开发语言 |
PHP |
|
本地 PHP CLI |
PHP 7.0.10 |
|
数据库 |
MySQL |
|
前台模板 |
原生 PHP 模板 |
|
后台模板 |
原生 PHP 模板 |
|
AI 服务架构 |
多 AI 服务同时配置 |
|
AI 服务用途 |
按用途分别指定服务 |
|
主用服务 |
后台可配置和切换 |
|
联网搜索 |
优先使用具备联网搜索能力的 AI 服务 |
|
本地验证 |
仅 PHP 语法检查 |
|
运行验证 |
上传服务器后实际验证 |
不引入 Smarty,不增加额外模板引擎依赖。
二、项目业务定位
建设一个面向普通用户的智能产品与商业服务发现系统。
用户通过自然语言提出产品或服务需求,系统理解需求,优先从后台服务商数据库寻找匹配对象。
如果后台没有符合要求的服务商,则调用管理员配置的 AI 联网搜索服务,发现互联网中的相关服务商,整理信息后返回用户。
核心业务链:
用户提出产品或服务需求
AI 理解用户需求
查询后台服务商资料
动态匹配服务商
判断是否有符合条件的服务商
优先推荐后台服务商
调用 AI 联网搜索
生成推荐回复,展示服务商信息及来源
三、系统总体架构
系统划分为六个主要部分。
|
系统模块 |
主要职责 |
|---|---|
|
前台展示系统 |
用户需求输入、结果展示 |
|
后台管理系统 |
管理员登录、服务商管理、AI 配置 |
|
需求理解系统 |
理解用户自然语言需求 |
|
服务商匹配系统 |
动态理解和匹配后台服务商 |
|
AI 服务调度系统 |
根据后台配置选择 AI 服务 |
|
推荐结果系统 |
整理服务商资料、搜索结果和来源 |
各模块保持职责独立,避免将 AI 服务商接口、服务商匹配和前台展示逻辑写在同一文件中。
四、多 AI 服务管理架构
多 AI 服务配置与用途分配模式。
4.1 AI 服务配置
后台可以同时保存多个 AI 服务配置。
例如:
|
AI 服务 |
配置用途示例 |
|---|---|
|
智谱 AI |
需求理解、结果组织 |
|
DeepSeek |
需求理解、结果组织 |
|
通义千问 |
需求理解、结果组织 |
|
Kimi |
联网搜索、结果组织 |
|
其他 AI |
根据实际接口能力配置 |
以上为候选服务示例,具体模型、接口及联网能力必须根据实际开放的 API 文档确认。
4.2 AI 服务用途分配
后台支持分别设置:
-
需求语义理解服务。
-
互联网信息搜索服务。
-
推荐结果组织服务。
不同用途可以使用不同 AI 服务,也允许同一个 AI 服务承担多个用途。
例如:
需求理解:
智谱 AI
互联网搜索:
Kimi 联网搜索服务
推荐结果组织:
智谱 AI
这只是配置示例,不是固定调用方案。
4.3 AI 服务管理功能
后台需要具备:
-
AI 服务新增、编辑、删除。
-
API 地址配置。
-
API 密钥配置。
-
模型名称配置。
-
服务用途配置。
-
启用和停用。
-
默认服务选择。
-
主用服务切换。
-
服务优先级管理。
-
接口调用状态查看。
-
错误日志查看。
4.4 AI 服务调度原则
核心业务不直接调用具体 AI 服务商。
由统一调度模块读取后台配置,再调用对应适配器。
业务模块
↓
AI 服务调度模块
↓
读取后台用途配置
↓
选择当前主用服务
↓
调用对应 AI 适配器
↓
接收统一格式结果新增 AI 服务时,只需要增加对应适配器及其配置,不应修改核心业务流程。
4.5 联网搜索策略
正式确定:
优先使用具备实际联网搜索能力的 AI 服务。
搜索服务必须能够提供真实网页或信息来源,不能只依靠模型内部知识生成服务商名单。
如果当前配置的服务不具备联网能力,不得将普通模型回答冒充互联网实时搜索结果。
后续可将独立搜索引擎 API 作为扩展能力,但第一版不将其设为默认搜索路线。
五、服务商管理与动态匹配
5.1 服务商数据结构
后台服务商采用通用资料结构:
|
字段类别 |
说明 |
|---|---|
|
服务商名称 |
名称 |
|
服务商介绍 |
基本介绍 |
|
业务描述 |
产品或服务内容 |
|
业务关键词 |
辅助识别 |
|
官网地址 |
官方网站 |
|
信息来源 |
资料来源 |
|
推荐状态 |
是否参与推荐 |
|
推荐优先级 |
推荐排序 |
|
时间信息 |
创建和更新时间 |
这些是通用管理信息,不代表预设行业字段。
5.2 动态匹配原则
系统不建立固定行业分类,也不为特定产品或行业编写专用匹配逻辑。
匹配过程:
-
理解用户当前需求。
-
读取后台服务商资料。
-
动态理解服务商的业务描述。
-
判断业务内容与用户需求是否相关。
-
结合推荐状态及优先级筛选。
-
返回符合条件的服务商。
关键词只能作为辅助信息,不能单独决定匹配结果。
5.3 外部搜索资料处理
外部搜索发现的服务商与后台管理员维护的服务商分开处理。
未经管理员确认的外部搜索结果,不自动成为后台正式服务商资料。
六、推荐结果展示
前台结果应当包含:
-
服务商名称。
-
产品或服务介绍。
-
与用户需求相关的推荐说明。
-
官网链接。
-
原始信息来源链接。
必须区分后台已维护资料与互联网搜索发现资料。
不虚构服务商、官网和来源;搜索内容没有经过核实的,明确说明其待核实状态。
七、原生 PHP 模板架构
本项目正式采用原生 PHP 模板。
页面展示与业务处理分开:
templates/
frontend/
前台页面模板
admin/
后台页面模板
控制器负责处理请求和组织业务调用,模板负责展示数据。
不在模板文件中直接编写数据库操作、AI API 请求或复杂业务匹配逻辑。
八、项目目录及文件职责
目前已经创建的目录保持不变:
AICommercialService/
│
├─ app/
│ ├─ controllers/
│ ├─ services/
│ ├─ adapters/
│ ├─ repositories/
│ └─ helpers/
│
├─ config/
│
├─ database/
│ └─ migrations/
│
├─ public/
│ ├─ api/
│ ├─ assets/
│ │ ├─ css/
│ │ ├─ js/
│ │ └─ images/
│ └─ index.php
│
├─ admin/
│ ├─ assets/
│ └─ index.php
│
├─ templates/
│ ├─ frontend/
│ └─ admin/
│
├─ storage/
│ └─ logs/
│
└─ .htaccess各目录职责:
|
目录 |
职责 |
|---|---|
|
controllers |
前后台请求控制 |
|
services |
核心业务逻辑 |
|
adapters |
AI 服务及外部接口适配 |
|
repositories |
数据库访问 |
|
helpers |
通用辅助功能 |
|
config |
系统配置 |
|
database |
数据库初始化及迁移 |
|
public |
前台公开入口 |
|
admin |
后台管理入口 |
|
templates |
原生 PHP 页面模板 |
|
storage/logs |
系统日志 |
文件名、类名、函数名和具体调用关系将在详细设计时确定,不提前创建未经确认的文件。
九、数据库规划
第一版使用 MySQL,初步建立以下数据实体:
|
数据实体 |
主要内容 |
|---|---|
|
管理员 |
登录账户及密码信息 |
|
服务商 |
通用服务商资料 |
|
AI 服务 |
多个 AI 服务商配置 |
|
AI 用途配置 |
各业务用途对应的 AI 服务 |
|
系统配置 |
必要的系统设置 |
|
系统日志 |
必要的运行记录 |
不增加用户历史查询记录功能。
数据库字段、关联关系、索引和初始化脚本,须在数据库详细设计阶段确定。
十、第一版开发实施顺序
|
阶段 |
开发内容 |
阶段验收目标 |
|---|---|---|
|
1 |
系统基础架构 |
基础入口、初始化、配置加载 |
|
2 |
数据库基础 |
数据库连接及基础数据结构 |
|
3 |
后台管理基础 |
管理员登录和权限控制 |
|
4 |
服务商管理 |
服务商资料增删改查 |
|
5 |
AI 服务管理 |
多 AI 配置和用途分配 |
|
6 |
AI 适配器 |
统一调用和多服务切换 |
|
7 |
需求理解 |
自然语言动态语义理解 |
|
8 |
服务商匹配 |
动态匹配后台服务商 |
|
9 |
AI 联网搜索 |
调用具备联网能力的 AI 服务 |
|
10 |
推荐结果及前台 |
完成需求到推荐的完整流程 |
|
11 |
整体验证 |
服务器实际运行和业务验收 |
每个阶段必须独立设计、实施、验证和验收,不跳过中间步骤。
十一、开发验证标准
继续严格执行统一软件开发规范:
-
需求确认。
-
检查实际项目文件。
-
完成功能逻辑设计。
-
确定文件职责及代码约束。
-
逐个功能实施。
-
本地 PHP 语法检查。
-
上传服务器。
-
服务器真实运行验证。
-
发现问题后修复、重新上传和验证。
-
阶段验收通过后进入下一阶段。
本地不启动服务器、不进行接口测试、不进行数据库运行测试。
本地语法检查使用:
D:\wamp\bin\php\php7.0.10\php.exe -l 文件路径服务器验证包括页面运行、API 请求、数据库读写、AI 服务调用及完整业务流程。
十二、当前项目状态
项目准备情况
基础目录创建
本地 PHP 版本确认
项目根目录检查
业务定位与技术路线
完整开发规划
当前开发阶段
目前尚未创建任何项目业务代码文件。
十三、下一步:第一阶段详细设计
正式规划 V1.1 确认后,下一步只进行第一阶段设计,不直接编写整套系统。
第一阶段需要确定:
-
系统入口文件及访问路径。
-
系统初始化顺序。
-
配置加载机制。
-
数据库配置如何被读取(本阶段只设计,不提前连接)。
-
请求处理机制。
-
统一异常处理机制。
-
各文件的具体职责。
-
类、函数及相互调用关系。
-
PHP 7.0.10 兼容约束。
-
第一阶段的服务器验收标准。
规划版本 V1.1 作为当前项目正式开发依据。 后续若有需求调整,先更新规划,再实施相应功能。