Skip to content

feat: Initial implementation of Sustainability Atlas (v0.1 beta) - #6413

Open
gayanath8 wants to merge 465 commits into
hashgraph:developfrom
xeptagondev:sustainability_atlas
Open

feat: Initial implementation of Sustainability Atlas (v0.1 beta)#6413
gayanath8 wants to merge 465 commits into
hashgraph:developfrom
xeptagondev:sustainability_atlas

Conversation

@gayanath8

Copy link
Copy Markdown
Contributor

Related Issues: #5815, #5824, #5827, #5823, #5822, #5820, #5818, #5817, #5826, #5831, #5825, #5819

Issue Number Task DOD Work Done
#5815 Build a Business Abstraction Layer for Blockchain Data A complete business entity data model exists with all specified entity types and their attributes.

Blockchain events are automatically translated into business concepts visible to end users.

Data from multiple registries is harmonized into the standardized schema while preserving original values.

Users can view any transaction in business-friendly tabular format showing all required fields.

The lifecycle engine connects all related events for a given project, allowing end-to-end traceability.
Defined and implemented core business entities as Project, Credit Issuance, Methodology, Registry, Organization (Developer) each with human readable attributes (name, country, registry, sector, status, vintage, crediting period, etc.)

Built automatic event to business term translation, shown consistently on the Dashboard, Projects list, and Project lifecycle views

Built a per methodology "Decoded Mapping" engine that harmonizes raw registry specific schema fields into the canonical Project/Issuance schema, applied across all 128 methodologies and 38 registries

Preserved original registry values via "Raw Data" export links on Projects and Issuances, alongside the standardized view

Built a business friendly Issuances table (project, quantity, mint date, registry) and a Project Key Facts panel

Built a "Credit Lifecycle" widget on each Project page (Issued → Transferred → Retired → Active) with a linked Issuances table for traceability

Built an on chain provenance/relationship graph (Registry → Policy → Schema → Raw Data → Token) for end-to-end lifecycle visibility

Apart from these Sustainability Atalas have ability to directly listesning into Guardian event stream and gather those topics directly then trigger the workers to fetch the data instead of waiting
#5824 Introduce a Methodology Explorer A Methodology Explorer section exists in the Indexer with searchable, browsable methodology entries.

Each methodology entry shows its details, version history, and linked projects.
Built a dedicated "Methodologies" section in the main navigation, listing all 128 methodologies with pagination

Implemented search by methodology name plus filters by Registry and Decode Status

Built a Methodology detail page showing Registry, Version, Schema count, Status, and description

Built a Version History tab (version number, on-chain topic, publish date, schema count, status)

Built a Linked Projects tab listing every project using that methodology, with country, registry, issuances, and status

Built a "Compare Versions" action for side-by-side version comparison
#5827 Create Methodology-Specific Dashboards (Priority Methodologies First) Dedicated dashboards exist for a selected set of high usage methodologies.

Dashboards display aggregated project data, issuance statistics, and methodology level insights.

A defined threshold mechanism exists to identify additional methodologies that qualify for dashboards in the future.

Dashboards are accessible from both the Methodology Explorer and project pages.
Built a "Methodology Dashboard" panel with geographic distribution map, issuance trend chart, and vintage distribution chart displayed on every methodology's page

Built an Analytics tab per methodology with project/issuance/schema-count KPIs and a Credit Lifecycle bar

Dashboard is reachable directly from the Methodology Explorer listing (one clicks into any methodology)
#5823 Implement User Identity and Personalization Features User authentication is functional with Guardian integration.

Role-based default views are configured for all defined roles.

Users can save searches, follow items, receive notifications, build custom dashboards, and manage portfolios.
Implemented working authentication with sign-in/sign-out and a session activity log (timestamps, IP address)

Implemented a two-tier role model (Administrator, Registered User) with distinct permissions

Built a User Management console for administrators to create/deactivate users and assign roles

Built self-service API key management for registered users

Implementation of self-service API rate limit increase request workflow, with an admin approval/decline screen

Developed a personalized "My Portfolio" dashboard that enables users to create a dedicated My Portfolio dashboard for personalized project monitoring and to have a watchlist for tracking selected projects.
#5822 Implement Pipeline and Forward Supply View Pipeline projects are visible in the Indexer with milestone tracking.

Filtering by expected issuance year is functional.

Projected volumes are displayed for pipeline projects.
Built a "Pipeline Projects" KPI and a "Project Lifecycle Funnel" (Registered → Validation → Verified → Issuing → Completed) on the project page, giving the platform a working pre-issuance stage model to build on

Existing Status badge component is ready to visually distinguish pipeline stage projects once such projects exist in the dataset
#5820 Implement SDG Framework Standardization A data model maps projects to SDG goals and targets, with methodology-level pre-mapping.

SDG multi-select filtering works across all search and grid views.

SDG-focused dashboard displays aggregated metrics.
Built a dedicated SDGs dashboard page listing all 17 goals with project counts, issuance counts, developer counts, country counts, and a top-contributing methodology per goal

Added an SDGs column and filter to the Projects list, plus a one-click SDG quick-filter chip

Established Project to SDG linkage in the data model (confirmed working for sampled projects)
#5818 Implement Grid, Comparison, and Market Intelligence Views Sortable grids are functional with single and multi-column sorting.

Side-by-side comparison view works for 2 or more selected projects.

Aggregation summaries are available for all specified grouping dimensions.
Implemented working column header sorting (confirmed active on the Registries and Issuances grids)

Implemented pagination with a rows per page selector across every grid (Projects, Issuances, Methodologies, Registries)

Added a row selection checkbox column to the Projects grid

Built aggregation/summary views for Sector (Dashboard donut), SDG (SDGs page), Geography (Analytics Top Countries), Vintage (Dashboard chart), and Methodology (Registry detail donut)
#5817 Build Advanced Search and Filtering Engine Users can search and filter using all specified business attributes with advanced operators.

Progressive (chained) filtering is fully functional.

All filter states are reflected in the URL and can be shared/bookmarked.

Preset search templates are available and functional.
Built a rich filter bar on the Projects list: Status, Registry, Country, Vintage, Sector, Sectoral Scope, Developer, and SDGs, plus a name search box

Built a comparable filter bar on the Issuances list: Token Type, Registry, Mint Amount, Mint Date

Built custom Quick Filters on Projects (e.g., Gold Standard, SDG 13: Climate Action, Vintage 2022, Issuing Energy, Glycol Recycling)

Built a results count in the pagination footer (e.g. "Showing 1–10 of 37")
#5826 Display Hedera Policy References in the Indexer Hedera policy references are displayed for each project and methodology.

Users can verify the on-chain policy via external Hedera explorers.
Built a "Hedera On-Chain References" panel on Project pages: Instance Topic ID, Policy Topic ID, First VC Anchored At date, Registry DID, each with a working "View on HashScan" link

Built an equivalent "Hedera Policy" tab on Methodology pages: Instance Policy Topic, Registry DID, Network, Published At date, and a View on HashScan link

Added a simplified "Verified on Hedera" banner with plain language description, shown alongside the full technical detail on both pages

Built a Project Pipeline section listing a full sequence of dated credential events (not just one timestamp) goes beyond the single timestamp

Added a downloadable policy package (.zip) on the Methodology's Hedera Policy tab for system users
#5831 Build ESG and Compliance Reporting Engine Data exports available in CSV, Excel, and PDF formats

Exported reports include structured ESG fields

Exported reports include verifiable source references

Impact summary can be generated with one click

Disclosure guidance is embedded across the platform

Only verifiable external data sources are supported for imports
Built "Download Data" export buttons on the Projects, Issuances, Methodologies, and Registries list pages

Built a dedicated export toolbar on the Project's Advanced tab with "Export as IWA," "Export as CADTrust," and "Export as CDOP" named exports mapped to specific external compliance/registry formats

Built a pervasive tooltip icon convention on nearly every metric and field label across the Dashboard, Project, and Methodology pages

Implemented a centralized Reports & Export module that enables users to generate configurable ESG data exports in multiple formats such as CSV, Microsoft Excel (XLSX) and PDF.
#5825 Provide Access to Guardian Policies from the Indexer Each project and methodology in the Indexer shows its associated Guardian policy.

Users can navigate to or view the policy details from the project/methodology page.
Built a Methodology page header that prominently displays the policy name, owning registry, and version together

Built a "Policy Flowchart" on the Project's Advanced tab a rendered, in-Indexer visualization of the policy's authored document/action workflow

Added a "Policy JSON" button (Project) and a "Download policy package (.zip)" action (Methodology) for the full underlying policy definition
#5819 Build Dashboards and Market Indicator Views A dashboard view exists with all specified KPI metrics displayed prominently.

Interactive charts are functional for all four visualization types.

YoY trend indicators are displayed alongside metrics.
Built a main Dashboard with 5 prominent KPI cards: Registries, Methodologies, Projects, Total Issuances, Total Retired

Built a Project Distribution map, Sector and Registry breakdown donut charts, and a Top Registries table

Built three interactive charts with Monthly/Quarterly/Yearly toggles: Issuance Trend, Retirement Trend, and Vintage Distribution
#5821 Build MRV Data Ingestion and Analysis Capabilities MRV datasets can be ingested and linked to policies/projects.

A table viewer allows exploration of MRV data with filtering, sorting, and device-level drill-down.

Data lineage from MRV input to credit issuance output is navigable.
MRV data is ingested and tied directly to the project which has specifically provided the MRV Data (e.g., "Glycol Recycling")

A full table viewer lists all dMRV records with columns for End Timestamp, Start Timestamp, Device, and Raw data access.

Filters are available for Device / Measurement Point and Date Range.

Sorting is enabled on both End Timestamp and Start Timestamp columns (toggle arrows).

YathurshanT and others added 30 commits June 15, 2026 11:59
…ects, and registries; update localization for download prompts

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…dologies, projects, and registries

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…ects, and registries; update localization for download prompts
…thodologies

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…atting options

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…visualization and improved vintage distribution metrics

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…page

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
feat: Enhance project service with policy graph and VC evidence retrieval
…ector breakdown in registry details page

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…visualization and improved vintage distribution metrics
Signed-off-by: Gayanath Ranasinghe <121780980+gayanath8@users.noreply.github.com>
…etail page

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
… tooltips

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…ment sorting logic directly

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…state in project data

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…terBar

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
… improve project findAll endpoint

Signed-off-by: gayanath8 <gayanathr@xeptagon.com>
… improve project findAll endpoint

Signed-off-by: gayanath8 <gayanathr@xeptagon.com>
sahanxeptagon and others added 30 commits August 3, 2026 10:52
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
…isplay bug

Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
- Introduced a new utility function for formatting relative time in the frontend.
- Implemented project boundary handling with GeoJSON support in project details.
- Created a new ActivityService to manage network activity fetching and caching.
- Added new API endpoints for retrieving network activity related to projects and general network events.
- Established a new database schema for storing project geometries with full precision.
- Enhanced the project mapper service to upsert project geometries based on incoming data.
- Updated relevant DTOs and repository methods to accommodate new activity types and project geometry.

Signed-off-by: gayanath8 <gayanathr@xeptagon.com>
Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
…edit schema and create date for projects

Signed-off-by: gayanath8 <gayanathr@xeptagon.com>
Signed-off-by: Yathurshan Thurairajah <yathurshant@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
SE-44: fix(i18) - Implement I18 Language Localization
- Introduced new endpoint to fetch distinct filter options for projects, including registries, developers, statuses, sectors, sectoral scopes, vintages, and countries.
- Enhanced ProjectQueryDto to support additional filtering parameters: sector, sectoralScope, vintageRange, methodologyId, lifecycleStage, expectedIssuanceYearRange, and isPipeline.
- Implemented lifecycle stage and expected issuance year calculations in a new materialized view (mv_project_lifecycle) to optimize project listing performance.
- Updated PgProjectRepository to join with the new lifecycle materialized view for efficient filtering and sorting.
- Created indexes on relevant fields in the business view to improve query performance for the new filters.

Signed-off-by: gayanath8 <gayanathr@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
Signed-off-by: Sahan Perera <sahanp@xeptagon.com>
SE-157 - fix(ui): issues on the map and pie chart tooltips
…ized view management

- Improved materialized view refresh logic in mv-refresh.processor.ts to avoid unnecessary drops and recreations, using a hash to track definitions.
- Added export data cap for downloads and warning
- Added Swagger design change and separate admin documentation to avoid clients exposing those urls

Signed-off-by: gayanath8 <gayanathr@xeptagon.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants