EcoIQ Platform Module

EcoIQ Knowledge Graph & Relationship Map

Connect assets, evidence, risks, finance, suppliers and verified impact.

EcoIQ Knowledge Graph & Relationship Map turns scattered project data into an explainable network of relationships. It shows how each asset connects to evidence, risks, playbooks, suppliers, funders, finance models, governance approvals, MRV claims, trust badges, countries, Maqasid/Mizan principles and verified impact. This helps investors, governments, project owners and AI agents understand why a recommendation exists, what evidence supports it and what action should happen next.

Core purpose: Make EcoIQ's intelligence connected, traceable and explainable across the full industrial modernisation lifecycle.

Open Knowledge Graph View Project Relationship Map Trace Evidence to Claim Find Missing Links Show Finance-Ready Clusters Show No Harm Risk Paths Open Maqasid/Mizan Graph Run Graph Health Check Send Missing Link Alert to Teams Export Relationship Map

Connected EcoIQ Modules

Asset Passport

Supplies the asset nodes at the centre of the graph.

Data Room & Evidence Vault

Supplies the evidence nodes every claim traces back to.

Impact MRV Layer

Supplies the MRV/impact nodes and verification status.

Industrial Playbook Library

Supplies the playbook nodes matched to each asset.

Supplier & Funding Marketplace

Supplies the supplier/funder nodes and relationships.

Institutional Finance Engine

Supplies the finance nodes linked to each project.

Command Centre

Surfaces graph completeness across the live project pipeline.

Portfolio & Country Transition Atlas

Supplies the country/region nodes and clusters.

Governance & Expert Review Board

Supplies the governance review nodes and approval decisions.

Certification & Trust Badge Engine

Supplies the trust badge nodes shown on projects.

AI Agent Operations Console

Supplies the agent trace nodes showing which agent generated which output.

Product Analytics & KPI Engine

Consumes graph completeness as part of platform-wide KPIs.

Public Trust & Impact Portal

Publishes only approved graph nodes as public claims.

Microsoft Ecosystem Core Stack

Provides the agent, data and dashboard building blocks a production graph would run on.

API & Integration Layer

Exposes graph queries and relationship data through the API.

Security, Privacy & Compliance Centre

Enforces which graph nodes are permissioned for which viewer.

Maqasid/Mizan ethical scoring

Supplies the ethical principle nodes linked to risks and actions.

No Harm Gate

Blocks unresolved risk paths from being used externally.

Graph Node Types

Node Type 1

Asset Nodes

Examples

Boiler houseFactory lineCompressorMineFarmWater systemPublic buildingSolar + battery siteDistrict heating networkVillage heating project

Fields

Asset nameAsset typeLocationOwnerSectorConditionRisk levelEvidence qualityLinked projectMaqasid/Mizan scoreMRV status

Node Type 2

Company / Organisation Nodes

Examples

Industrial companyMunicipality / akimatSupplierFunderInvestorCSR sponsorIslamic finance providerGovernment agencyNGOMicrosoft ecosystem partner

Fields

Organisation nameTypeCountrySectorRelationship roleOpportunity statusDue diligence statusLinked projectsPermissions

Node Type 3

Evidence Nodes

Examples

PhotoVideoEnergy billFuel billWater billSensor logInspection reportSupplier quoteFinance memoExpert approvalMRV reportPublic summary

Fields

Evidence typeSourceUpload dateEvidence qualityLinked claimLinked assetPermission levelPublic-safe statusExpiry / review date

Node Type 4

Risk Nodes

Examples

Heat lossFuel wasteAir pollutionWater wasteSafety riskDebt burdenWeak evidenceMissing consentUnverified supplierUnsupported impact claimPublic reporting risk

Fields

Risk typeSeverityProbabilityOwnerEvidence linkMitigationNo Harm Gate status

Node Type 5

Project Nodes

Examples

Boiler House #3 ModernisationFactory Compressed Air OptimisationVillage Clean Heating PilotWater Recycling UpgradeCountry Transition Atlas project

Fields

Project nameStageCountrySectorCAPEX estimateFunding statusGovernance statusMRV statusTrust badgesNext action

Node Type 6

Playbook Nodes

Examples

Boiler Modernisation PlaybookFactory Energy Efficiency PlaybookMining Diesel Reduction PlaybookWater Recycling PlaybookSolar + Battery Industrial PlaybookWaste Heat Recovery PlaybookSMR Feasibility Playbook

Fields

Playbook nameSectorAsset typesEvidence requiredQuick winsDeep upgradesMRV metricsNo Harm risks

Node Type 7

Finance Nodes

Examples

CAPEX modelOPEX savingsPayback estimateIRR / NPV noteInvestor memoFunding gapGrant routeCSR routeIslamic finance routeSupplier quote

Fields

Finance typeAmount / estimateConfidenceAssumptionsReview statusLinked evidenceLinked projectNo Harm notes

Node Type 8

Supplier / Funder Nodes

Examples

Heat pump supplierSmart meter providerInsulation contractorCSR sponsorIslamic finance providerDevelopment bankGrant programmeImpact investor

Fields

RoleRegionTechnology / funding typeFit scoreDue diligence statusLinked projectsApproved outreach status

Node Type 9

Governance Review Nodes

Examples

Technical reviewFinancial reviewEnvironmental reviewSafety reviewMaqasid/Mizan reviewIslamic finance reviewPublic summary approval

Fields

Reviewer roleStatusCommentsTimestampEvidence versionApproval decisionUnresolved risks

Node Type 10

MRV / Impact Nodes

Examples

Baseline capturedAfter-data collectedMRV in reviewMRV verifiedVerified impact reportPublic impact story

Fields

Impact metricBaseline valueAfter valueVerification statusEvidence qualityPublic statusLinked report

Node Type 11

Country / Region Nodes

Examples

KazakhstanUnited KingdomSaudi ArabiaTürkiyeAlmaty RegionKaraganda RegionLondonRiyadhIstanbul

Fields

Country / regionAssets mappedProjects discoveredFinance-ready projectsHighest-harm clustersVerified impact projectsCAPEX pipelineFunding gap

Node Type 12

Maqasid / Mizan Principle Nodes

Examples

Protect healthReduce harmProtect wealth/resourcesReduce wasteCommunity benefitBalance between input and useful outputStewardship / amanahJustice / adlNo harm / la darar

Fields

PrincipleDiagnostic questionLinked risksLinked actionsLinked impact metricsReviewer status

Node Type 13

Trust Badge Nodes

Examples

Evidence StrongFinance ReadyMRV VerifiedExpert ReviewedPublic Summary ApprovedNo Harm Gate PassedData Room CompleteMicrosoft Ecosystem Ready

Fields

Badge nameCategoryStatusIssue dateExpiry/review dateEvidence requirementsPublic visibilityRevocation risk

Graph Relationship Types

ASSET_HAS_EVIDENCEEVIDENCE_SUPPORTS_CLAIMASSET_HAS_RISKRISK_TRIGGERED_BY_EVIDENCEASSET_MATCHES_PLAYBOOKPLAYBOOK_RECOMMENDS_ACTIONACTION_REQUIRES_SUPPLIERPROJECT_HAS_FINANCE_MODELPROJECT_HAS_FUNDING_ROUTEPROJECT_REQUIRES_REVIEWREVIEW_APPROVES_ACTIONPROJECT_HAS_MRV_CLAIMMRV_CLAIM_BACKED_BY_EVIDENCEPROJECT_HAS_BADGEBADGE_REQUIRES_EVIDENCEPROJECT_LOCATED_IN_COUNTRYCOUNTRY_HAS_PROJECT_CLUSTERPROJECT_ALIGNS_WITH_MAQASIDPROJECT_SUPPORTS_MIZANORGANISATION_OWNS_ASSETSUPPLIER_CAN_DELIVER_ACTIONFUNDER_CAN_SUPPORT_PROJECTPUBLIC_SUMMARY_DERIVED_FROM_MRVAI_AGENT_GENERATED_OUTPUTOUTPUT_REQUIRES_HUMAN_APPROVALORGANISATION_HAS_OPERATIONAL_LOSSASSET_HAS_OPERATIONAL_LOSSLOSS_BACKED_BY_EVIDENCELOSS_QUANTIFIED_AS_FINANCIALLOSS_HAS_INTERVENTION_OPTIONINTERVENTION_REDUCES_LOSSINTERVENTION_HAS_SCENARIOINTERVENTION_HAS_FUNDING_GAPFUNDING_GAP_MATCHED_TO_ROUTEINTERVENTION_FEEDS_CAPITAL_DECISIONCAPITAL_DECISION_LINKED_TO_COUNCIL_CASECAPITAL_DECISION_HAS_VERIFIED_OUTCOMEVERIFIED_OUTCOME_GENERATES_REALLOCATION_SIGNAL

Relationship Map Views

Project Graph View

Shows one project and all linked evidence, risks, playbooks, suppliers, funders, finance memos, reviews, MRV claims and badges.

Asset Graph View

Shows one asset and its owner, evidence, condition, risks, recommended playbook, modernisation actions and MRV status.

Country Graph View

Shows country-level clusters: assets, regions, sectors, finance-ready projects, high-harm zones and verified impact projects.

Supplier / Funder Graph View

Shows which suppliers/funders connect to which project types, countries, playbooks and due diligence status.

Evidence Trace Graph

Shows how one public claim or investor memo statement traces back to evidence, review and approval.

Maqasid/Mizan Graph

Shows how a project connects to ethical principles, risks reduced, actions taken and verified impact.

No Harm Gate Graph

Shows unresolved risk paths: weak evidence, missing consent, supplier risk, debt burden, safety risk and public reporting risk.

AI Agent Trace Graph

Shows which agent generated an output, what evidence it used, which model/task status it had and whether human approval is required.

Graph Dashboard Cards

Total nodesTotal relationshipsAssets linkedEvidence nodesProjects with complete graphProjects missing evidence linksProjects with unresolved risk pathsFinance-ready graph clustersMRV verified graph clustersSupplier/funder relationshipsMaqasid/Mizan principle linksNo Harm Gate unresolved pathsOrphan evidence nodesOrphan project nodesPublic claims with full traceGraph completeness average

Graph Completeness Score

Score should check

Asset linked to project
Project linked to evidence
Evidence linked to claim
Project linked to playbook
Project linked to finance model
Project linked to supplier/funding route
Project linked to governance review
Project linked to MRV status
Project linked to trust badges
Risks linked to mitigations
Public claims linked to approved evidence

Labels

Complete graphStrong graphPartial graphWeak graphBroken traceNeeds linking

Process Improvement Engine

The graph should improve EcoIQ processes by detecting:

1. Missing Links

Project has finance memo but no evidence link
MRV claim has no after-data
Public summary has no approval
Supplier match has no due diligence
Badge issued without required evidence

2. Bottlenecks

Many projects stuck at missing baseline
Many supplier matches stuck at due diligence
Many finance memos awaiting review
Many public summaries blocked by consent

3. Duplicate Work

Same supplier quote uploaded twice
Same asset created twice
Same evidence linked to wrong project
Same country brief created from stale data

4. Risk Propagation

Weak evidence affects finance memo, trust badge and public summary
Missing consent blocks public portal and sponsor reporting
Supplier due diligence failure affects implementation and badge status

5. High-Value Next Actions

One missing document can unlock finance-ready status
One review can unlock public summary approval
One supplier quote can unlock board pack
One MRV after-data upload can unlock verified impact badge

Process improvement recommendations

Example Graphs

Project

Boiler House #3 Modernisation

Graph links

Asset: coal-fired boiler house
Evidence: 8 photos, 1 fuel bill, 1 meter reading
Risks: heat loss, soot, missing smart meter, fuel waste
Playbook: Boiler Modernisation Playbook
Actions: pipe insulation, smart meters, boiler servicing
Finance: draft CAPEX/OPEX model
Supplier: insulation contractor, smart meter provider
Governance: technical review required
MRV: baseline partial
Badges: Evidence Medium, Finance Model Drafted, No Harm Gate Needs Review
Maqasid/Mizan: protect health, reduce waste, restore balance

Process improvement: Collect 12 months of fuel bills and request technical review to unlock Finance Ready.

Project

Factory Compressed Air Optimisation

Graph links

Asset: compressor system
Evidence: energy bill, compressor photo, downtime note
Risk: compressed air leaks, high electricity use
Playbook: Compressed Air Optimisation
Finance: quick payback estimate
Supplier: compressed air audit provider
Governance: finance review pending
MRV: after-data pending
Badges: Finance Ready, Supplier Shortlisted, MRV In Review

Process improvement: Complete after-data collection to unlock MRV Verified and public impact story.

Project

Village Clean Heating Pilot

Graph links

Asset: household heating system
Evidence: before photos, consent record, installation photo
Risk: indoor air harm, fuel burden
Playbook: Boiler / Clean Heating Modernisation
Funder: CSR sponsor, sadaqah jariyah route
Governance: public summary approval required
MRV: baseline captured, after-data pending
Badges: Sponsor Ready, Needs Consent, Public Summary Drafted
Maqasid/Mizan: protect health, reduce harm, community benefit

Process improvement: Record consent and after-data before publishing public impact story.

Country

Kazakhstan Clean Heating Cluster

Graph links

Country: Kazakhstan
Regions: Almaty Region, Karaganda Region
Assets: boiler houses, village heating, public buildings
Risks: coal smoke, fuel burden, heat loss
Playbooks: Boiler Modernisation, District Heating Upgrade, Clean Heating
Funders: CSR sponsors, municipal co-finance, Islamic charitable funds
MRV: pilot projects in progress
Badges: Sponsor Ready, Finance Ready, Needs Verification

Process improvement: Prioritise finance-ready heating projects with strong evidence and high Maqasid/Mizan uplift.

Visual UI Concept

Left panel

Graph filter controls

Country
Sector
Asset type
Project stage
Evidence quality
Risk type
Badge status
MRV status
Supplier/funder
Maqasid/Mizan principle

Centre panel

Interactive relationship graph with nodes and links.

Right panel

Selected node details

Summary
Linked evidence
Risks
Next action
Evidence quality
No Harm Gate status
Human approval status

Bottom panel

Process improvement recommendations and missing link alerts.

Graph Filters

CountryRegionSectorAsset typeProjectOrganisationSupplierFunderRisk typePlaybookEvidence typeEvidence qualityMRV statusBadge statusPublic statusMaqasid principleMizan principleNo Harm Gate status

Microsoft / GraphRAG Integration

Microsoft GraphRAG concept for relationship-based retrieval
Microsoft Fabric for graph metadata and analytics
Power BI for relationship dashboards
Azure Digital Twins for asset relationships
Azure AI Search for evidence retrieval
SharePoint/Data Room for document links
Teams for missing-link and approval alerts
Power Automate for graph-triggered workflows

Use careful wording: "can use" / "designed to integrate with", not "already certified".

AI Agent Integration

EcoIQ agents can use the graph to:

Retrieve only relevant evidence
Avoid unsupported claims
Find missing links
Trace recommendations to sources
Identify next best action
Detect duplicate projects/assets
Route reviews to the right expert
Build investor memos with evidence trace
Generate public summaries only from approved nodes

Amanah Autopilot for Knowledge Graph

Amanah Autopilot can run overnight and:

Find orphan evidence
Detect broken claim traces
Flag public summaries without approvals
Identify projects one step away from Finance Ready
Identify MRV claims missing after-data
Suggest supplier/funder links
Detect duplicate assets
Prepare graph health briefing

Morning graph briefing example: "Overnight, EcoIQ found 6 orphan evidence files, 3 public claims without full trace, 4 projects one link away from Finance Ready and 2 duplicate asset records requiring review."

No Harm Gate for Knowledge Graph

Before using graph outputs externally, check:

Is every claim linked to evidence?
Is every public claim approved?
Are sensitive nodes hidden from public view?
Are supplier/funder links approved?
Are Maqasid/Mizan links reviewed where needed?
Are MRV claims verified or labelled estimated?
Are weak evidence paths clearly marked?
Are graph relationships current and not stale?
Is human approval required before action?
Can the user trace every recommendation?

Safety and Governance

The Knowledge Graph is an explainability and relationship-mapping layer, not a replacement for technical, financial, legal, environmental or religious review.
Graph relationships must be evidence-backed and permissioned.
Public graph views must hide sensitive data.
AI-generated links should be treated as draft until verified where needed.
MRV and impact claims require evidence and approval.
Maqasid/Mizan is ethical decision-support, not a fatwa.
Do not infer relationships that are not supported by evidence.