# leoincode/api-solid-clean_architecture-tdd-ddd architecture

> Architecture diagram of the GitHub repository leoincode/api-solid-clean_architecture-tdd-ddd, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leoincode/api-solid-clean_architecture-tdd-ddd
- Repository: https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd

## Overview

##### Project type and purpose
- This is a backend API application built with Node.js and TypeScript following Clean Architecture, SOLID principles, Domain-Driven Design (DDD) and Test-Driven Development (TDD).
- It exposes both REST endpoints (Express) and GraphQL (Apollo Server) for user signup, authentication, survey creation, listing, answering, and result retrieval.
- It uses MongoDB as the primary datastore, JWT for auth, bcrypt for hashing, plus Swagger for REST docs.

##### File structure
- src/main: entry point, configuration, adapters (Express, Apollo), route & middleware setup, Swagger, GraphQL type-defs, resolvers, factories.
- src/presentation: HTTP controllers, error handling, request/response helpers, middlewares.
- src/validation: validation protocol + concrete validators.
- src/domain: core models & use-case interfaces.
- src/data: use-case implementations coordinating domain use-cases with repository protocols.
- src/infra: concrete implementations of cryptography (bcrypt, JWT), MongoDB repos, email validator adapter.
- tests: unit & integration tests for each layer.
- config files: Docker (docker-compose.yml), Jest, ESLint, TSConfig.

##### Examining README for additional insights
- Emphasis on decoupling via interfaces, layered approach: presentation → domain → data → infra.
- Heavily uses Factory, Adapter, Decorator patterns, DI via composition roots (factories).
- Two API flavors: REST and GraphQL share the same use-cases.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Clients
    subgraph "Clients"
        direction TB
        RESTClients["REST Clients"]:::clients
        GraphQLClients["GraphQL Clients"]:::clients
    end

    %% API Gateway Layer
    subgraph "API Gateway" 
        direction TB
        ExpressServer["Express Server"]:::gateway
        ApolloServer["Apollo Server"]:::gateway
        GlobalMiddlewares["Global Middlewares"]:::gateway
        RoutesConfig["REST Routes Config"]:::gateway
        SwaggerSetup["Swagger Setup"]:::gateway
        GraphQLTypeDefs["GraphQL Type Definitions"]:::gateway
        GraphQLResolvers["GraphQL Resolvers"]:::gateway
        AuthDirective["GraphQL Auth Directive"]:::gateway
        ExpressAdapter["Express Route Adapter"]:::gateway
        ApolloAdapter["Apollo Resolver Adapter"]:::gateway
    end

    %% Presentation Layer
    subgraph "Presentation Layer" 
        direction TB
        PresentationControllers["Controllers"]:::presentation
        PresentationMiddlewares["Presentation Middlewares"]:::presentation
        HTTPHelpers["HTTP Helpers & Protocols"]:::presentation
        ProtocolsPresentation["Protocols"]:::presentation
    end

    %% Validation Layer
    subgraph "Validation" 
        direction TB
        ValidationProtocols["Validation Protocols"]:::validation
        Validators["Validators"]:::validation
        ValidationFactories["Validation Factories"]:::validation
    end

    %% Factories / Composition Root
    subgraph "Factories" 
        direction TB
        ControllerFactories["Controller Factories"]:::factory
        MiddlewareFactory["Middleware Factories"]:::factory
        UsecaseFactories["Use-Case Factories"]:::factory
        LogDecorator["Controller Decorator (Logging)"]:::factory
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        DomainModels["Domain Models"]:::domain
        DomainUsecases["Use-Case Interfaces"]:::domain
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        DataUsecases["Use-Case Implementations"]:::data
        RepoProtocols["Repository Protocols"]:::data
        CryptoProtocols["Cryptography Protocols"]:::data
        ErrorRepoProtocol["Error Logging Protocol"]:::data
    end

    %% Infra Layer
    subgraph "Infra Layer"
        direction TB
        InfraCrypto["Crypto Adapters (bcrypt, JWT)"]:::infra
        MongoInfra["MongoDB Repos"]:::infra
        MongoHelper["MongoHelper"]:::infra
        EmailValidator["Email Validator Adapter"]:::infra
        ErrorMongoRepo["Error Mongo Repository"]:::infra
    end

    %% Database
    MongoDB[(MongoDB)]:::database
    DockerCompose[("docker-compose.yml")]:::infrastructure

    %% Connections
    RESTClients -->|"HTTP Request"| ExpressServer
    GraphQLClients -->|"GraphQL Query"| ApolloServer
    ExpressServer --> GlobalMiddlewares
    ExpressServer --> RoutesConfig
    ExpressServer --> SwaggerSetup
    ApolloServer --> GlobalMiddlewares
    ApolloServer --> GraphQLTypeDefs
    ApolloServer --> GraphQLResolvers
    ApolloServer --> AuthDirective
    RoutesConfig --> ExpressAdapter
    GraphQLResolvers --> ApolloAdapter

    ExpressAdapter --> ControllerFactories
    ApolloAdapter --> ControllerFactories
    GlobalMiddlewares --> MiddlewareFactory
    ControllerFactories --> ValidationFactories
    ControllerFactories --> PresentationControllers
    MiddlewareFactory --> PresentationMiddlewares
    ValidationFactories --> ValidationProtocols
    ValidationFactories --> Validators

    PresentationControllers --> HTTPHelpers
    PresentationControllers --> ProtocolsPresentation
    PresentationControllers --> UsecaseFactories
    PresentationMiddlewares --> UsecaseFactories

    UsecaseFactories --> DomainUsecases
    UsecaseFactories --> RepoProtocols
    UsecaseFactories --> CryptoProtocols
    UsecaseFactories --> ErrorRepoProtocol
    LogDecorator --> PresentationControllers

    DomainUsecases --> DomainModels

    DataUsecases --> DomainUsecases
    DataUsecases --> RepoProtocols
    DataUsecases --> CryptoProtocols
    DataUsecases --> ErrorRepoProtocol

    RepoProtocols --> MongoInfra
    CryptoProtocols --> InfraCrypto
    ErrorRepoProtocol --> ErrorMongoRepo

    MongoInfra --> MongoHelper
    MongoInfra --> MongoDB
    MongoHelper --> MongoDB
    ErrorMongoRepo --> MongoDB
    DockerCompose --> MongoDB

    %% Click Events
    click ExpressServer "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/server.ts"
    click ApolloServer "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/graphql/apollo/apollo-server.ts"
    click GlobalMiddlewares "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/config/middlewares.ts"
    click RoutesConfig "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/config/routes.ts"
    click SwaggerSetup "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/config/swagger.ts"
    click GraphQLTypeDefs "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/graphql/type-defs/*.ts"
    click GraphQLResolvers "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/graphql/resolvers/*.ts"
    click AuthDirective "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/graphql/directives/auth-directive.ts"
    click ExpressAdapter "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/adapters/express-route-adapter.ts"
    click ApolloAdapter "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/adapters/apollo-server-resolver-adapter.ts"
    click LogDecorator "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/decorators/log-controller-decorator.ts"
    click ControllerFactories "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/factories/controllers/*.ts"
    click MiddlewareFactory "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/factories/middlewares/auth-middleware-factory.ts"
    click UsecaseFactories "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/factories/usecases/*.ts"
    click PresentationControllers "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/presentation/controllers/*.ts"
    click PresentationMiddlewares "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/presentation/middlewares/auth-middleware.ts"
    click HTTPHelpers "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/presentation/helpers/http-helper.ts"
    click ProtocolsPresentation "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/presentation/protocols/*.ts"
    click ValidationProtocols "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/validation/protocols/*.ts"
    click Validators "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/validation/validators/*.ts"
    click ValidationFactories "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/main/factories/controllers/*-validation-factory.ts"
    click DomainModels "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/domain/models/*.ts"
    click DomainUsecases "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/domain/usecases/*.ts"
    click DataUsecases "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/data/usecases/*.ts"
    click RepoProtocols "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/data/protocols/db/**/*.ts"
    click CryptoProtocols "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/data/protocols/criptography/*.ts"
    click InfraCrypto "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/infra/criptography/*.ts"
    click MongoInfra "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/infra/db/mongodb/*.ts"
    click MongoHelper "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/infra/db/mongodb/mongo-helper.ts"
    click EmailValidator "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/infra/validators/email-validator-adapter.ts"
    click ErrorRepoProtocol "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/data/protocols/db/log/log-error-repository.ts"
    click ErrorMongoRepo "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/src/infra/db/mongodb/log-mongo-repository.ts"
    click DockerCompose "https://github.com/leoincode/api-solid-clean_architecture-tdd-ddd/blob/main/docker-compose.yml"

    %% Styles
    classDef clients fill:#d3d3d3,stroke:#999,stroke-width:1px
    classDef gateway fill:#add8e6,stroke:#555,stroke-width:1px
    classDef presentation fill:#87cefa,stroke:#333,stroke-width:1px
    classDef validation fill:#b0e0e6,stroke:#333,stroke-width:1px
    classDef factory fill:#ffe4b5,stroke:#cc8e35,stroke-width:1px
    classDef domain fill:#98fb98,stroke:#2e8b57,stroke-width:1px
    classDef data fill:#ffa500,stroke:#cc8400,stroke-width:1px
    classDef infra fill:#ffff66,stroke:#cccc00,stroke-width:1px
    classDef database fill:#f0e68c,stroke:#bdb76b,stroke-width:1px
    classDef infrastructure fill:#f5f5f5,stroke:#aaa,stroke-width:1px
```
