《智能 AI 商业服务系统建设项目规划 V1.0(重新编制版)》
本规划根据此前项目讨论、后台控制面板补充要求,以及最新关于模板引擎的沟通重新编制。
本版本取代此前的 V1.1 和 V1.2,作为后续项目设计与开发的规划依据。
编制原则:以用户明确提出的需求为准,不把 AI 自行提出的建议、扩展模块或技术限制当成项目需求。
一、项目建设目标
建设一套基于 PHP 和 MySQL 的智能 AI 商业服务系统。
系统面向有产品或商业服务需求的用户,用户通过自然语言描述需求,系统理解需求内容,从后台维护的服务商资料中寻找符合需求的服务商。
当现有服务商资料无法满足需求时,系统可以调用具备真实互联网搜索能力的 AI 服务,获取外部信息,并整理相关结果供用户查看。
系统由前台业务界面和后台管理界面组成。
二、系统主要功能
1. 前台用户功能
用户通过自然语言输入产品或商业服务需求。
系统主要处理过程:
-
接收用户输入的需求。
-
理解和分析用户需求。
-
根据需求匹配后台维护的服务商资料。
-
优先展示符合需求的服务商。
-
当现有服务商资料无法满足需求时,调用具备真实联网搜索能力的 AI 服务。
-
整理搜索结果并向用户展示。
-
展示推荐信息及其真实来源。
注意:
-
普通模型内部知识不能冒充实时互联网搜索结果。
-
外部搜索结果不能未经确认就自动写入正式服务商资料。
-
不建设用户历史查询记录功能。
2. 服务商管理
后台可以维护系统中的服务商资料。
现阶段明确的服务商资料字段:
| 字段 | 说明 |
|---|---|
| 服务商名称 | 服务商名称 |
| 服务商介绍 | 服务商基本介绍 |
| 业务描述 | 服务商提供的业务内容 |
| 业务关键词 | 辅助需求匹配 |
| 官网地址 | 服务商官方网站 |
| 信息来源 | 服务商资料来源 |
| 推荐状态 | 是否参与推荐 |
| 推荐优先级 | 服务商推荐顺序 |
服务商资料采用通用化设计,不针对某个行业固定字段,不建立固定行业匹配规则。
关键词用于辅助匹配,不作为唯一的匹配依据。
3. 分类目录管理
后台提供分类目录管理功能。
分类目录用于组织和管理服务商信息。
明确要求:
-
支持建立上下级分类关系。
-
支持多级嵌套。
-
不限制固定层级。
-
可以新增、编辑分类。
-
分类管理不预设固定行业分类体系。
4. AI 服务管理
后台提供 AI 服务配置功能,用于维护系统使用的 AI 服务。
明确需求:
-
支持配置多个 AI 服务。
-
可以维护服务名称、服务商、服务类型、服务地址等信息。
-
可以设置启用状态。
-
可以维护服务配置。
-
系统可以根据不同用途调用对应的 AI 服务。
5. AI 用途配置
系统涉及的 AI 使用用途包括:
-
用户需求语义理解。
-
互联网信息搜索。
-
推荐结果组织。
不同用途可以指定不同的 AI 服务;同一个 AI 服务也可以承担多个用途。
用途配置需要支持服务选择、主用服务及优先级等配置能力。具体配置字段和切换规则在对应功能设计阶段确定,不提前增加未经确认的配置项。
三、后台管理界面
后台管理系统提供统一的管理界面。
1. 后台统一布局
后台页面采用统一布局:
-
左侧导航区域。
-
顶部标题区域。
-
页面内容区域。
-
底部信息区域。
保留目前已经完成的后台 CSS 和登录页面 CSS,不因架构调整而无故修改。
2. 后台功能菜单
控制面板
– 后台首页
业务管理
-
服务商管理
-
分类目录
AI 服务管理
-
AI 服务配置
-
AI 用途配置
系统管理
-
管理员账户
-
系统配置
-
系统日志
系统管理部分属于本次整理的后台管理规划范围,具体功能和数据结构应在相应模块设计时确认,不提前扩展。
四、AI 服务调用设计
系统业务功能不直接绑定某一家 AI 服务商。
AI 服务调用应根据配置的用途选择对应服务。
基本关系:
用户需求
│
▼
需求语义理解
│
▼
服务商资料匹配
│
├── 找到符合需求的服务商
│ │
│ ▼
│ 推荐结果
│
└── 现有资料无法满足需求
│
▼
互联网信息搜索
│
▼
搜索结果整理
│
▼
推荐结果
AI 服务具体接入方式、服务适配和调用规则,在 AI 服务接入阶段进行详细设计。
五、技术环境与开发约束
| 项目 | 当前确定内容 |
|---|---|
| 后端语言 | PHP |
| PHP 版本 | PHP 7.0.10 |
| 数据库 | MySQL |
| 模板技术 | 允许使用 Smarty 或其他模板引擎 |
| 当前模板引擎 | Smarty 3.1.48 |
| 项目开发环境 | Wamp |
| 项目部署方式 | 本地文件同步至服务器 |
模板引擎不作原生 PHP 模板的强制限制。现有 Smarty 代码和模板应结合项目实际情况继续使用,不要求为了更换模板方式而进行无必要的迁移。
现有 vendor 目录保留。
六、项目开发实施顺序
开发必须按照阶段推进,每个阶段完成设计、实施、验证和验收后,再进入下一阶段。
| 阶段 | 开发内容 |
|---|---|
| 第一阶段 | 项目基础架构建设 |
| 第二阶段 | 数据库基础建设 |
| 第三阶段 | 后台管理基础功能 |
| 第四阶段 | 服务商管理 |
| 第五阶段 | 分类目录管理 |
| 第六阶段 | AI 服务配置 |
| 第七阶段 | AI 用途配置 |
| 第八阶段 | AI 服务调用及适配 |
| 第九阶段 | 用户需求语义理解 |
| 第十阶段 | 服务商需求匹配 |
| 第十一阶段 | 互联网信息搜索 |
| 第十二阶段 | 推荐结果整理与前台展示 |
| 第十三阶段 | 系统整体验证 |
以上为开发阶段划分,不代表每个阶段都已经完成详细设计。具体实施内容必须在进入相应阶段时确认。
七、第一阶段:项目基础架构建设
第一阶段先完成系统基础架构,不提前开发具体业务功能。
主要工作:
-
创建项目架构目录。
-
检查和整理现有项目文件。
-
确定系统入口文件职责。
-
建立统一初始化机制。
-
确定配置文件加载方式。
-
规范请求处理和路由分发。
-
明确日志和异常处理机制。
-
整理现有 Smarty 模板引擎的使用方式。
-
明确前台与后台的基础运行关系。
第一阶段不提前实现服务商匹配、AI 搜索、需求理解等业务逻辑。
八、软件工程开发与验证规范
所有阶段按照人工主导、AI 辅助的软件工程开发方式实施。
1. 开发步骤
-
确认当前阶段需求。
-
检查实际项目目录和文件。
-
分析当前代码及依赖关系。
-
设计功能逻辑。
-
明确文件职责和代码约束。
-
确定目录、文件、类和函数设计。
-
按独立逻辑功能逐步编写代码。
-
完成代码注释和影响文件说明。
-
进行本地 PHP 语法检查。
-
同步至服务器。
-
进行服务器实际运行验证。
-
根据验证结果修复问题。
-
完成阶段验收。
2. 开发约束
-
不一次性编写整套软件。
-
不跳过需求确认和架构设计。
-
不根据猜测修改实际项目文件。
-
不擅自增加未经确认的功能。
-
不随意改变已经确认的项目架构。
-
不无故修改已经完成的 CSS。
-
不以 PHP 语法检查通过代替业务运行验证。
-
不把未实际执行的操作描述为已经完成。
3. 验证要求
本地环境只进行 PHP 语法检查,不启动本地服务器,不进行本地接口、API 或数据库运行测试。
服务器环境进行实际运行验证,包括页面访问、请求处理、数据库读写及对应业务功能验证。具体验证范围以当前开发阶段为准。
九、项目现有文件处理原则
目前项目已经存在部分后台页面、控制器、日志类、数据库辅助类和 Smarty 模板。
处理原则:
-
先检查实际文件,再确定修改方式。
-
已有且符合规划的代码优先保留。
-
已完成的后台 CSS 和登录 CSS 保留。
-
Smarty 及其现有模板暂时保留。
-
不因目录调整随意删除现有文件。
-
不擅自清理
vendor。 -
发现现有代码与新规划不一致时,先分析并说明,再确定修改方式。
十、项目规划执行原则
本规划是项目后续开发的依据。
后续所有开发工作遵循以下原则:
-
需求决定功能:不由 AI 自行扩大项目范围。
-
规划决定顺序:不跳过已经确定的开发阶段。
-
实际文件决定修改:不凭空假设项目现状。
-
逻辑边界决定开发单元:每次完成一个明确的功能单元。
-
验证结果决定是否验收:没有实际验证,不宣称功能完成。
-
用户决定项目方向:技术建议必须与用户确认的规划区分开来。
版本说明
| 项目 | 内容 |
|---|---|
| 规划名称 | 智能 AI 商业服务系统建设项目规划 |
| 版本 | V1.0(重新编制版) |
| 规划状态 | 待用户审核确认 |
| 旧版本 | V1.1、V1.2 废弃 |
| 执行原则 | 用户确认后作为正式开发依据 |
本次特别说明: 我没有把昨天 V1.2 中的原生 PHP 模板限制继续保留,也没有把未经确认的扩展内容直接当成项目需求。当前版本中,后台控制面板和系统管理菜单按此前明确沟通纳入;具体实现细节仍须逐阶段设计确认。
请重点审核这份新规划的业务功能范围、后台菜单和开发阶段顺序。确认后再将它作为正式项目规划执行。