WSaiOS-ICAI-Learning-System 核心规划原则记录
一、核心原则
系统必须严格按照既定规划实现,不以已经跑偏的旧代码逻辑作为设计依据。现有代码仅用于了解项目现状,不能反过来限制正确的架构设计。
二、固定字段与语义匹配
- 用户定义的结构确定固定字段。
- 语义库保存字段对应的语义匹配值、识别规则及相关关系。
- 每个字段只接收符合其对应匹配规则的值,不得混入其他字段。
- 外部资料中出现多个符合条件的值时,必须分别识别和提取,不得遗漏或合并。
三、独立字段值与产品记录关联
每个字段值必须独立保存,同时保留所属产品记录的关联关系。
例如,外部资料包含:
- 品牌:飞利浦
- 价格:12
- 认证:CC
- 厂家:飞利浦公司
以及:
- 品牌:欧乐
- 价格:15
- 认证:dd
- 厂家:欧乐公司
系统必须形成两组独立的产品记录:
产品记录 A
| 字段 | 字段值 |
|---|---|
| 品牌 | 飞利浦 |
| 价格 | 12 |
| 认证 | CC |
| 厂家 | 飞利浦公司 |
产品记录 B
| 字段 | 字段值 |
|---|---|
| 品牌 | 欧乐 |
| 价格 | 15 |
| 认证 | dd |
| 厂家 | 欧乐公司 |
不得将两组记录的品牌、价格、认证和厂家分别汇总,导致产品之间的对应关系丢失。
四、外部资料学习
- 根据学习需求及用户定义的结构开展学习。
- 利用语义库中各字段对应的匹配值和识别规则处理外部资料。
- 提取资料中实际出现的符合条件的值。
- 独立保存每个字段值,并保留所属产品记录及原始资料来源。
- 不得随意改写、截断或丢弃原始值。
- 不得通过新增固定字段、行业特判或临时关键词规则弥补架构问题。
五、结构化知识与持续学习
- 持久化保存语义库、结构化知识、产品记录关联及来源关系。
- 支持将语义库和结构化知识共同导出为 ZIP 知识包。
- 导出不得清空后台已有知识或删除原始资料。
- 导入时恢复知识内容及其关联关系。
- 导入后允许获取新资料并继续学习。
- 增量学习应保留旧知识,区分新增、重复和冲突记录。
- 支持将更新后的知识再次导出。
六、开发约束
- 规划决定实现,旧代码接受审查。
- 不围绕已经跑偏的逻辑继续打补丁。
- 修改前核实实际的数据模型、调用链和持久化结构。
- 不擅自新增固定字段、固定行业规则或其他未经确认的逻辑。
- 每项实现都必须符合上述原则,并通过实际数据验证。
本记录作为后续架构审查、代码重构及功能验收的依据。
这条也应当纳入核心规划原则:资料中即使只有一个品牌,也必须能够依据产品型号识别并分组,再分别匹配各自对应的字段值。
例如,外部资料只有一个品牌“飞利浦”,但包含多个型号:
| 产品分组依据 | 品牌 | 价格 | 认证 | 厂家 |
|---|---|---|---|---|
| 型号 A1 | 飞利浦 | 12 | CC | 飞利浦公司 |
| 型号 A2 | 飞利浦 | 15 | DD | 飞利浦公司 |
| 型号 A3 | 飞利浦 | 18 | CE | 飞利浦公司 |
系统不能因为三个型号属于同一个品牌,就把它们合并为一条产品记录,也不能将不同型号的价格、认证等字段交叉匹配。
补充到规划原则中的内容
七、按产品型号分组及字段值关联
- 当外部资料只出现一个品牌、但包含多个产品型号时,系统仍须能够识别不同型号,并以型号作为产品记录的分组依据。
- 每个型号分别形成独立的产品记录,品牌、价格、认证、厂家及其他已定义字段的值均应关联到正确的型号。
- 同一品牌可以对应多个型号;品牌相同不代表产品记录相同。
- 不同型号的字段值不得合并、交叉匹配或错误归属。
- 当某个型号缺少部分字段值时,应保留已有的对应关系,不得将其他型号的值自动填入。
- 型号识别与分组应依据语义库已有的匹配知识、资料中的实际内容及其关联关系,不得依赖未经确认的固定型号格式或特定行业规则。
- 当资料无法明确判断某个字段值属于哪个型号时,应保留来源和待确认状态,不得随意归组。
核心要求:无论资料包含多个品牌、单个品牌下的多个型号,还是其他实际存在的产品组织形式,都必须保持产品记录独立、字段值准确归属、来源关系可追溯。
这样,之前确定的“多品牌、多产品记录”原则就扩展到了“单品牌、多型号、多组字段值”,两者遵循同一套数据关联原则。
这不是新增功能,而是结构化学习系统本身就必须具备的基础能力。
无论外部资料是:
-
多个品牌,各品牌对应自己的型号和字段值;
-
一个品牌,多个型号,各型号对应自己的字段值;
-
一个品牌、一个型号,包含多个字段值;
系统都必须依据实际资料识别产品记录,并将字段值准确关联到对应产品。
因此,后续不再把“按型号分组”当成单独追加的特殊规则,而是将其纳入统一的对象识别、记录分组、字段匹配、值提取与关系保存机制。
同样,不以当前跑偏的代码为依据。先依据你已经确认的整体规划审查架构,再决定具体重构哪些模块