Institutional Knowledge Assets

Overview

This document outlines the structure and implementation of institutional knowledge assets for the SKYOCEAN platform MVP. Institutional knowledge assets represent the foundational organizational entities, relationships, and certifications that form the backbone of the SKYOCEAN ecosystem.

Knowledge Asset Types

1. Organizational Structure

The organizational structure knowledge asset defines the core business units of SKYOCEAN and their relationships:

{
  "assertion": [
    {
      "@id": "urn:id:skyocean:organization",
      "@type": ["http://schema.org/Organization"],
      "http://schema.org/name": [{"@value": "SKYOCEAN International"}],
      "http://schema.org/description": [{"@value": "Web3-based marketplace for export trading and commodities"}],
      "http://schema.org/subOrganization": [
        {"@id": "urn:id:skyocean:sot"},
        {"@id": "urn:id:skyocean:skyt"},
        {"@id": "urn:id:skyocean:sol"}
      ]
    },
    {
      "@id": "urn:id:skyocean:sot",
      "@type": ["http://schema.org/Organization"],
      "http://schema.org/name": [{"@value": "SKYOCEAN Trading"}],
      "http://schema.org/description": [{"@value": "Primary trading operations division"}]
    },
    {
      "@id": "urn:id:skyocean:skyt",
      "@type": ["http://schema.org/Organization"],
      "http://schema.org/name": [{"@value": "SKYOCEAN Technology"}],
      "http://schema.org/description": [{"@value": "Platform development and blockchain infrastructure"}]
    },
    {
      "@id": "urn:id:skyocean:sol",
      "@type": ["http://schema.org/Organization"],
      "http://schema.org/name": [{"@value": "SKYOCEAN Logistics"}],
      "http://schema.org/description": [{"@value": "Supply chain and logistics management"}]
    }
  ]
}

2. Regulatory Compliance

The regulatory compliance knowledge asset documents the regulatory frameworks and jurisdictions in which SKYOCEAN operates:

{
  "assertion": [
    {
      "@id": "urn:id:skyocean:compliance",
      "@type": ["http://schema.org/GovernmentPermit"],
      "http://schema.org/name": [{"@value": "SKYOCEAN Regulatory Compliance"}],
      "http://schema.org/permissionAuthority": [{"@value": "International Trade Commission"}],
      "http://schema.org/validIn": [
        {"@id": "urn:id:skyocean:region:apac"},
        {"@id": "urn:id:skyocean:region:emea"},
        {"@id": "urn:id:skyocean:region:americas"}
      ]
    }
  ]
}

3. Certification Portfolio

The certification knowledge asset maintains the organization’s certifications and standards compliance:

{
  "assertion": [
    {
      "@id": "urn:id:skyocean:certifications",
      "@type": ["http://schema.org/ItemList"],
      "http://schema.org/name": [{"@value": "SKYOCEAN Certification Portfolio"}],
      "http://schema.org/itemListElement": [
        {"@id": "urn:id:skyocean:cert:iso9001"},
        {"@id": "urn:id:skyocean:cert:iso27001"},
        {"@id": "urn:id:skyocean:cert:fairtrade"}
      ]
    }
  ]
}

4. Partnership Network

The partnership network knowledge asset establishes relationships with external organizations:

{
  "assertion": [
    {
      "@id": "urn:id:skyocean:partnerships",
      "@type": ["http://schema.org/Organization"],
      "http://schema.org/name": [{"@value": "SKYOCEAN Partnership Network"}],
      "http://schema.org/member": [
        {"@id": "urn:id:skyocean:partner:logistics"},
        {"@id": "urn:id:skyocean:partner:financial"},
        {"@id": "urn:id:skyocean:partner:technology"}
      ]
    }
  ]
}

Implementation Guidelines

Publishing to DKG

To publish institutional knowledge assets to the DKG:

1. Create Asset Structure:
   • Define public and private components
   • Establish entity relationships
   • Use schema.org vocabularies
2. Set Access Controls:
   • Public organizational data (name, business units)
   • Private operational details (compliance information, partnerships)
   • Permissioned certifications
3. Asset Publishing:

// Example code for publishing an institutional knowledge asset
async function publishInstitutionalAsset(assetData) {
  const asset = {
    public: {
      assertion: assetData.public
    },
    private: {
      assertion: assetData.private
    }
  };
  
  const result = await dkgClient.assets.create(
    asset,
    {
      epochsNum: 2,  // Store for 2 epochs
      maxNumberOfRetries: 5,
      frequency: 1  // Minutes between retries
    }
  );
  
  return result;
}

Access Control Mechanisms

Institutional knowledge assets require different levels of access control:

Asset Type	Public Access	Partner Access	Internal Access
Organization Structure	✓	✓	✓
Compliance	Partial	Partial	✓
Certifications	✓	✓	✓
Partnerships	Partial	✓	✓

MVP Testing Strategy

For institutional knowledge assets, test the following scenarios:

1. Asset Creation Verification:
   • Verify asset publishing success
   • Validate assertion structure
   • Check relationship integrity
2. Access Control Testing:
   • Test public data accessibility
   • Verify private data protection
   • Test role-based access controls
3. Asset Retrieval:
   • Test asset lookup by ID
   • Verify relationship resolution
   • Validate data integrity
4. Data Updates:
   • Test certification updates
   • Verify partnership additions
   • Test organizational changes

Next Steps

Following institutional knowledge assets, the next phase will implement transactional knowledge assets that represent:

• Commodity records
• Purchase orders
• Shipping documentation
• Letters of credit
• Inspection certificates
• Bills of lading

These transactional assets will be linked to the institutional foundation established in this phase.