# abcall-project/abcall-web architecture

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

- Interactive diagram: https://gitdiagram.com/abcall-project/abcall-web
- Repository: https://github.com/abcall-project/abcall-web

## Overview

##### Project type and purpose
- This is a single‐page application (SPA) built with Angular (TypeScript) for managing call‐center issues for corporate clients.
- It’s purely a front‐end repo, with environment configs pointing at REST API endpoints (issues, customers, users, payments, predictive/AI services).
- It includes Docker and Kubernetes manifests for containerized deployment, plus GitHub Actions CI/CD and a Netlify preview pipeline.

##### File structure
- src/ – Angular application code
- app/ – feature modules (authentication, pages, guards, interceptors, layouts, services, pipes, models)
- assets/ – static assets (images, i18n JSON, SCSS styling)
- environments/ – per‐feature environment configurations (environment.issues.ts, environment.customers.ts, etc.)
- main.ts, index.html – Angular bootstrap
- docker/ & Dockerfile & develop.Dockerfile – build images for production and development
- docker-compose*.yaml – local multi‐container setup with Nginx serving the built SPA
- kubernetes/ – manifests for ConfigMap, Secrets, Deployment, Service, Ingress, HPA
- .github/workflows/ – GitHub Actions for lint/test, merge to develop, release to main
- netlify.toml – Netlify hosting configuration

##### README for additional insights
- Confirms Angular/TypeScript/Node tech stack
- Mentions web app “to manage call center issues”

##### Detail without overthinking
- At a minimum, break out:
- Client Browser
- Hosting (Nginx container in K8s/Netlify)
- Angular Modules (Authentication, Pages, Services)
- External REST APIs (issues/customers/users/payment/predictive)
- CI/CD pipeline and Kubernetes cluster
- Optionally, annotate environment configs (environment.issues.ts etc.) to show how endpoints are wired.

Layer 1 – Logical Architecture (SPA modules + external APIs)
Layer 2 – Deployment Architecture (CI/CD → Docker → K8s → Ingress → Nginx → Browser)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Logical Architecture
    subgraph "Logical Architecture"
        direction TB
        subgraph "Angular SPA" 
            direction TB
            AppModule["App Module"]:::frontend
            AppRouting["App Routing"]:::frontend
            subgraph "Feature Modules"
                direction TB
                Authentication["Authentication Module"]:::frontend
                ManageIssues["Manage Issues Module"]:::frontend
                LoadCustomers["Load Customers Module"]:::frontend
                PaymentModule["Payment Module"]:::frontend
                PredictiveDashboard["Predictive Dashboard Module"]:::frontend
            end
            subgraph "Services Layer"
                direction TB
                AuthService["AuthService"]:::frontend
                IssuesService["IssuesService"]:::frontend
                CustomersService["CustomersService"]:::frontend
                UsersService["UsersService"]:::frontend
                CoreService["Core Service"]:::frontend
                NavService["Nav Service"]:::frontend
            end
            AuthInterceptor["Auth Interceptor"]:::frontend
            AuthGuard["Auth Guard"]:::frontend
            Models["Models"]:::frontend
            subgraph "Layouts"
                direction TB
                FullLayout["Full Layout"]:::frontend
                BlankLayout["Blank Layout"]:::frontend
            end
        end
        subgraph "External REST APIs"
            direction TB
            AuthAPI["Auth Service API"]:::backend
            IssuesAPI["Issues Service API"]:::backend
            CustomersAPI["Customers Service API"]:::backend
            UsersAPI["Users Service API"]:::backend
            PaymentAPI["Payment Service API"]:::backend
            PredictiveAPI["Predictive/AI Service API"]:::backend
        end

        %% Connections Logical
        AppModule --> AppRouting
        AppRouting --> Authentication
        AppRouting --> ManageIssues
        AppRouting --> LoadCustomers
        AppRouting --> PaymentModule
        AppRouting --> PredictiveDashboard
        Authentication --> AuthService
        ManageIssues --> IssuesService
        LoadCustomers --> CustomersService
        PaymentModule --> AuthService
        PaymentModule --> PaymentAPI
        PredictiveDashboard --> PredictiveAPI
        AuthService --> AuthAPI
        IssuesService --> IssuesAPI
        CustomersService --> CustomersAPI
        UsersService --> UsersAPI
        CoreService --> AuthService
        NavService --> CoreService
        AuthInterceptor --> AuthService
        AuthGuard --> AuthService
        AppModule --> AuthInterceptor
        AppModule --> AuthGuard
        AppModule --> Models
        AppModule --> FullLayout
        AppModule --> BlankLayout
    end

    %% Deployment Architecture
    subgraph "Deployment Architecture"
        direction TB
        CodeRepo["GitHub Repo"]:::pipeline
        CI["GitHub Actions CI/CD"]:::pipeline
        DockerBuild["Docker Build"]:::infra
        DockerRegistry["Artifact Registry"]:::infra
        NetlifyDeploy["Netlify Preview"]:::infra
        subgraph "Kubernetes Cluster"
            direction TB
            Ingress["K8s Ingress"]:::infra
            Service["K8s Service"]:::infra
            Deployment["K8s Deployment (Nginx SPA)"]:::infra
        end
        Nginx["Nginx Container"]:::infra
        Browser["User Browser"]:::external
        CDN["Netlify CDN"]:::infra

        %% Connections Deployment
        CodeRepo --> CI
        CI --> DockerBuild
        CI --> NetlifyDeploy
        DockerBuild --> DockerRegistry
        DockerRegistry --> Deployment
        Deployment --> Service
        Service --> Ingress
        Ingress --> Nginx
        NetlifyDeploy --> CDN
        CDN --> Browser
        Nginx --> Browser
    end

    %% Click Events
    click AppModule "https://github.com/abcall-project/abcall-web/blob/develop/src/app/app.module.ts"
    click AppRouting "https://github.com/abcall-project/abcall-web/blob/develop/src/app/app-routing.module.ts"
    click Authentication "https://github.com/abcall-project/abcall-web/tree/develop/src/app/pages/authentication"
    click ManageIssues "https://github.com/abcall-project/abcall-web/tree/develop/src/app/pages/app/manage-issues"
    click LoadCustomers "https://github.com/abcall-project/abcall-web/tree/develop/src/app/pages/app/load-customers"
    click PaymentModule "https://github.com/abcall-project/abcall-web/blob/develop/src/app/pages/app/payment/payment.module.ts"
    click AuthService "https://github.com/abcall-project/abcall-web/blob/develop/src/app/services/auth/auth.service.ts"
    click IssuesService "https://github.com/abcall-project/abcall-web/blob/develop/src/app/services/issues.service.ts"
    click CustomersService "https://github.com/abcall-project/abcall-web/blob/develop/src/app/services/customers/customers.service.ts"
    click UsersService "https://github.com/abcall-project/abcall-web/blob/develop/src/app/services/users/users.service.ts"
    click CoreService "https://github.com/abcall-project/abcall-web/blob/develop/src/app/services/core.service.ts"
    click NavService "https://github.com/abcall-project/abcall-web/blob/develop/src/app/services/nav.service.ts"
    click AuthInterceptor "https://github.com/abcall-project/abcall-web/blob/develop/src/app/interceptors/auth.interceptor.ts"
    click AuthGuard "https://github.com/abcall-project/abcall-web/blob/develop/src/app/guard/auth.guard.ts"
    click Models "https://github.com/abcall-project/abcall-web/tree/develop/src/app/models"
    click FullLayout "https://github.com/abcall-project/abcall-web/tree/develop/src/app/layouts/full"
    click BlankLayout "https://github.com/abcall-project/abcall-web/tree/develop/src/app/layouts/blank"
    click PaymentModule "https://github.com/abcall-project/abcall-web/blob/develop/src/app/pages/app/payment/payment.module.ts"
    click PaymentModule "https://github.com/abcall-project/abcall-web/blob/develop/src/app/pages/app/payment/payment.service.ts"
    click PredictiveDashboard "https://github.com/abcall-project/abcall-web/tree/develop/src/app/pages/app/predictive-dashboard"
    click DockerBuild "https://github.com/abcall-project/abcall-web/tree/develop/Dockerfile"
    click DockerBuild "https://github.com/abcall-project/abcall-web/blob/develop/develop.Dockerfile"
    click DockerBuild "https://github.com/abcall-project/abcall-web/blob/develop/docker/entrypoint.production.sh"
    click DockerBuild "https://github.com/abcall-project/abcall-web/blob/develop/docker/entrypoint.develop.sh"
    click DockerBuild "https://github.com/abcall-project/abcall-web/blob/develop/docker/nginx.conf"
    click DockerBuild "https://github.com/abcall-project/abcall-web/blob/develop/docker-compose.yaml"
    click DockerBuild "https://github.com/abcall-project/abcall-web/blob/develop/docker-compose.develop.yaml"
    click .github "https://github.com/abcall-project/abcall-web/blob/develop/ .github/workflows/action.yaml"
    click .github "https://github.com/abcall-project/abcall-web/blob/develop/ .github/workflows/merge-to-develop.yaml"
    click .github "https://github.com/abcall-project/abcall-web/blob/develop/ .github/workflows/release-to-main.yaml"
    click NetlifyDeploy "https://github.com/abcall-project/abcall-web/blob/develop/netlify.toml"
    click Deployment "https://github.com/abcall-project/abcall-web/tree/develop/kubernetes/"
    
    %% Styles
    classDef frontend fill:#d0e7ff,stroke:#0366d6,color:#0366d6
    classDef backend fill:#ffe0b2,stroke:#ff9800,color:#e65100
    classDef infra fill:#e8f5e9,stroke:#43a047,color:#1b5e20
    classDef pipeline fill:#f3e5f5,stroke:#8e24aa,color:#4a148c
    classDef external fill:#ffffff,stroke:#000000,color:#000000,stroke-dasharray: 2 2
```
