148 lines
3.7 KiB
Markdown
148 lines
3.7 KiB
Markdown
# Validation 模块
|
|
|
|
`Validation` 模块负责共享订单号管理、输入识别、数据库校验查询、物料结果富化，以及为 Cleaner 提供可消费的数据。
|
|
|
|
## 1. 模块职责
|
|
|
|
- 存储与读取共享 `Production IDs`
|
|
- 将输入转换为可校验的 source numbers
|
|
- 查询数据库中的物料记录
|
|
- 结合类型关键词和已标记物料生成校验结果
|
|
- 为 Cleaner 提供订单号与物料代码
|
|
|
|
## 2. 模块结构
|
|
|
|
```mermaid
|
|
graph TD
|
|
Handler[validation-handler]
|
|
AppSvc[validation-application-service]
|
|
Store[shared-production-ids-store]
|
|
Input[production-input-service]
|
|
DB[validation-database]
|
|
DAO[DAO / database services]
|
|
|
|
Handler --> Store
|
|
Handler --> AppSvc
|
|
AppSvc --> Input
|
|
AppSvc --> DB
|
|
DB --> DAO
|
|
```
|
|
|
|
## 3. 关键入口文件
|
|
|
|
- `src/main/ipc/validation-handler.ts`
|
|
- `src/main/services/validation/validation-application-service.ts`
|
|
- `src/main/services/validation/shared-production-ids-store.ts`
|
|
- `src/main/services/validation/production-input-service.ts`
|
|
- `src/main/services/validation/validation-database.ts`
|
|
- `src/renderer/src/hooks/useValidation.ts`
|
|
|
|
## 4. 主流程
|
|
|
|
```mermaid
|
|
sequenceDiagram
|
|
participant UI as Renderer / useValidation / useCleaner
|
|
participant Handler as validation-handler
|
|
participant Store as shared-production-ids-store
|
|
participant AppSvc as validation-application-service
|
|
participant Input as production-input-service
|
|
participant DB as validation-database
|
|
|
|
UI->>Handler: set/get shared Production IDs
|
|
Handler->>Store: read/write sender scoped IDs
|
|
|
|
UI->>Handler: validate(request)
|
|
Handler->>AppSvc: validate(...)
|
|
AppSvc->>Input: resolve source numbers
|
|
AppSvc->>DB: query material records
|
|
DB-->>AppSvc: rows
|
|
AppSvc-->>Handler: validation results + stats
|
|
Handler-->>UI: response
|
|
```
|
|
|
|
## 5. 共享 Production IDs
|
|
|
|
共享订单号是 Validation 模块最重要的跨页面状态之一。
|
|
|
|
```mermaid
|
|
graph LR
|
|
Extractor[Extractor]
|
|
Store[shared-production-ids-store]
|
|
Validation[Validation]
|
|
Cleaner[Cleaner]
|
|
|
|
Extractor --> Store
|
|
Store --> Validation
|
|
Validation --> Cleaner
|
|
```
|
|
|
|
这个状态当前按 `senderId` 维度存储，主要被：
|
|
|
|
- `Extractor`
|
|
写入
|
|
- `Validation`
|
|
读取和解析
|
|
- `Cleaner`
|
|
间接消费
|
|
|
|
## 6. 结果生成逻辑
|
|
|
|
校验结果不仅是数据库原始数据，还会叠加：
|
|
|
|
- 已标记删除状态
|
|
- 负责人关键词匹配
|
|
- 用户权限作用域
|
|
|
|
```mermaid
|
|
flowchart TD
|
|
DBRows[数据库物料记录]
|
|
Marked[已标记物料]
|
|
Keywords[类型关键词]
|
|
Scope[用户作用域]
|
|
Result[ValidationResult]
|
|
|
|
DBRows --> Result
|
|
Marked --> Result
|
|
Keywords --> Result
|
|
Scope --> Result
|
|
```
|
|
|
|
## 7. 模块输出
|
|
|
|
Validation 主要对外输出两类数据：
|
|
|
|
- `ValidationResponse`
|
|
提供给校验页和 Cleaner 页
|
|
- `CleanerData`
|
|
提供给 Cleaner 执行前的数据准备
|
|
|
|
## 8. 最近的结构优化
|
|
|
|
这一块已经从早期的大 `validation-handler` 中拆分出来：
|
|
|
|
- `shared-production-ids-store`
|
|
- `validation-database`
|
|
- `production-input-service`
|
|
- `validation-application-service`
|
|
|
|
这样之后：
|
|
|
|
- handler 只做 IPC 壳
|
|
- 共享状态有独立归属
|
|
- 数据库方言差异有独立封装
|
|
|
|
## 9. 常见改动点
|
|
|
|
- 改共享订单号逻辑：`shared-production-ids-store.ts`
|
|
- 改输入识别：`production-input-service.ts`
|
|
- 改数据库差异：`validation-database.ts`
|
|
- 改校验结果富化：`validation-application-service.ts`
|
|
- 改 renderer 侧调用：`useValidation.ts`
|
|
|
|
## 10. 修改建议
|
|
|
|
- 不要再把共享状态放回 handler
|
|
- 数据库分支优先收敛在 `validation-database`
|
|
- 校验结果组装逻辑尽量集中在 application service
|
|
- 跨模块共享数据要保持单向来源清晰
|