第一步:确定后台功能结构
现有首页、语义字典、结构元素、外部资源四个页面及其路由已经通过验证。本阶段在现有基础上继续设计,不推翻已完成的内容。
一、后台功能划分
| 功能模块 | 主要职责 | 核心操作 |
|---|---|---|
| 系统首页 | 展示系统入口及管理概况 | 进入各功能模块 |
| 语义字典 | 管理最终构建的语义结构 | 查看、创建、编辑、删除、导出 |
| 结构元素 | 管理用户创建的元素与对象 | 创建、编辑、删除、批量删除 |
| 字段管理 | 管理元素或对象所属的字段 | 创建、编辑、删除、批量删除 |
| 属性管理 | 管理动态形成的元素与对象属性 | 添加、编辑、删除、批量删除 |
| 关系管理 | 管理实际形成的语义关联 | 查看、建立、编辑、删除关系 |
| 外部资源 | 管理原始问题及语义单元对应的搜索结果 | 查看资源、原始链接及关联 |
| 语义单元 | 管理原始问题拆分后的语义单元 | 查看、编辑、添加、删除、确认 |
| 来源追溯 | 查看语义内容对应的外部资源 | 查看关联资源及来源信息 |
| 数据导出 | 导出实际构建完成的语义字典 | 导出结构及关联数据 |
| API Key 管理 | 管理其他应用访问语义字典的凭证 | 生成、查看状态、禁用、更换 |
| API 输出 | 向其他独立系统提供语义字典数据 | 验证凭证、输出结构化数据 |
**注意:**上述功能划分是后台管理结构,不代表现在就要创建这些模块的代码文件。文件和数据库设计必须在操作逻辑确定后再进行。
第二步:确定核心业务操作顺序
系统按照已经确认的业务逻辑运行。
1. 原始问题处理
用户输入原始问题
↓
根据原始问题搜索外部资源
↓
保存搜索结果与原始链接
↓
拆分原始问题中的语义单元
↓
后台展示语义单元
↓
用户编辑、添加、删除并确认
2. 语义单元确认后的处理
用户确认语义单元
↓
根据语义单元再次搜索外部资源
↓
保存搜索结果、原始链接及关联关系
↓
获取用户创建的元素、对象和字段
↓
根据字段语义定义匹配外部资源内容
↓
形成字段语义内容及来源关联
↓
构建动态语义结构
↓
后台查看、编辑、管理和导出
这里有两项必须保持不变:
- 原始问题搜索与语义单元搜索是两个不同的处理阶段。
- 字段语义定义就是字段值,不再将两者拆分为两个独立的数据类别。
搜索结果也不能直接被当作已确认的事实。无法匹配的字段保留未定义状态,不凭空补充内容。
第三步:确定语义字典后台页面的操作逻辑
现有 templates/pages/semantic-dictionary.tpl 已经能够正常显示。后续需要在确定页面操作逻辑后,再决定如何扩展。
建议将该页面作为语义结构的统一查看与管理入口,而不是把所有业务逻辑都写进这个模板。
页面应当能够查看:
- 已构建的元素与对象。
- 元素与对象所属的字段。
- 字段当前的语义定义。
- 动态形成的属性及其语义内容。
- 元素、对象、字段及语义单元之间的实际关系。
- 语义内容对应的外部资源与原始链接。
管理操作必须作用于真实保存的数据,不能仅仅修改页面上的显示内容。
同时,元素、对象、字段、属性和关系应当保持动态性,不预设统一的固定字段集合、属性集合或关系类型。
第四步:接下来怎样开发
为了避免再次出现页面结构、文件职责与业务逻辑混乱的问题,后续按照以下顺序推进:
| 阶段 | 工作内容 | 完成标准 |
|---|---|---|
| 1 | 确定后台页面及操作逻辑 | 每项操作的输入、处理和结果明确 |
| 2 | 确定数据库实体及关联关系 | 数据能够表达规划中的动态结构 |
| 3 | 确定各文件职责与调用关系 | 不重复实现、不混淆职责 |
| 4 | 逐个开发文件 | 每次只处理一个文件 |
| 5 | 逐项验证实际功能 | 确认真实数据操作与页面结果一致 |
| 6 | 开发外部资源搜索与语义匹配 | 严格遵循已确认的两阶段搜索流程 |
| 7 | 开发导出与 API 输出 | 保留结构、来源及关联关系 |
当前下一项具体工作
先完成后台操作逻辑设计,再进入数据库设计。
下一步应当从现有的「结构元素」页面开始,明确元素、对象、字段三者的管理边界及相互关联,然后再处理属性、关系、外部资源和语义单元。
这一步暂不修改任何现有代码,也不创建新文件。等操作逻辑明确后,再确定需要修改的第一个文件。
一、结构元素模块的职责
结构元素模块负责管理用户创建的两类结构主体:
- 元素:用户根据实际需求创建的结构元素。
- 对象:用户根据实际需求创建的结构对象。
元素与对象均由用户动态创建、编辑和删除,不预设固定类型,也不限制只能属于某个行业或应用场景。
模块还需要支持为元素或对象创建字段,并管理字段与所属元素或对象之间的关联。
需要明确:元素、对象、字段是不同层次的结构内容,不能把字段语义定义另外设计成与字段并列的独立类别。
二、元素管理逻辑
1. 创建元素
后台提供创建元素的操作。
基本处理过程:
用户发起创建元素操作
↓
填写元素信息
↓
系统接收并处理用户提交的数据
↓
保存元素
↓
返回处理结果
↓
后台展示已保存的元素
元素的具体信息字段,应在后续数据结构设计阶段根据实际需求确定,不提前假设固定的元素属性集合。
2. 编辑元素
用户选择已有元素
↓
读取该元素的实际保存数据
↓
用户修改信息
↓
提交修改
↓
更新对应元素
↓
重新展示更新后的数据
编辑操作必须针对被选中的实际元素,不能因为名称相同就擅自修改其他元素。
3. 删除元素
用户选择元素
↓
发起删除操作
↓
检查删除操作涉及的关联数据
↓
按照确定的关联处理规则执行删除
↓
返回结果并更新页面
元素可能关联字段、属性、关系和外部资源。具体删除时如何处理这些关联,必须在数据库关联设计阶段明确,不能直接假设级联删除,也不能不考虑关联数据就删除。
4. 批量删除元素
支持用户选择多个元素后执行批量删除。
批量操作应当明确实际处理对象、执行结果和失败情况,并遵循单个元素删除时确定的关联处理规则。
三、对象管理逻辑
对象管理同样支持:
- 创建对象。
- 编辑对象。
- 删除对象。
- 批量删除对象。
- 查看对象的实际保存信息。
- 查看对象关联的字段、属性、关系和资源。
对象管理与元素管理采用一致的基本操作原则,但这不意味着两者的业务含义必须相同,也不意味着必须把它们强行合并成同一种数据。
是否共用底层管理机制,留到数据库和代码职责设计阶段确定。
四、字段管理逻辑
字段用于表达所属元素或对象所需要的语义内容。
1. 创建字段
用户选择一个元素或对象
↓
发起创建字段操作
↓
填写字段名称及语义定义
↓
系统处理提交的数据
↓
保存字段及其所属关系
↓
展示字段及当前语义定义
字段的名称和语义定义由实际需求决定,不预先限定字段集合。
例如,用户可以根据具体需求为不同的元素或对象创建不同字段。这只是对动态字段机制的说明,不代表系统应当预设任何示例字段。
2. 编辑字段
字段编辑必须能够处理:
- 字段名称的修改。
- 字段语义定义的修改。
- 字段所属元素或对象的关联调整——具体是否允许调整,以及调整时如何处理原有关联,需要在详细设计中确定。
字段语义定义就是字段值。修改语义定义,实际修改的是该字段所保存的语义内容。
3. 删除与批量删除字段
用户可以删除单个字段,也可以批量删除多个字段。
执行前需要明确字段与其他结构数据之间的关联处理规则,避免删除字段后留下无法解释的语义内容或关联记录。
4. 外部资源匹配
字段创建后,可以参与后续外部资源匹配。
读取用户创建的字段
↓
获取字段语义定义
↓
获取相关外部资源内容
↓
依据字段语义定义进行匹配
↓
形成匹配结果
↓
保存语义内容及其来源关联
如果无法匹配,字段保留未定义状态,不凭空生成内容。
字段管理模块负责管理字段及其语义定义;外部资源搜索和匹配则属于相应的业务处理逻辑,不应全部写入页面模板。
五、结构元素页面需要展示什么
现有 templates/pages/structure-elements.tpl 已经上传并验证正常。后续扩展时,页面至少需要承载以下管理操作。
| 页面区域 | 操作内容 |
|---|---|
| 元素列表 | 查看、选择、创建、编辑、删除 |
| 对象列表 | 查看、选择、创建、编辑、删除 |
| 字段列表 | 查看所属元素或对象的字段 |
| 字段操作 | 创建、编辑、删除、批量删除 |
| 语义定义 | 查看和编辑字段当前的语义内容 |
| 批量操作 | 对选中的元素、对象或字段执行相应操作 |
| 关联查看 | 查看实际存在的结构关联 |
以上是功能需求,不是要求把所有内容挤在同一张表中。具体页面布局应根据现有模板和实际交互需求确定。
六、当前阶段的设计结论
结构元素模块的逻辑边界如下:
- 元素与对象由用户动态创建和管理。
- 字段归属于元素或对象,不预设统一字段集合。
- 字段语义定义就是字段值,统一管理。
- 元素、对象、字段的增删改操作必须作用于实际保存的数据。
- 删除操作必须考虑真实存在的关联。
- 外部资源搜索与匹配不混入页面展示代码。
- 属性和动态关系将在后续阶段分别设计,不在本阶段提前限定。
- 现有代码暂不修改。
下一步:确定数据之间的关联规则
在编写任何数据库代码之前,还需要明确以下问题:
- 一个字段是否只能归属于一个元素或对象?
- 一个元素或对象是否可以同时关联多个字段?
- 元素与对象之间是否允许建立多对多关系?
- 字段删除后,其语义定义、匹配结果及来源关联如何处理?
- 元素或对象删除后,已有的关系及资源关联如何处理?
这些问题直接影响数据库结构、删除逻辑和后续 API 输出,不能由代码实现阶段自行猜测。
下一步应先完成这组关联规则的设计,再根据确定的规则设计数据库结构。