SemanticLibrary 动态语义字典项目完整实现规划
项目名称:SemanticLibrary 独立动态语义字典系统
项目目录:D:\wamp\www\SemanticLibrary
技术环境:PHP 7.0、PHP OOP、Smarty、MySQL、JavaScript,部署于虚拟主机。
本规划以已经确认的项目目标和你提供的现有代码为基础。目标是完成一套能够实际运行、连接数据库、按需求动态构建语义定义的独立系统,而不是只完成页面或静态演示。
一、完整功能流程
1. 用户输入原始需求
接收、校验、保存、建立需求记录
2. 需求语义单位切分
切分、展示、编辑、添加、删除、人工确认
3. 外部搜索与资料获取
动态生成查询词、搜索、获取资料、提取文本、记录来源
4. 动态语义结构构建
依据需求和外部资料,动态建立元素、属性、属性值
5. 语义定义与人工核验
展示候选定义、来源和冲突,人工编辑确认当前语境定义
6. 动态语义字典保存与查询
保存已确认定义、来源、核验状态和版本,提供查询接口
上述流程不预设行业字段,也不把外部资料中出现的内容直接认定为事实。语义结构由当前需求和材料动态形成,最终定义由人工核验确认。
二、功能实现步骤
以下是完整实施顺序。每一步都要完成相应逻辑文件、页面连接、数据库操作和功能验证,再进入下一步。
第 1 步:项目盘点与数据库核对
目的:掌握已有实现,避免重复开发和破坏现有逻辑。
-
核对整个项目目录和入口文件。
-
核对现有控制器、服务层、仓储层、业务处理器及 Smarty 模板。
-
核对数据库连接配置、数据表、字段、主外键及索引。
-
对照功能规划标记已实现、未实现、未接通和运行异常的部分。
-
明确现有文件的职责和依赖关系。
完成标准: 有一份依据实际代码和数据库形成的项目清单,明确后续要修改的文件,不凭猜测新增模块。
第 2 步:完成业务页面
以现有 templates/index.tpl 为基础,完成完整的业务操作界面。
-
原始需求输入与提交结果提示。
-
历史需求列表及当前需求详情。
-
语义单位编辑、添加、删除及确认。
-
外部搜索结果、资源摘要、来源链接和获取状态。
-
动态语义结构展示。
-
语义定义编辑、来源核对、冲突展示和人工确认。
-
已确认语义定义的查询和管理。
-
适配桌面和移动端的页面布局。
页面操作必须对应真实的后端逻辑。没有实现的功能不显示虚假的成功结果或伪造数据。
完成标准: 页面上的每项操作都有明确的后端处理入口、数据来源和结果反馈。
第 3 步:连接数据库并核实数据模型
-
验证 PHP 运行环境与 MySQL 连接。
-
检查需求、语义单位、外部资源和语义定义的现有表结构。
-
核实数据关联关系和数据读写权限。
-
补齐业务实际需要且现有结构无法支持的字段或约束。
-
验证插入、读取、修改、删除和事务处理。
完成标准: 页面能够读写真实数据库,需求与其语义单位、资源及语义定义的关联准确。
第 4 步:实现原始需求处理逻辑
基于现有的 QuestionInput、QuestionProcessor 和 QuestionService。
-
接收和校验用户原始需求。
-
保存原始文本,保留需求记录。
-
建立后续处理所需的需求编号和处理状态。
-
将需求提交与后续业务处理衔接起来。
完成标准: 原始需求能够稳定保存,后续处理可以根据需求编号继续执行,不丢失原始文本。
第 5 步:实现语义单位切分与确认逻辑
-
对原始需求进行语义单位切分。
-
展示切分结果,支持用户编辑、添加和删除。
-
用户确认后保存确认状态。
-
保存语义单位与原始需求的关联。
-
确认后的语义单位按照既定规则保护,避免被普通编辑操作意外更改。
完成标准: 从需求提交到语义单位人工确认的完整流程可以实际运行。
注意:当前 QuestionService 已有部分人工维护接口,但 QuestionProcessor 不负责自动切分。自动切分的具体规则应依据项目既定语义逻辑实现,不直接把人工录入当成自动切分完成。
第 6 步:实现外部搜索与资料获取
-
根据需求及已确认的语义单位动态生成搜索查询词。
-
调用可用的公共搜索接口或其他明确配置的外部搜索来源。
-
获取搜索结果中的标题、链接、摘要和来源信息。
-
根据搜索结果获取选定网页内容。
-
将 HTML 转为可处理的文本。
-
保存实际获取的资源、来源及其关联关系。
-
记录获取状态,处理无结果、请求失败和无效链接。
完成标准: 提交需求后,系统能够执行实际外部搜索,展示真实搜索结果,并将资源及来源保存到数据库。
公共搜索服务的选择和访问凭据需要依据实际部署环境确定;不假定服务器已经配置某个搜索 API。
第 7 步:实现外部资料文本处理
-
提取网页正文及有效文本。
-
进行标点、词语、字符等内容提取。
-
完全相同的句子去重,并记录出现次数。
-
保存句子对应的来源,支持来源查看和排序。
-
支持手工录入和上传材料。
-
支持按既定功能获取 URL 内容。
-
清理来源材料时保留已经确认的语义定义。
完成标准: 获取的外部资料能够转换为可检索、可追溯的文本材料,重复句子不会被错误地当作不同内容。
第 8 步:实现动态语义结构构建
这是动态语义字典的核心业务逻辑。
-
综合当前需求、语义单位和外部资料。
-
从实际材料中识别与需求相关的概念及其描述。
-
根据材料动态建立语义元素、属性和属性值。
-
不预先限定行业、字段、属性名称或属性值。
-
保留各项内容对应的来源和关联信息。
-
对来源不一致或描述冲突的内容保留候选,不擅自判定最终结果。
完成标准: 系统能够依据不同需求及材料形成不同的语义结构,而不是套用固定行业字段或硬编码字段映射。
第 9 步:实现语义定义、人工核验和版本管理
-
展示语义元素、属性及属性值。
-
展示候选语义定义及其外部来源。
-
支持人工编辑、补充、删除候选和确认定义。
-
保存核验状态及相关来源。
-
记录定义变化和版本信息。
-
将人工确认的当前语境定义与未确认候选明确区分。
完成标准: 未确认内容不会自动成为最终定义;人工确认的定义能够独立保存、查询和追溯。
第 10 步:实现查询与 API
-
创建和管理 API 密钥。
-
按 API 密钥验证请求。
-
提供已确认语义定义的查询接口。
-
支持句子列表、关键词查询和导出。
-
返回必要的定义内容、来源和核验状态。
-
处理无效密钥、无结果和请求异常。
完成标准: 外部调用方能够使用独立 API 查询字典中的实际数据,而不是只通过网页查看。
第 11 步:完整联调与部署验证
-
验证需求提交与保存。
-
验证语义单位自动切分、人工编辑和确认。
-
验证外部搜索、网页获取和来源保存。
-
验证动态结构构建、语义定义确认和版本记录。
-
验证 API 查询、关键词检索及导出。
-
检查 PHP 错误日志、数据库错误和页面异常。
-
在实际虚拟主机环境验证完整流程。
完成标准: 从用户输入需求开始,到动态语义字典生成、人工确认、数据库保存和 API 查询,整条流程能够实际运行。
三、逻辑文件的实现原则
每个功能按照现有项目的 PHP OOP 架构实现,职责分离:
| 文件层级 | 负责内容 |
|---|---|
| Smarty 页面 | 展示数据、接收用户操作 |
| Controller | 接收页面请求、调用服务、返回结果 |
| Service | 组织业务流程和数据处理 |
| Processor / Engine | 执行对应的需求、语义或文本处理逻辑 |
| Repository | 负责数据库读写 |
| Config | 管理数据库、Smarty 及外部服务配置 |
这些是职责划分原则,不代表现在就要创建同名的新文件。优先复用已有文件,只有确认现有结构确实无法承载功能时才增加文件。
实现过程中不采用大模型 API、embedding、向量搜索、神经网络或预设行业字段替代既定语义逻辑。
四、项目完成的最终判定
最终验收清单
0/10 项已标记
此清单用于规划验收;勾选仅代表你手动标记,不代表系统已自动测试。
实施顺序已经明确:先盘点项目,再完成页面,再核实并连接数据库,随后逐个实现业务逻辑文件,最后完整联调。 不跳步骤,不凭空重建项目,也不把局部完成误判为整个项目完成。