# yunusemreerkesikbas/admincraft architecture

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

- Interactive diagram: https://gitdiagram.com/yunusemreerkesikbas/admincraft
- Repository: https://github.com/yunusemreerkesikbas/admincraft

## Overview

##### Project type and purpose
- This is a full-stack CMS/admin dashboard project named AdminCraft.
- The backend is a Spring Boot (Java/Maven) application exposing MVC controllers and REST endpoints.
- The frontend is an Angular application configured for both client-side rendering (CSR) and server-side rendering (SSR via Angular Universal + Express).

##### File structure
Top-level:
- backend/ – Spring Boot service
– src/main/java/com/admincraft/cms – application entrypoint (AdminCraftApplication.java), config (SecurityConfig), generic core (BaseEntity/Repository/Service), exceptions, modules (home)
– src/main/resources – application.yml, Thymeleaf templates (index.html)
– pom.xml, Maven wrapper
- frontend/ – Angular Universal app
– src/app – components, routing (app.routes.ts/server), config (app.config.ts), SSR entrypoints (main.server.ts, server.ts)
– angular.json, package.json
- README.md, roadmap.md

##### README for additional insights
- Minimal README (“# AdminCraft”) – no built-in architecture notes, so we infer from code.

- Break the system into the frontend SSR server, the Angular app (SSR + CSR), the backend service (layered), and the database.
- Interactions, including security filtering and template serving.
- Technologies (e.g., “Spring Security,” “Thymeleaf,” “Angular Router”).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client
    Browser["Browser"]:::client

    %% Frontend Tier
    subgraph "Frontend Tier"
        subgraph "Express SSR Server"
            SSRServer["Frontend Web Server\n(Node/Express SSR)"]:::server
        end
        subgraph "Angular Application"
            SSRModule["SSR Entry Point\n(main.server.ts)"]:::ui
            CSRModule["CSR Entry Point\n(main.ts)"]:::ui
            Components["App Components\n(src/app)"]:::ui
            RoutingClient["Client Routing\n(app.routes.ts)"]:::ui
            RoutingServer["Server Routing\n(app.routes.server.ts)"]:::ui
            ConfigClient["Client Config\n(app.config.ts)"]:::config
            ConfigServer["Server Config\n(app.config.server.ts)"]:::config
        end
        StaticAssets["Static Assets & Styles"]:::storage
        BuildFrontend["Build Config\n(angular.json, package.json)"]:::config
    end

    %% Backend Tier
    subgraph "Backend Tier"
        SpringApp["Spring Boot Application\n(AdminCraftApplication.java)"]:::server
        Security["Security Config\n(SecurityConfig.java)"]:::config
        Controller["HomeController\n(module/home)"]:::backend
        Service["Generic Service\n(BaseService.java)"]:::backend
        Repository["Generic Repository\n(BaseRepository.java)"]:::backend
        Entity["Generic Entity\n(BaseEntity.java)"]:::backend
        Exception["Exception Handling\n(ResourceNotFoundException.java)"]:::backend
        DB["Database\n(RDBMS)"]:::database
        Templates["Thymeleaf Templates\n(index.html)"]:::storage
        AppConfig["Application Config\n(application.yml)"]:::config
        BuildBackend["Build Config\n(pom.xml, maven-wrapper.properties)"]:::config
    end

    %% Connections
    Browser -->|"HTTP Requests"| SSRServer
    SSRServer -->|"Serves Templates"| Templates
    SSRServer -->|"Bootstraps"| SSRModule
    SSRModule -->|"Renders UI"| CSRModule
    SSRModule --> RoutingServer
    CSRModule --> RoutingClient
    CSRModule --> Components
    SSRModule --> Components
    SSRServer --> StaticAssets
    CSRModule -->|"API Calls"| SpringApp

    SpringApp --> Security
    Security --> Controller
    Controller --> Service
    Service --> Repository
    Repository --> DB
    Controller --> Templates
    SpringApp --> AppConfig

    BuildFrontend --> SSRServer
    BuildFrontend --> CSRModule
    BuildFrontend --> Components
    BuildBackend --> SpringApp

    %% Click Events
    click SSRServer "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/src/server.ts"
    click SSRModule "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/src/main.server.ts"
    click CSRModule "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/src/main.ts"
    click Components "https://github.com/yunusemreerkesikbas/admincraft/tree/master/frontend/src/app"
    click RoutingClient "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/src/app/app.routes.ts"
    click RoutingServer "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/src/app/app.routes.server.ts"
    click ConfigClient "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/src/app/app.config.ts"
    click ConfigServer "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/src/app/app.config.server.ts"
    click StaticAssets "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/src/index.html"
    click StaticAssets "https://github.com/yunusemreerkesikbas/admincraft/tree/master/frontend/public"
    click StaticAssets "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/src/styles.scss"
    click BuildFrontend "https://github.com/yunusemreerkesikbas/admincraft/blob/master/angular.json"
    click BuildFrontend "https://github.com/yunusemreerkesikbas/admincraft/blob/master/frontend/package.json"
    click SpringApp "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/src/main/java/com/admincraft/cms/AdminCraftApplication.java"
    click Security "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/src/main/java/com/admincraft/cms/config/SecurityConfig.java"
    click Controller "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/src/main/java/com/admincraft/cms/module/home/controller/HomeController.java"
    click Service "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/src/main/java/com/admincraft/cms/core/generic/BaseService.java"
    click Repository "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/src/main/java/com/admincraft/cms/core/generic/BaseRepository.java"
    click Entity "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/src/main/java/com/admincraft/cms/core/generic/BaseEntity.java"
    click Exception "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/src/main/java/com/admincraft/cms/exception/ResourceNotFoundException.java"
    click Templates "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/src/main/resources/templates/index.html"
    click AppConfig "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/src/main/resources/application.yml"
    click BuildBackend "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/pom.xml"
    click BuildBackend "https://github.com/yunusemreerkesikbas/admincraft/blob/master/backend/.mvn/wrapper/maven-wrapper.properties"

    %% Styles
    classDef client fill:#f9f,stroke:#333,stroke-width:1px
    classDef ui fill:#bbf,stroke:#333,stroke-width:1px
    classDef server fill:#fbf,stroke:#333,stroke-width:1px
    classDef backend fill:#bfb,stroke:#333,stroke-width:1px
    classDef config fill:#ffb,stroke:#333,stroke-width:1px
    classDef storage fill:#fcf,stroke:#333,stroke-width:1px
    classDef database fill:#bdf,stroke:#333,stroke-width:1px
```
