# sharjeel-193/double-materiality-assessment-tool architecture

> Architecture diagram of the GitHub repository sharjeel-193/double-materiality-assessment-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sharjeel-193/double-materiality-assessment-tool
- Repository: https://github.com/sharjeel-193/double-materiality-assessment-tool

## Overview

This repository implements a sustainability/materiality assessment product: users work in a Next.js dashboard while a NestJS GraphQL backend manages company reports, assessment inputs, stakeholder ratings, and calculated report metrics. The frontend’s Apollo client targets the backend’s GraphQL endpoint and attaches an in-memory bearer token. Backend service excerpts show direct Prisma access for report, context, stakeholder, financial-effect, and submission operations. The README is empty, and many resolvers and UI integrations were not sampled, so uncertain component-to-component workflow links are omitted.

Main entry points: [`nest-backend/src/prisma/prisma.service.ts`](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/prisma/prisma.service.ts) (Prisma data access), [`next-frontend/src/app/(dashboard)/dashboard/page.tsx`](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/app/(dashboard)/dashboard/page.tsx) (Dashboard and pages), [`next-frontend/src/graphql/apollo-client.ts`](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/graphql/apollo-client.ts) (GraphQL client), [`nest-backend/src/report/report.service.ts`](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/report/report.service.ts) (Reports and metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_web["Dashboard and pages<br/>[page.tsx]"]
  node_assessment_views["Assessment views"]
  node_report_state["Report state"]
  node_apollo["GraphQL client<br/>[apollo-client.ts]"]
end

subgraph group_backend["Assessment backend"]
  node_graphql_api{{"GraphQL API<br/>[app.module.ts]"}}
  node_reports["Reports and metrics<br/>[report.service.ts]"]
  node_company["Company records"]
  node_context["Company context<br/>[context.service.ts]"]
  node_activities["Activities"]
  node_stakeholders["Stakeholders"]
  node_topics["Topics and standards"]
  node_impacts["Impact assessment"]
  node_financial_effects["Financial effects"]
  node_stakeholder_submissions["Stakeholder ratings"]
  node_user_submissions["Internal ratings"]
end

subgraph group_identity["Identity and access"]
  node_token["Token service<br/>[tokenService.ts]"]
  node_auth["Authentication<br/>[auth.service.ts]"]
end

subgraph group_persistence["Persistence"]
  node_prisma["Prisma data access<br/>[prisma.service.ts]"]
  node_database[("Application database")]
end

node_user(("Assessment user"))

node_user -.->|"uses"| node_web
node_web -.->|"queries"| node_apollo
node_web -.->|"presents"| node_assessment_views
node_web -.->|"selects reports"| node_report_state
node_apollo -->|"reads token"| node_token
node_apollo -->|"sends GraphQL"| node_graphql_api
node_auth -->|"reads users"| node_prisma
node_reports -->|"queries metrics"| node_prisma
node_context -->|"reads and writes"| node_prisma
node_activities -->|"reads and writes"| node_prisma
node_stakeholders -->|"reads and writes"| node_prisma
node_financial_effects -->|"reads and writes"| node_prisma
node_stakeholder_submissions -->|"stores ratings"| node_prisma
node_user_submissions -->|"stores ratings"| node_prisma
node_topics -.->|"accesses topics"| node_prisma
node_impacts -.->|"accesses impacts"| node_prisma
node_company -.->|"accesses companies"| node_prisma
node_prisma -.->|"persists data"| node_database

click node_web "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/app/(dashboard)/dashboard/page.tsx"
click node_assessment_views "https://github.com/sharjeel-193/double-materiality-assessment-tool/tree/master/next-frontend/src/sections/dashboard"
click node_report_state "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/providers/ReportContextProvider.tsx"
click node_apollo "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/graphql/apollo-client.ts"
click node_token "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/auth/tokenService.ts"
click node_graphql_api "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/app.module.ts"
click node_auth "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/auth/auth.service.ts"
click node_reports "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/report/report.service.ts"
click node_company "https://github.com/sharjeel-193/double-materiality-assessment-tool/tree/master/nest-backend/src/company"
click node_context "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/context/context.service.ts"
click node_activities "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/activity/activity.service.ts"
click node_stakeholders "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/stakeholder/stakeholder.service.ts"
click node_topics "https://github.com/sharjeel-193/double-materiality-assessment-tool/tree/master/nest-backend/src/topic"
click node_impacts "https://github.com/sharjeel-193/double-materiality-assessment-tool/tree/master/nest-backend/src/impact"
click node_financial_effects "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/financial-effect/financial-effect.service.ts"
click node_stakeholder_submissions "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/stakeholder-submission/stakeholder-submission.service.ts"
click node_user_submissions "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/user-submission/user-submission.service.ts"
click node_prisma "https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/prisma/prisma.service.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_assessment_views,node_report_state,node_apollo,node_user toneBlue
class node_graphql_api,node_reports,node_company,node_context,node_activities,node_stakeholders,node_topics,node_impacts,node_financial_effects,node_stakeholder_submissions,node_user_submissions toneAmber
class node_token,node_auth toneMint
class node_prisma,node_database toneRose
```

## Components

### Web application

- [Dashboard and pages](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/app/(dashboard)/dashboard/page.tsx): `next-frontend/src/app/(dashboard)/dashboard/page.tsx`
- [Assessment views](https://github.com/sharjeel-193/double-materiality-assessment-tool/tree/master/next-frontend/src/sections/dashboard): `next-frontend/src/sections/dashboard`
- [Report state](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/providers/ReportContextProvider.tsx): `next-frontend/src/providers/ReportContextProvider.tsx`
- [GraphQL client](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/graphql/apollo-client.ts): `next-frontend/src/graphql/apollo-client.ts`

### Assessment backend

- [GraphQL API](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/app.module.ts): `nest-backend/src/app.module.ts`
- [Reports and metrics](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/report/report.service.ts): `nest-backend/src/report/report.service.ts`
- [Company records](https://github.com/sharjeel-193/double-materiality-assessment-tool/tree/master/nest-backend/src/company): `nest-backend/src/company`
- [Company context](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/context/context.service.ts): `nest-backend/src/context/context.service.ts`
- [Activities](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/activity/activity.service.ts): `nest-backend/src/activity/activity.service.ts`
- [Stakeholders](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/stakeholder/stakeholder.service.ts): `nest-backend/src/stakeholder/stakeholder.service.ts`
- [Topics and standards](https://github.com/sharjeel-193/double-materiality-assessment-tool/tree/master/nest-backend/src/topic): `nest-backend/src/topic`
- [Impact assessment](https://github.com/sharjeel-193/double-materiality-assessment-tool/tree/master/nest-backend/src/impact): `nest-backend/src/impact`
- [Financial effects](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/financial-effect/financial-effect.service.ts): `nest-backend/src/financial-effect/financial-effect.service.ts`
- [Stakeholder ratings](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/stakeholder-submission/stakeholder-submission.service.ts): `nest-backend/src/stakeholder-submission/stakeholder-submission.service.ts`
- [Internal ratings](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/user-submission/user-submission.service.ts): `nest-backend/src/user-submission/user-submission.service.ts`

### Identity and access

- [Token service](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/next-frontend/src/auth/tokenService.ts): `next-frontend/src/auth/tokenService.ts`
- [Authentication](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/auth/auth.service.ts): `nest-backend/src/auth/auth.service.ts`

### Persistence

- [Prisma data access](https://github.com/sharjeel-193/double-materiality-assessment-tool/blob/master/nest-backend/src/prisma/prisma.service.ts): `nest-backend/src/prisma/prisma.service.ts`
- **Application database**

### Other components

- **Assessment user**

## Connections

- Assessment user → Dashboard and pages: uses
- Dashboard and pages → GraphQL client: queries
- Dashboard and pages → Assessment views: presents
- Dashboard and pages → Report state: selects reports
- GraphQL client → Token service: reads token (evidence: `next-frontend/src/graphql/apollo-client.ts`)
- GraphQL client → GraphQL API: sends GraphQL (evidence: `next-frontend/src/graphql/apollo-client.ts`)
- Authentication → Prisma data access: reads users (evidence: `nest-backend/src/auth/auth.service.ts`)
- Reports and metrics → Prisma data access: queries metrics (evidence: `nest-backend/src/report/report.service.ts`)
- Company context → Prisma data access: reads and writes (evidence: `nest-backend/src/context/context.service.ts`)
- Activities → Prisma data access: reads and writes (evidence: `nest-backend/src/activity/activity.service.ts`)
- Stakeholders → Prisma data access: reads and writes (evidence: `nest-backend/src/stakeholder/stakeholder.service.ts`)
- Financial effects → Prisma data access: reads and writes (evidence: `nest-backend/src/financial-effect/financial-effect.service.ts`)
- Stakeholder ratings → Prisma data access: stores ratings (evidence: `nest-backend/src/stakeholder-submission/stakeholder-submission.service.ts`)
- Internal ratings → Prisma data access: stores ratings (evidence: `nest-backend/src/user-submission/user-submission.service.ts`)
- Topics and standards → Prisma data access: accesses topics (evidence: `nest-backend/src/topic/topic.service.ts`)
- Impact assessment → Prisma data access: accesses impacts (evidence: `nest-backend/src/impact/impact.service.ts`)
- Company records → Prisma data access: accesses companies
- Prisma data access → Application database: persists data
