How autodatabases/autocatalogs works
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: CatalogService.mjs Catalog service · server.js HTTP routes · CatalogProvider.mjs Catalog provider · MainRepository.mjs Catalog repository
Components 23
API and jobs
- HTTP routes
server.js - Catalog read use cases
src/usecases - Heartbeat use case
src/usecases/HeartbeatUsecases.mjs - API responses
src/responses/Response.mjs - Heartbeat response
src/responses/HeartbeatResponse.mjs
Catalog processing
- Catalog updater
src/usecases/UpdateCatalogs.mjs - Catalog service
src/services/CatalogService.mjs - Catalog provider
src/providers/CatalogProvider.mjs - Catalog adapter
src/adapters/CatalogAdapter.mjs - Manufacturer mapper
src/mappers/ManufacturerMapper.mjs - Model mapper
src/mappers/ModelMapper.mjs - Modification mapper
src/mappers/ModificationMapper.mjs - Cyrillic translator
libs/cyrillicToTranslate.mjs
Persistence
- Catalog repository
src/repositories/MainRepository.mjs - Catalog repositories
src/repositories - Repository base
src/repositories/Repository.mjs - Prisma database
libs/prisma.mjs
Runtime wiring
- Application container
src/Application.mjs - Dependency registry
src/container.mjs - Catalog source stubs
src/stubs/server
Other components
- API client
- Catalog refresh job
- Avito catalog
Connections 24
- API client → HTTP routes: requests
server.js - HTTP routes → Catalog read use cases: routes to
server.js - HTTP routes → Heartbeat use case: routes to
server.js - HTTP routes → API responses: wraps results
server.js - HTTP routes → Heartbeat response: wraps heartbeat
server.js - Catalog refresh job → Catalog updater: invokes
- Catalog updater → Catalog service
- Catalog service → Catalog provider: loads data
src/services/CatalogService.mjs - Catalog provider → Avito catalog: fetches catalog
src/providers/CatalogProvider.mjs - Catalog provider → Catalog adapter: converts data
src/providers/CatalogProvider.mjs - Catalog service → Manufacturer mapper: maps manufacturers
src/services/CatalogService.mjs - Catalog service → Model mapper: maps models
src/services/CatalogService.mjs - Catalog service → Modification mapper: maps modifications
src/services/CatalogService.mjs - Manufacturer mapper → Cyrillic translator: transliterates
src/mappers/ManufacturerMapper.mjs - Model mapper → Cyrillic translator: transliterates
src/mappers/ModelMapper.mjs - Catalog service → Catalog repository: reads and updates
src/services/CatalogService.mjs - Catalog repository → Catalog repositories: delegates writes
src/repositories/MainRepository.mjs - Catalog repository → Prisma database: transacts writes
src/repositories/MainRepository.mjs - Catalog repositories → Repository base: extends
src/repositories/BodyRepository.mjs - Repository base → Prisma database: queries
src/repositories/Repository.mjs - Application container → Dependency registry: registers services
src/Application.mjs - Dependency registry → Catalog service: registers
src/container.mjs - Dependency registry → Catalog provider: registers
src/container.mjs - Catalog refresh job → Catalog source stubs: selects source