# team-promesa/promesa-backend architecture

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

- Interactive diagram: https://gitdiagram.com/team-promesa/promesa-backend
- Repository: https://github.com/team-promesa/promesa-backend

## Overview

##### Project type and purpose
- From the file tree and README we see this is “Promesa-Backend,” a monolithic Spring Boot application that powers Promesa, an art exhibition and sales platform for ceramic artists.
- It exposes a REST API (controllers under src/main/java/com/promesa/promesa/domain/*/api) backed by business logic (service classes) and persisting data to a relational database. It integrates with AWS S3 for image storage and uses OAuth2/JWT for authentication/authorization.

##### File structure
- Top-level artifacts
- build.gradle / gradle wrapper: Java build system
- Dockerfile, scripts/, appspec.yml: packaging and deployment (Docker, CodeDeploy)
- .github/workflows: CI pipelines (build & deploy)
- src/main/java/com/promesa/promesa/common: cross-cutting concerns (exception handlers, advice, configuration for Jackson, CORS, security, Swagger, QueryDSL, S3, OAuth2Service, etc.)
- src/main/java/com/promesa/promesa/domain: 11 subdomains (artist, category, exhibition, home, inquiry, item, itemCategory, member, review, wish) each following the pattern
– api: REST controllers
– application: service layer
– dao: Spring Data repositories
– domain: JPA entities & value types
– dto: request/response objects
– exception: domain-specific errors
– query (in some modules): custom QueryDSL-based repositories
- src/main/java/com/promesa/promesa/security: JWT filters, token provider, refresh tokens, logout, OAuth2 user service
- src/main/resources: multiple profiles (local, test, prod), SQL initialization, static assets
- data/: H2 database files for local testing

##### README for additional insights
- The README is succinct, confirming the purpose: “Promesa – platform for exhibiting & selling ceramic artwork.”

##### Key points
- Cross-cutting and domain-specific components
- Security chain (JWT filter, OAuth2 service, refresh token flow)
- Don’t just show “Backend” – decompose into layers and external dependencies

## Diagram (Mermaid)

```mermaid
flowchart TB
    Client("Client (Web/Mobile)"):::external
    ALB("AWS ALB / API Gateway"):::external
    CI("CI/CD Pipeline\n(GitHub Actions)"):::external
    Docker("Docker Image\n(Dockerfile)"):::external
    CodeDeploy("AWS CodeDeploy"):::external
    OAuth2Prov("External OAuth2 Provider\n(Google/Facebook)"):::external

    Client -->|HTTPS Request| ALB
    ALB -->|Routes to| Backend

    subgraph "Promesa Backend (Spring Boot Monolith)"
        direction TB
        App("PromesaApplication"):::internal
        subgraph "Presentation Layer"
            direction TB
            ArtistCtrl("ArtistController"):::internal
            CategoryCtrl("CategoryController"):::internal
            ExhibitionCtrl("ExhibitionController"):::internal
            HomeCtrl("HomeController"):::internal
            InquiryCtrl("InquiryController"):::internal
            ItemCtrl("ItemController"):::internal
            MemberCtrl("MemberController"):::internal
            ReviewCtrl("ReviewController"):::internal
            WishCtrl("WishController"):::internal
            DevTokenCtrl("DevTokenController"):::internal
            RefreshCtrl("RefreshController"):::internal
            LogoutCtrl("LogoutController"):::internal
        end
        subgraph "Service Layer"
            direction TB
            ArtistSvc("ArtistService"):::internal
            CategorySvc("CategoryService"):::internal
            ExhibitionSvc("ExhibitionService"):::internal
            HomeSvc("HomeService"):::internal
            InquirySvc("InquiryService"):::internal
            ItemSvc("ItemService"):::internal
            ReviewSvc("ReviewService"):::internal
            ReviewImgSvc("ReviewImageService"):::internal
            WishSvc("WishService"):::internal
            S3Svc("S3Service"):::internal
            OAuth2Svc("OAuth2Service"):::internal
            RefreshSvc("RefreshService"):::internal
            LogoutSvc("LogoutService"):::internal
        end
        subgraph "Persistence Layer"
            direction TB
            Repos("Domain Repositories\n(Artist, Category, Exhibition, etc.)"):::internal
            RefreshRepo("RefreshRepository"):::internal
        end
        subgraph "External Integrations"
            direction TB
            S3("AWS S3 Bucket"):::datastore
        end

        App --> ArtistCtrl & CategoryCtrl & ExhibitionCtrl & HomeCtrl & InquiryCtrl & ItemCtrl & MemberCtrl & ReviewCtrl & WishCtrl & DevTokenCtrl & RefreshCtrl & LogoutCtrl
        ArtistCtrl --> ArtistSvc
        CategoryCtrl --> CategorySvc
        ExhibitionCtrl --> ExhibitionSvc
        HomeCtrl --> HomeSvc
        InquiryCtrl --> InquirySvc
        ItemCtrl --> ItemSvc
        MemberCtrl --> InquirySvc
        ReviewCtrl --> ReviewSvc & ReviewImgSvc
        WishCtrl --> WishSvc
        DevTokenCtrl --> OAuth2Svc
        RefreshCtrl --> RefreshSvc
        LogoutCtrl --> LogoutSvc

        ArtistSvc --> Repos
        CategorySvc --> Repos
        ExhibitionSvc --> Repos
        HomeSvc --> Repos
        InquirySvc --> Repos
        ItemSvc --> Repos
        ReviewSvc --> Repos
        WishSvc --> Repos
        RefreshSvc --> RefreshRepo
        LogoutSvc --> RefreshRepo

        S3Svc --> S3
        OAuth2Svc --> OAuth2Prov

    end

    Backend("Promesa Backend"):::internal
    ALB --> Backend
    Backend -->|"JDBC"| Database
    Backend --> S3
    Backend --> OAuth2Prov

    Database("Relational DB\n(PostgreSQL / H2)"):::datastore

    CI --> Docker
    Docker --> CodeDeploy
    CodeDeploy --> Backend

    click App "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/PromesaApplication.java"
    click ArtistCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/artist/api/ArtistController.java"
    click CategoryCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/category/api/CategoryController.java"
    click ExhibitionCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/exhibition/api/ExhibitionController.java"
    click HomeCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/home/api/HomeController.java"
    click InquiryCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/inquiry/api/InquiryController.java"
    click ItemCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/item/api/ItemController.java"
    click MemberCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/member/api/MemberController.java"
    click ReviewCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/review/api/ReviewController.java"
    click WishCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/wish/api/WishController.java"
    click DevTokenCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/security/dev/DevTokenController.java"
    click RefreshCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/security/jwt/refresh/RefreshController.java"
    click LogoutCtrl "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/security/logout/LogoutController.java"

    click ArtistSvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/artist/application/ArtistService.java"
    click CategorySvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/category/application/CategoryService.java"
    click ExhibitionSvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/exhibition/application/ExhibitionService.java"
    click HomeSvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/home/application/HomeService.java"
    click InquirySvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/inquiry/application/InquiryService.java"
    click ItemSvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/item/application/ItemService.java"
    click ReviewSvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/review/application/ReviewService.java"
    click ReviewImgSvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/review/application/ReviewImageService.java"
    click WishSvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/domain/wish/application/WishService.java"
    click S3Svc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/common/application/S3Service.java"
    click OAuth2Svc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/common/application/OAuth2Service.java"
    click RefreshSvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/security/jwt/refresh/RefreshService.java"
    click LogoutSvc "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/security/logout/LogoutService.java"
    click RefreshRepo "https://github.com/team-promesa/promesa-backend/blob/dev/src/main/java/com/promesa/promesa/security/jwt/refresh/RefreshRepository.java"

    classDef internal fill:#DDEEFF,stroke:#222,stroke-width:1px
    classDef external fill:#FFE4B5,stroke:#E66,stroke-width:1px
    classDef datastore fill:#DFF2BF,stroke:#228B22,stroke-width:1px
```
