How mohammadforoutan/url-shortener-nestjs works
This is a NestJS URL-shortening service. Its principal workflow is authenticated URL creation or update, persistence, and public short-link resolution; a parallel workflow handles registration, login, and email verification. The graph captures the visible HTTP-to-use-case calls and sampled TypeORM transaction flow. Analytics/reporting is described in the README, but the supplied tree contains no corresponding analytics implementation, so it is not modeled as a runtime component. Other use-case-to-port wiring is left unverified where source excerpts do not show it.
Main entry points: typeorm-user.repository.ts User repository · typeorm-database.module.ts TypeORM module · typeorm-url.repository.ts URL repository · user User use cases
Components 19
HTTP API
- HTTP module
src/infra/api/http/http.module.ts - URL controller
src/infra/api/http/v1/url.controller.ts - Auth controller
src/infra/api/http/v1/auth.controller.ts
Application workflows
- URL use cases
src/application/usecases/url - User use cases
src/application/usecases/user - URL repository port
src/application/ports/url.repository.ts - User repository port
src/application/ports/user.repository.ts
Domain model
- URL aggregate
src/domain/url/entities/url.ts - User aggregate
src/domain/user/entities/user.ts
Infrastructure
- Nest bootstrap
src/main.ts - Root module
src/app.module.ts - TypeORM module
src/infra/persistence/database/typeorm/typeorm-database.module.ts - URL repository
src/infra/persistence/database/typeorm/repositories/typeorm-url.repository.ts - User repository
src/infra/persistence/database/typeorm/repositories/typeorm-user.repository.ts - Transaction manager
src/infra/persistence/database/typeorm/unit-of-work/unit-of-work.service.ts - ORM entities
src/infra/persistence/database/typeorm/entities - Email adapter
src/infra/adaptors/email.service.ts
Other components
- API client
- PostgreSQL
Connections 16
- API client → Nest bootstrap: sends requests
src/main.ts - Nest bootstrap → Root module: creates app
src/main.ts - Root module → HTTP module: imports infrastructure
src/app.module.ts - URL controller → URL use cases: executes
src/infra/api/http/v1/url.controller.ts - Auth controller → User use cases: executes
src/infra/api/http/v1/auth.controller.ts - URL use cases → URL repository port: uses
- User use cases → User repository port: uses
- URL repository → Transaction manager: runs transactions
src/infra/persistence/database/typeorm/repositories/typeorm-url.repository.ts - User repository → Transaction manager: runs transactions
src/infra/persistence/database/typeorm/repositories/typeorm-user.repository.ts - User repository → ORM entities: queries and saves
src/infra/persistence/database/typeorm/repositories/typeorm-user.repository.ts - TypeORM module → URL repository: binds repository
src/infra/persistence/database/typeorm/typeorm-database.module.ts - TypeORM module → User repository: binds repository
src/infra/persistence/database/typeorm/typeorm-database.module.ts - TypeORM module → PostgreSQL: connects to
src/infra/persistence/database/typeorm/typeorm-database.module.ts - URL repository → URL aggregate: maps domain
- User repository → User aggregate: maps domain
src/infra/persistence/database/typeorm/repositories/typeorm-user.repository.ts - Email adapter → User use cases: sends verification