@liuhange/dsh-data-asset-shared 2.0.3 → 3.0.0

package/lib/businessRulesLoader.js

@@ -69,7 +69,7 @@ export class BusinessRulesLoader {
         if (typeof version !== 'string') {
             return false;
         }
-        return version.startsWith('1.');
+        return version.startsWith('1.') || version.startsWith('3.');
     }
     hasRequiredNodes(config) {
         return (config.valueAssessment !== undefined &&

package/lib/defaultBusinessRules.js

@@ -120,6 +120,107 @@ export const defaultIncrementalSchedulingConfig = {
     stateFilePath: 'state/incremental-state.json',
     lockTimeout: 3600,
 };
+export const defaultRegistrationConfig = {
+    ruleVersion: '1.0',
+    agencies: [
+        {
+            id: 'beijing',
+            name: '北京国际大数据交易所',
+            location: '北京',
+            specialties: ['医疗', '健康', '生物'],
+            contact: '北京国际大数据交易所官网',
+            basis: '医疗数据登记案例集中',
+        },
+        {
+            id: 'shanghai',
+            name: '上海数据交易所',
+            location: '上海',
+            specialties: ['金融', '征信', '支付'],
+            contact: '上海数据交易所官网',
+            basis: '金融数据交易活跃度最高',
+        },
+        {
+            id: 'shenzhen',
+            name: '深圳数据交易所',
+            location: '深圳',
+            specialties: ['交通', '物流', '地理'],
+            contact: '深圳数据交易所官网',
+            basis: '交通数据登记案例较多',
+        },
+    ],
+    dataTypeMapping: {
+        '金融': 'shanghai',
+        '征信': 'shanghai',
+        '支付': 'shanghai',
+        '医疗': 'beijing',
+        '健康': 'beijing',
+        '生物': 'beijing',
+        '交通': 'shenzhen',
+        '物流': 'shenzhen',
+        '地理': 'shenzhen',
+    },
+    defaultRecommendation: {
+        agency: null,
+        basis: '根据数据属性匹配',
+        message: '建议咨询专业机构',
+    },
+    registrationFee: 5000,
+    registrationSteps: ['申请', '受理', '审查', '公示', '异议', '存证', '凭证'],
+};
+export const defaultPolicyReferences = [
+    {
+        stage: 'INVENTORY',
+        stageLabel: '盘点',
+        documents: [
+            { name: '中华人民共和国数据安全法', docNumber: '主席令第八十四号', coreRequirement: '数据分类分级保护' },
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '数据产权三权分置' },
+        ],
+    },
+    {
+        stage: 'CLEANING',
+        stageLabel: '清洗',
+        documents: [
+            { name: '企业数据资源相关会计处理暂行规定', docNumber: '财会〔2023〕11号', coreRequirement: '数据资源入表条件' },
+            { name: '数据资产评估指导意见', docNumber: '中评协〔2023〕17号', coreRequirement: '六维质量评价标准' },
+        ],
+    },
+    {
+        stage: 'MASKING',
+        stageLabel: '脱敏',
+        documents: [
+            { name: '中华人民共和国个人信息保护法', docNumber: '主席令第九十一号', coreRequirement: '匿名化后不再属于个人信息' },
+            { name: '关于完善数据流通安全治理的实施方案', docNumber: '发改数据〔2025〕18号', coreRequirement: '脱敏后可按一般数据流通' },
+        ],
+    },
+    {
+        stage: 'PACKAGING',
+        stageLabel: '包装',
+        documents: [
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '登记凭证可用于入表、融资、入股' },
+        ],
+    },
+    {
+        stage: 'PRECHECK',
+        stageLabel: '登记预检',
+        documents: [
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '不予登记情形' },
+        ],
+    },
+    {
+        stage: 'DOC_GENERATION',
+        stageLabel: '材料生成',
+        documents: [
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '7步登记流程审查重点' },
+        ],
+    },
+    {
+        stage: 'AGENCY_MATCHING',
+        stageLabel: '机构匹配',
+        documents: [
+            { name: '数据产权登记工作指引（试行）', docNumber: '国数综政策〔2026〕35号', coreRequirement: '登记机构名录' },
+        ],
+    },
+];
 export const defaultBusinessRules = {
     version: '1.0',
     lastUpdated: '2026-08-17',
@@ -217,5 +318,7 @@ export const defaultBusinessRules = {
         defaultDescription: '适用于数据分析、模型训练、行业研究等场景',
         version: 'V1.0',
     },
+    registration: defaultRegistrationConfig,
+    policyReferences: defaultPolicyReferences,
 };
 //# sourceMappingURL=defaultBusinessRules.js.map

package/lib/index.js

@@ -6,4 +6,7 @@ export { FileFormatAdapter } from './fileFormatAdapter.js';
 export { ReportGenerator } from './reportGenerator.js';
 export { PathValidator } from './pathValidator.js';
 export { AuditLogger } from './auditLogger.js';
+export { PolicyReferenceResolver } from './policyReferenceResolver.js';
+export { RegistrationNavigationEnhancer } from './registrationNavigationEnhancer.js';
+export { defaultRegistrationConfig, defaultPolicyReferences, } from './defaultBusinessRules.js';
 //# sourceMappingURL=index.js.map

package/lib/policyReferenceResolver.js

@@ -0,0 +1,64 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { defaultPolicyReferences } from './defaultBusinessRules.js';
+export class PolicyReferenceResolver {
+    static instance = null;
+    cache = new Map();
+    references = [];
+    configPath;
+    constructor(configPath) {
+        this.configPath = configPath
+            ? path.resolve(configPath)
+            : path.resolve(process.cwd(), 'config', 'policy-references.json');
+        this.load();
+    }
+    static getInstance(configPath) {
+        if (!PolicyReferenceResolver.instance) {
+            PolicyReferenceResolver.instance = new PolicyReferenceResolver(configPath);
+        }
+        return PolicyReferenceResolver.instance;
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                const raw = fs.readFileSync(this.configPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (parsed.policyReferences && Array.isArray(parsed.policyReferences)) {
+                    this.references = parsed.policyReferences;
+                    return;
+                }
+            }
+        }
+        catch {
+            console.warn('[PolicyReferenceResolver] 配置加载失败，使用默认值');
+        }
+        this.references = defaultPolicyReferences;
+    }
+    resolve(stage) {
+        if (this.cache.has(stage)) {
+            return this.cache.get(stage);
+        }
+        const ref = this.references.find(r => r.stage === stage);
+        let documents;
+        if (ref && ref.documents && ref.documents.length > 0) {
+            documents = ref.documents;
+        }
+        else {
+            console.warn(`[PolicyReferenceResolver] 环节 ${stage} 未配置政策依据，使用占位项`);
+            documents = [
+                {
+                    name: '依据文件待补充',
+                    docNumber: '待配置',
+                    coreRequirement: '请补充对应政策依据',
+                },
+            ];
+        }
+        this.cache.set(stage, documents);
+        return documents;
+    }
+    clearCache() {
+        this.cache.clear();
+        PolicyReferenceResolver.instance = null;
+    }
+}
+//# sourceMappingURL=policyReferenceResolver.js.map

package/lib/registrationNavigationEnhancer.js

@@ -0,0 +1,107 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { PolicyReferenceResolver } from './policyReferenceResolver.js';
+import { defaultRegistrationConfig } from './defaultBusinessRules.js';
+const PLUGIN_STAGE_MAP = {
+    'data-inventory': 'INVENTORY',
+    'data-cleaning': 'CLEANING',
+    'data-masking': 'MASKING',
+    'data-packaging': 'PACKAGING',
+};
+const NAVIGATION_TEXTS = {
+    'data-inventory': '本数据集已完成盘点，建议下一步申请数据产权登记。登记机构推荐：{agency}',
+    'data-cleaning': '数据质量已达到登记要求（依据《数据资产评估指导意见》六维质量评价标准）。',
+    'data-masking': "脱敏后数据已符合登记审查中的'来源合规性'要求（依据《数据产权登记工作指引》第三章）。",
+    'data-packaging': "本产品说明书可直接用于登记申请材料中的'数据描述'部分。",
+};
+export class RegistrationNavigationEnhancer {
+    config;
+    configPath;
+    constructor(configPath) {
+        this.configPath = configPath
+            ? path.resolve(configPath)
+            : path.resolve(process.cwd(), 'config', 'registration-agencies.json');
+        this.config = this.loadConfig();
+    }
+    loadConfig() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                const raw = fs.readFileSync(this.configPath, 'utf-8');
+                return JSON.parse(raw);
+            }
+        }
+        catch {
+            console.warn('[RegistrationNavigationEnhancer] 配置加载失败，使用默认值');
+        }
+        return defaultRegistrationConfig;
+    }
+    matchAgency(dataType) {
+        const agencyId = this.config.dataTypeMapping[dataType];
+        if (agencyId) {
+            const agency = this.config.agencies.find(a => a.id === agencyId);
+            if (agency)
+                return agency.name;
+        }
+        return this.config.defaultRecommendation.message;
+    }
+    enhance(report, pluginName, dataType) {
+        const stage = PLUGIN_STAGE_MAP[pluginName];
+        if (!stage)
+            return report;
+        const resolver = PolicyReferenceResolver.getInstance();
+        const policyDocs = resolver.resolve(stage);
+        let navText = NAVIGATION_TEXTS[pluginName] || '';
+        if (pluginName === 'data-inventory') {
+            const agencyName = this.matchAgency(dataType);
+            navText = navText.replace('{agency}', agencyName);
+        }
+        const policyText = policyDocs
+            .map(d => `- 《${d.name}》（${d.docNumber}）：${d.coreRequirement}`)
+            .join('\n');
+        const enhancedReport = `${report}
+
+---
+
+## 登记导航
+
+${navText}
+
+## 政策依据
+
+${policyText}
+`;
+        return enhancedReport;
+    }
+    enhanceAll(orchestrationResult, dataType) {
+        return {
+            ...orchestrationResult,
+            maskingReport: this.enhance(orchestrationResult.maskingReport, 'data-masking', dataType),
+            cleaningReport: this.enhance(orchestrationResult.cleaningReport, 'data-cleaning', dataType),
+            inventoryReport: this.enhance(orchestrationResult.inventoryReport, 'data-inventory', dataType),
+            packagingManual: this.enhance(orchestrationResult.packagingManual, 'data-packaging', dataType),
+        };
+    }
+    matchAgencyResult(dataType) {
+        const agencyId = this.config.dataTypeMapping[dataType];
+        if (agencyId) {
+            const agency = this.config.agencies.find(a => a.id === agencyId);
+            if (agency) {
+                return {
+                    agency: agency.id,
+                    agencyName: agency.name,
+                    basis: agency.basis,
+                    dataType,
+                    ruleVersion: this.config.ruleVersion,
+                };
+            }
+        }
+        return {
+            agency: null,
+            agencyName: this.config.defaultRecommendation.message,
+            basis: this.config.defaultRecommendation.basis,
+            dataType,
+            ruleVersion: this.config.ruleVersion,
+        };
+    }
+}
+//# sourceMappingURL=registrationNavigationEnhancer.js.map

package/lib/types/defaultBusinessRules.d.ts

@@ -1,4 +1,4 @@
-import type { BusinessRulesConfig } from './types.js';
+import type { BusinessRulesConfig, RegistrationConfig, PolicyReference } from './types.js';
 export declare const defaultQualityScoringConfig: {
     weights: {
         completeness: number;
@@ -136,5 +136,7 @@ export declare const defaultIncrementalSchedulingConfig: {
     stateFilePath: string;
     lockTimeout: number;
 };
+export declare const defaultRegistrationConfig: RegistrationConfig;
+export declare const defaultPolicyReferences: PolicyReference[];
 export declare const defaultBusinessRules: BusinessRulesConfig;
 //# sourceMappingURL=defaultBusinessRules.d.ts.map

package/lib/types/index.d.ts

@@ -9,4 +9,7 @@ export type { MaskingReportParams, CleaningReportParams, InventoryReportParams,
 export { PathValidator } from './pathValidator.js';
 export { AuditLogger } from './auditLogger.js';
 export type { AuditLogParams } from './auditLogger.js';
+export { PolicyReferenceResolver } from './policyReferenceResolver.js';
+export { RegistrationNavigationEnhancer } from './registrationNavigationEnhancer.js';
+export { defaultRegistrationConfig, defaultPolicyReferences, } from './defaultBusinessRules.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/policyReferenceResolver.d.ts

@@ -0,0 +1,13 @@
+import type { PolicyStage, PolicyDocument } from './types.js';
+export declare class PolicyReferenceResolver {
+    private static instance;
+    private cache;
+    private references;
+    private configPath;
+    private constructor();
+    static getInstance(configPath?: string): PolicyReferenceResolver;
+    private load;
+    resolve(stage: PolicyStage): PolicyDocument[];
+    clearCache(): void;
+}
+//# sourceMappingURL=policyReferenceResolver.d.ts.map

package/lib/types/registrationNavigationEnhancer.d.ts

@@ -0,0 +1,12 @@
+import type { OrchestrationResult, AgencyMatchResult } from './types.js';
+export declare class RegistrationNavigationEnhancer {
+    private config;
+    private configPath;
+    constructor(configPath?: string);
+    private loadConfig;
+    private matchAgency;
+    enhance(report: string, pluginName: string, dataType: string): string;
+    enhanceAll(orchestrationResult: OrchestrationResult, dataType: string): OrchestrationResult;
+    matchAgencyResult(dataType: string): AgencyMatchResult;
+}
+//# sourceMappingURL=registrationNavigationEnhancer.d.ts.map

package/lib/types/types.d.ts

@@ -82,6 +82,8 @@ export interface BusinessRulesConfig {
     visualization?: VisualizationConfig;
     sensitivityClassification?: SensitivityClassificationConfig;
     incrementalScheduling?: IncrementalSchedulingConfig;
+    registration?: RegistrationConfig;
+    policyReferences?: PolicyReference[];
 }
 export interface SensitiveField {
     type: SensitiveFieldType;
@@ -275,4 +277,90 @@ export interface IncrementalSchedulingConfig {
     stateFilePath: string;
     lockTimeout: number;
 }
+export type PolicyStage = 'INVENTORY' | 'CLEANING' | 'MASKING' | 'PACKAGING' | 'PRECHECK' | 'DOC_GENERATION' | 'AGENCY_MATCHING';
+export interface PolicyDocument {
+    name: string;
+    docNumber: string;
+    coreRequirement: string;
+}
+export interface PolicyReference {
+    stage: PolicyStage;
+    stageLabel: string;
+    documents: PolicyDocument[];
+}
+export interface AgencyConfig {
+    id: string;
+    name: string;
+    location: string;
+    specialties: string[];
+    contact: string;
+    basis: string;
+}
+export interface RegistrationConfig {
+    ruleVersion: string;
+    agencies: AgencyConfig[];
+    dataTypeMapping: Record<string, string>;
+    defaultRecommendation: {
+        agency: string | null;
+        basis: string;
+        message: string;
+    };
+    registrationFee: number;
+    registrationSteps: string[];
+}
+export interface NavigationField {
+    registrationNavigation: string;
+    policyReferences: PolicyDocument[];
+}
+export type CheckName = 'NATIONAL_SECURITY' | 'SOURCE_COMPLIANCE' | 'OWNERSHIP_DISPUTE' | 'MATERIAL_AUTHENTICITY';
+export type CheckResult = 'PASS' | 'FAIL' | 'PENDING' | 'UNDETERMINED';
+export type PrecheckConclusion = 'CAN_REGISTER' | 'CANNOT_REGISTER' | 'PENDING_CONFIRMATION';
+export interface PrecheckCheckItem {
+    name: CheckName;
+    label: string;
+    result: CheckResult;
+    detail: string;
+}
+export interface PrecheckReport {
+    conclusion: PrecheckConclusion;
+    checks: PrecheckCheckItem[];
+    failedItems: string[];
+    policyReferences: PolicyDocument[];
+    timestamp: string;
+}
+export type RegistrationDocName = 'DATA_DESCRIPTION' | 'SOURCE_LEGALITY_STATEMENT' | 'OWNERSHIP_EXPLANATION';
+export type DocStatus = 'GENERATED' | 'FAILED' | 'PENDING_FIELDS';
+export interface RegistrationDoc {
+    name: RegistrationDocName;
+    label: string;
+    content: string;
+    status: DocStatus;
+    missingFields?: string[];
+}
+export interface RegistrationDocPackage {
+    docs: RegistrationDoc[];
+    packagePath: string;
+    policyReferences: PolicyDocument[];
+    timestamp: string;
+}
+export interface AgencyMatchResult {
+    agency: string | null;
+    agencyName: string;
+    basis: string;
+    dataType: string;
+    ruleVersion: string;
+}
+export type StepStatus = 'COMPLETED' | 'CURRENT' | 'PENDING';
+export interface RegistrationStep {
+    name: string;
+    status: StepStatus;
+    description: string;
+}
+export interface RegistrationProgress {
+    steps: RegistrationStep[];
+    currentStep: number;
+    registrationId: string;
+    agency: string;
+    timestamp: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
     "name":  "@liuhange/dsh-data-asset-shared",
     "description":  "Shared infrastructure for data assetization plugins: business rules loader, file format adapter, report generator, path validator, audit logger",
-    "version": "2.0.3",
+    "version": "3.0.0",
     "publishConfig":  {
                           "access":  "public"
                       },
@@ -41,5 +41,6 @@
                              "@deepseek-ai/cordis": "^4.0.0",
                              "@deepseek-ai/dsh-tools": "0.0.1-rc.1",
                              "@deepseek-ai/schemastery": "^3.18.0"
-                         }
+                         },
+    "dsh":  { "bundle":  { "patch": true } }
 }