# ulugbek-abdimurodov/certifind architecture

> Architecture diagram of the GitHub repository ulugbek-abdimurodov/certifind, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ulugbek-abdimurodov/certifind
- Repository: https://github.com/ulugbek-abdimurodov/certifind

## Overview

CertiFind helps Italian businesses find certification bodies whose current accredited scopes cover a requested ISO standard and EA sector. The main workflow runs from the search interface through the Spring API’s sector resolution and valid-scope matching to result cards; users can also browse all bodies and inspect scoped details. CSV datasets are imported into PostgreSQL rather than scraped at runtime. The graph includes the documented frontend features and importer; some importer internals and UI calls were not excerpted, so those links rely on README statements or are omitted.

Main entry points: [`app/page.tsx`](https://github.com/ulugbek-abdimurodov/certifind/blob/main/app/page.tsx) (Search page), [`backend/src/main/java/com/certifind/service/SearchService.java`](https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/service/SearchService.java) (Search and directory), [`backend/src/main/java/com/certifind/importer/DatasetReader.java`](https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/importer/DatasetReader.java) (Dataset reader), [`backend/src/main/java/com/certifind/repository`](https://github.com/ulugbek-abdimurodov/certifind/tree/main/backend/src/main/java/com/certifind/repository) (Search repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Search interface"]
  node_next_page["Search page<br/>[page.tsx]"]
  node_search_form["Search form<br/>[SearchForm.tsx]"]
  node_workflow["Progress stages<br/>[Workflow.tsx]"]
  node_results["Results and filters<br/>[ResultsSection.tsx]"]
  node_detail["Body detail drawer"]
  node_frontend_data["Search data helpers<br/>[search-data.ts]"]
  node_frontend_types["Search data types<br/>[search-types.ts]"]
end

subgraph group_api["Search API"]
  node_controller["Search endpoints"]
  node_search_service["Search and directory<br/>[SearchService.java]"]
  node_keyword_resolution["Sector keyword matching"]
  node_response_dtos["Search response DTOs"]
end

subgraph group_data["Accreditation data"]
  node_repositories["Search repositories"]
  node_domain["Accreditation domain"]
  node_postgres[("PostgreSQL")]
end

subgraph group_import["Dataset import"]
  node_csv_datasets["CSV datasets"]
  node_dataset_reader["Dataset reader<br/>[DatasetReader.java]"]
  node_csv_importer["CSV importer<br/>[CsvImporter.java]"]
  node_dataset_model["Dataset model<br/>[Dataset.java]"]
  node_import_runner["Import runner<br/>[ImportRunner.java]"]
end

node_business(("Business user"))

node_business -->|"searches"| node_next_page
node_next_page -->|"collects input"| node_search_form
node_next_page -->|"shows progress"| node_workflow
node_next_page -->|"renders results"| node_results
node_next_page -->|"opens details"| node_detail
node_search_form -->|"uses presets"| node_frontend_data
node_results -->|"filters and formats"| node_frontend_data
node_detail -->|"formats details"| node_frontend_data
node_next_page -->|"requests API"| node_controller
node_controller -->|"delegates"| node_search_service
node_search_service -->|"resolves sector text"| node_keyword_resolution
node_search_service -->|"queries valid scopes"| node_repositories
node_search_service -->|"builds responses"| node_response_dtos
node_repositories -->|"queries entities"| node_domain
node_repositories -.->|"reads and writes"| node_postgres
node_csv_datasets -->|"reads files"| node_dataset_reader
node_dataset_reader -->|"creates dataset"| node_dataset_model
node_dataset_reader -.->|"supplies dataset"| node_csv_importer
node_import_runner -.->|"loads datasets"| node_dataset_reader
node_csv_importer -->|"imports records"| node_domain
node_csv_importer -.->|"persists records"| node_postgres

click node_next_page "https://github.com/ulugbek-abdimurodov/certifind/blob/main/app/page.tsx"
click node_search_form "https://github.com/ulugbek-abdimurodov/certifind/blob/main/components/SearchForm.tsx"
click node_workflow "https://github.com/ulugbek-abdimurodov/certifind/blob/main/components/Workflow.tsx"
click node_results "https://github.com/ulugbek-abdimurodov/certifind/blob/main/components/ResultsSection.tsx"
click node_detail "https://github.com/ulugbek-abdimurodov/certifind/blob/main/components/OrganizationDrawer.tsx"
click node_frontend_data "https://github.com/ulugbek-abdimurodov/certifind/blob/main/app/search-data.ts"
click node_frontend_types "https://github.com/ulugbek-abdimurodov/certifind/blob/main/app/search-types.ts"
click node_controller "https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/controller/SearchController.java"
click node_search_service "https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/service/SearchService.java"
click node_keyword_resolution "https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/repository/SectorKeywordRepository.java"
click node_repositories "https://github.com/ulugbek-abdimurodov/certifind/tree/main/backend/src/main/java/com/certifind/repository"
click node_domain "https://github.com/ulugbek-abdimurodov/certifind/tree/main/backend/src/main/java/com/certifind/domain"
click node_response_dtos "https://github.com/ulugbek-abdimurodov/certifind/tree/main/backend/src/main/java/com/certifind/dto"
click node_dataset_reader "https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/importer/DatasetReader.java"
click node_csv_importer "https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/importer/CsvImporter.java"
click node_dataset_model "https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/importer/Dataset.java"
click node_import_runner "https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/importer/ImportRunner.java"

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_next_page,node_search_form,node_workflow,node_results,node_detail,node_frontend_data,node_frontend_types,node_business toneBlue
class node_controller,node_search_service,node_keyword_resolution,node_response_dtos toneAmber
class node_repositories,node_domain,node_postgres toneMint
class node_csv_datasets,node_dataset_reader,node_csv_importer,node_dataset_model,node_import_runner toneRose
```

## Components

### Search interface

- [Search page](https://github.com/ulugbek-abdimurodov/certifind/blob/main/app/page.tsx): `app/page.tsx`
- [Search form](https://github.com/ulugbek-abdimurodov/certifind/blob/main/components/SearchForm.tsx): `components/SearchForm.tsx`
- [Progress stages](https://github.com/ulugbek-abdimurodov/certifind/blob/main/components/Workflow.tsx): `components/Workflow.tsx`
- [Results and filters](https://github.com/ulugbek-abdimurodov/certifind/blob/main/components/ResultsSection.tsx): `components/ResultsSection.tsx`
- [Body detail drawer](https://github.com/ulugbek-abdimurodov/certifind/blob/main/components/OrganizationDrawer.tsx): `components/OrganizationDrawer.tsx`
- [Search data helpers](https://github.com/ulugbek-abdimurodov/certifind/blob/main/app/search-data.ts): `app/search-data.ts`
- [Search data types](https://github.com/ulugbek-abdimurodov/certifind/blob/main/app/search-types.ts): `app/search-types.ts`

### Search API

- [Search endpoints](https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/controller/SearchController.java): `backend/src/main/java/com/certifind/controller/SearchController.java`
- [Search and directory](https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/service/SearchService.java): `backend/src/main/java/com/certifind/service/SearchService.java`
- [Sector keyword matching](https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/repository/SectorKeywordRepository.java): `backend/src/main/java/com/certifind/repository/SectorKeywordRepository.java`
- [Search response DTOs](https://github.com/ulugbek-abdimurodov/certifind/tree/main/backend/src/main/java/com/certifind/dto): `backend/src/main/java/com/certifind/dto`

### Accreditation data

- [Search repositories](https://github.com/ulugbek-abdimurodov/certifind/tree/main/backend/src/main/java/com/certifind/repository): `backend/src/main/java/com/certifind/repository`
- [Accreditation domain](https://github.com/ulugbek-abdimurodov/certifind/tree/main/backend/src/main/java/com/certifind/domain): `backend/src/main/java/com/certifind/domain`
- **PostgreSQL**

### Dataset import

- **CSV datasets**
- [Dataset reader](https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/importer/DatasetReader.java): `backend/src/main/java/com/certifind/importer/DatasetReader.java`
- [CSV importer](https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/importer/CsvImporter.java): `backend/src/main/java/com/certifind/importer/CsvImporter.java`
- [Dataset model](https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/importer/Dataset.java): `backend/src/main/java/com/certifind/importer/Dataset.java`
- [Import runner](https://github.com/ulugbek-abdimurodov/certifind/blob/main/backend/src/main/java/com/certifind/importer/ImportRunner.java): `backend/src/main/java/com/certifind/importer/ImportRunner.java`

### Other components

- **Business user**

## Connections

- Business user → Search page: searches
- Search page → Search form: collects input (evidence: `app/page.tsx`)
- Search page → Progress stages: shows progress (evidence: `app/page.tsx`)
- Search page → Results and filters: renders results (evidence: `app/page.tsx`)
- Search page → Body detail drawer: opens details (evidence: `app/page.tsx`)
- Search form → Search data helpers: uses presets (evidence: `components/SearchForm.tsx`)
- Results and filters → Search data helpers: filters and formats (evidence: `components/ResultsSection.tsx`)
- Body detail drawer → Search data helpers: formats details (evidence: `components/OrganizationDrawer.tsx`)
- Search page → Search endpoints: requests API
- Search endpoints → Search and directory: delegates (evidence: `backend/src/main/java/com/certifind/controller/SearchController.java`)
- Search and directory → Sector keyword matching: resolves sector text (evidence: `backend/src/main/java/com/certifind/service/SearchService.java`)
- Search and directory → Search repositories: queries valid scopes (evidence: `backend/src/main/java/com/certifind/service/SearchService.java`)
- Search and directory → Search response DTOs: builds responses (evidence: `backend/src/main/java/com/certifind/service/SearchService.java`)
- Search repositories → Accreditation domain: queries entities (evidence: `backend/src/main/java/com/certifind/repository/AccreditedScopeRepository.java`)
- Search repositories → PostgreSQL: reads and writes
- CSV datasets → Dataset reader: reads files
- Dataset reader → Dataset model: creates dataset (evidence: `backend/src/main/java/com/certifind/importer/DatasetReader.java`)
- Dataset reader → CSV importer: supplies dataset
- Import runner → Dataset reader: loads datasets
- CSV importer → Accreditation domain: imports records (evidence: `backend/src/main/java/com/certifind/importer/CsvImporter.java`)
- CSV importer → PostgreSQL: persists records
