# autodatabases/autocatalogs architecture

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

- Interactive diagram: https://gitdiagram.com/autodatabases/autocatalogs
- Repository: https://github.com/autodatabases/autocatalogs

## Overview

Autocatalogs is a vehicle-reference catalog service: it exposes lookup and heartbeat endpoints, and refreshes catalog data from Avito into a Prisma-backed database. The documented refresh flow is represented through its provider, mapping, and persistence layers; HTTP routes are shown where server.js names their use cases. Several use cases and runtime wiring files were not excerpted, so uncertain links between them are omitted. The mapper-to-translator relationship is supported by the source index, but its implementation was not sampled.

Main entry points: [`src/services/CatalogService.mjs`](https://github.com/autodatabases/autocatalogs/blob/master/src/services/CatalogService.mjs) (Catalog service), [`server.js`](https://github.com/autodatabases/autocatalogs/blob/master/server.js) (HTTP routes), [`src/providers/CatalogProvider.mjs`](https://github.com/autodatabases/autocatalogs/blob/master/src/providers/CatalogProvider.mjs) (Catalog provider), [`src/repositories/MainRepository.mjs`](https://github.com/autodatabases/autocatalogs/blob/master/src/repositories/MainRepository.mjs) (Catalog repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and jobs"]
  node_httpserver["HTTP routes<br/>[server.js]"]
  node_readcases["Catalog read use cases"]
  node_heartbeat["Heartbeat use case"]
  node_responses["API responses<br/>[Response.mjs]"]
  node_heartbeatresponse["Heartbeat response"]
end

subgraph group_domain["Catalog processing"]
  node_updater["Catalog updater<br/>[UpdateCatalogs.mjs]"]
  node_catalogservice["Catalog service<br/>[CatalogService.mjs]"]
  node_catalogprovider["Catalog provider"]
  node_catalogadapter["Catalog adapter<br/>[CatalogAdapter.mjs]"]
  node_manufacturer_mapper["Manufacturer mapper"]
  node_model_mapper["Model mapper<br/>[ModelMapper.mjs]"]
  node_modification_mapper["Modification mapper"]
  node_translation["Cyrillic translator"]
end

subgraph group_persistence["Persistence"]
  node_mainrepo["Catalog repository<br/>[MainRepository.mjs]"]
  node_repositories["Catalog repositories"]
  node_repositorybase["Repository base<br/>[Repository.mjs]"]
  node_database[("Prisma database<br/>[prisma.mjs]")]
end

subgraph group_runtime["Runtime wiring"]
  node_application["Application container<br/>[Application.mjs]"]
  node_containerconfig["Dependency registry<br/>[container.mjs]"]
  node_catalogstub["Catalog source stubs"]
end

node_consumer(("API client"))
node_refreshjob(("Catalog refresh job"))
node_avito["Avito catalog"]

node_consumer -->|"requests"| node_httpserver
node_httpserver -->|"routes to"| node_readcases
node_httpserver -->|"routes to"| node_heartbeat
node_httpserver -->|"wraps results"| node_responses
node_httpserver -->|"wraps heartbeat"| node_heartbeatresponse
node_refreshjob -->|"invokes"| node_updater
node_updater -.-> node_catalogservice
node_catalogservice -->|"loads data"| node_catalogprovider
node_catalogprovider -->|"fetches catalog"| node_avito
node_catalogprovider -->|"converts data"| node_catalogadapter
node_catalogservice -->|"maps manufacturers"| node_manufacturer_mapper
node_catalogservice -->|"maps models"| node_model_mapper
node_catalogservice -->|"maps modifications"| node_modification_mapper
node_manufacturer_mapper -->|"transliterates"| node_translation
node_model_mapper -->|"transliterates"| node_translation
node_catalogservice -->|"reads and updates"| node_mainrepo
node_mainrepo -->|"delegates writes"| node_repositories
node_mainrepo -->|"transacts writes"| node_database
node_repositories -->|"extends"| node_repositorybase
node_repositorybase -->|"queries"| node_database
node_application -->|"registers services"| node_containerconfig
node_containerconfig -->|"registers"| node_catalogservice
node_containerconfig -->|"registers"| node_catalogprovider
node_refreshjob -->|"selects source"| node_catalogstub

click node_httpserver "https://github.com/autodatabases/autocatalogs/blob/master/server.js"
click node_readcases "https://github.com/autodatabases/autocatalogs/tree/master/src/usecases"
click node_heartbeat "https://github.com/autodatabases/autocatalogs/blob/master/src/usecases/HeartbeatUsecases.mjs"
click node_responses "https://github.com/autodatabases/autocatalogs/blob/master/src/responses/Response.mjs"
click node_heartbeatresponse "https://github.com/autodatabases/autocatalogs/blob/master/src/responses/HeartbeatResponse.mjs"
click node_updater "https://github.com/autodatabases/autocatalogs/blob/master/src/usecases/UpdateCatalogs.mjs"
click node_catalogservice "https://github.com/autodatabases/autocatalogs/blob/master/src/services/CatalogService.mjs"
click node_catalogprovider "https://github.com/autodatabases/autocatalogs/blob/master/src/providers/CatalogProvider.mjs"
click node_catalogadapter "https://github.com/autodatabases/autocatalogs/blob/master/src/adapters/CatalogAdapter.mjs"
click node_manufacturer_mapper "https://github.com/autodatabases/autocatalogs/blob/master/src/mappers/ManufacturerMapper.mjs"
click node_model_mapper "https://github.com/autodatabases/autocatalogs/blob/master/src/mappers/ModelMapper.mjs"
click node_modification_mapper "https://github.com/autodatabases/autocatalogs/blob/master/src/mappers/ModificationMapper.mjs"
click node_translation "https://github.com/autodatabases/autocatalogs/blob/master/libs/cyrillicToTranslate.mjs"
click node_mainrepo "https://github.com/autodatabases/autocatalogs/blob/master/src/repositories/MainRepository.mjs"
click node_repositories "https://github.com/autodatabases/autocatalogs/tree/master/src/repositories"
click node_repositorybase "https://github.com/autodatabases/autocatalogs/blob/master/src/repositories/Repository.mjs"
click node_database "https://github.com/autodatabases/autocatalogs/blob/master/libs/prisma.mjs"
click node_application "https://github.com/autodatabases/autocatalogs/blob/master/src/Application.mjs"
click node_containerconfig "https://github.com/autodatabases/autocatalogs/blob/master/src/container.mjs"
click node_catalogstub "https://github.com/autodatabases/autocatalogs/tree/master/src/stubs/server"

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_httpserver,node_readcases,node_heartbeat,node_responses,node_heartbeatresponse,node_consumer toneBlue
class node_updater,node_catalogservice,node_catalogprovider,node_catalogadapter,node_manufacturer_mapper,node_model_mapper,node_modification_mapper,node_translation toneAmber
class node_mainrepo,node_repositories,node_repositorybase,node_database toneMint
class node_application,node_containerconfig,node_catalogstub toneRose
class node_refreshjob,node_avito toneIndigo
```

## Components

### API and jobs

- [HTTP routes](https://github.com/autodatabases/autocatalogs/blob/master/server.js): `server.js`
- [Catalog read use cases](https://github.com/autodatabases/autocatalogs/tree/master/src/usecases): `src/usecases`
- [Heartbeat use case](https://github.com/autodatabases/autocatalogs/blob/master/src/usecases/HeartbeatUsecases.mjs): `src/usecases/HeartbeatUsecases.mjs`
- [API responses](https://github.com/autodatabases/autocatalogs/blob/master/src/responses/Response.mjs): `src/responses/Response.mjs`
- [Heartbeat response](https://github.com/autodatabases/autocatalogs/blob/master/src/responses/HeartbeatResponse.mjs): `src/responses/HeartbeatResponse.mjs`

### Catalog processing

- [Catalog updater](https://github.com/autodatabases/autocatalogs/blob/master/src/usecases/UpdateCatalogs.mjs): `src/usecases/UpdateCatalogs.mjs`
- [Catalog service](https://github.com/autodatabases/autocatalogs/blob/master/src/services/CatalogService.mjs): `src/services/CatalogService.mjs`
- [Catalog provider](https://github.com/autodatabases/autocatalogs/blob/master/src/providers/CatalogProvider.mjs): `src/providers/CatalogProvider.mjs`
- [Catalog adapter](https://github.com/autodatabases/autocatalogs/blob/master/src/adapters/CatalogAdapter.mjs): `src/adapters/CatalogAdapter.mjs`
- [Manufacturer mapper](https://github.com/autodatabases/autocatalogs/blob/master/src/mappers/ManufacturerMapper.mjs): `src/mappers/ManufacturerMapper.mjs`
- [Model mapper](https://github.com/autodatabases/autocatalogs/blob/master/src/mappers/ModelMapper.mjs): `src/mappers/ModelMapper.mjs`
- [Modification mapper](https://github.com/autodatabases/autocatalogs/blob/master/src/mappers/ModificationMapper.mjs): `src/mappers/ModificationMapper.mjs`
- [Cyrillic translator](https://github.com/autodatabases/autocatalogs/blob/master/libs/cyrillicToTranslate.mjs): `libs/cyrillicToTranslate.mjs`

### Persistence

- [Catalog repository](https://github.com/autodatabases/autocatalogs/blob/master/src/repositories/MainRepository.mjs): `src/repositories/MainRepository.mjs`
- [Catalog repositories](https://github.com/autodatabases/autocatalogs/tree/master/src/repositories): `src/repositories`
- [Repository base](https://github.com/autodatabases/autocatalogs/blob/master/src/repositories/Repository.mjs): `src/repositories/Repository.mjs`
- [Prisma database](https://github.com/autodatabases/autocatalogs/blob/master/libs/prisma.mjs): `libs/prisma.mjs`

### Runtime wiring

- [Application container](https://github.com/autodatabases/autocatalogs/blob/master/src/Application.mjs): `src/Application.mjs`
- [Dependency registry](https://github.com/autodatabases/autocatalogs/blob/master/src/container.mjs): `src/container.mjs`
- [Catalog source stubs](https://github.com/autodatabases/autocatalogs/tree/master/src/stubs/server): `src/stubs/server`

### Other components

- **API client**
- **Catalog refresh job**
- **Avito catalog**

## Connections

- API client → HTTP routes: requests (evidence: `server.js`)
- HTTP routes → Catalog read use cases: routes to (evidence: `server.js`)
- HTTP routes → Heartbeat use case: routes to (evidence: `server.js`)
- HTTP routes → API responses: wraps results (evidence: `server.js`)
- HTTP routes → Heartbeat response: wraps heartbeat (evidence: `server.js`)
- Catalog refresh job → Catalog updater: invokes
- Catalog updater → Catalog service
- Catalog service → Catalog provider: loads data (evidence: `src/services/CatalogService.mjs`)
- Catalog provider → Avito catalog: fetches catalog (evidence: `src/providers/CatalogProvider.mjs`)
- Catalog provider → Catalog adapter: converts data (evidence: `src/providers/CatalogProvider.mjs`)
- Catalog service → Manufacturer mapper: maps manufacturers (evidence: `src/services/CatalogService.mjs`)
- Catalog service → Model mapper: maps models (evidence: `src/services/CatalogService.mjs`)
- Catalog service → Modification mapper: maps modifications (evidence: `src/services/CatalogService.mjs`)
- Manufacturer mapper → Cyrillic translator: transliterates (evidence: `src/mappers/ManufacturerMapper.mjs`)
- Model mapper → Cyrillic translator: transliterates (evidence: `src/mappers/ModelMapper.mjs`)
- Catalog service → Catalog repository: reads and updates (evidence: `src/services/CatalogService.mjs`)
- Catalog repository → Catalog repositories: delegates writes (evidence: `src/repositories/MainRepository.mjs`)
- Catalog repository → Prisma database: transacts writes (evidence: `src/repositories/MainRepository.mjs`)
- Catalog repositories → Repository base: extends (evidence: `src/repositories/BodyRepository.mjs`)
- Repository base → Prisma database: queries (evidence: `src/repositories/Repository.mjs`)
- Application container → Dependency registry: registers services (evidence: `src/Application.mjs`)
- Dependency registry → Catalog service: registers (evidence: `src/container.mjs`)
- Dependency registry → Catalog provider: registers (evidence: `src/container.mjs`)
- Catalog refresh job → Catalog source stubs: selects source
