# siddhantpatni0407/angular-tracker-manager-ui architecture

> Architecture diagram of the GitHub repository siddhantpatni0407/angular-tracker-manager-ui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/siddhantpatni0407/angular-tracker-manager-ui
- Repository: https://github.com/siddhantpatni0407/angular-tracker-manager-ui

## Overview

##### Project type and purpose
- This is a full‑stack work‑item‑tracking application. The provided repo contains the Angular front‑end (“angular‑tracker‑manager‑ui”), and the README indicates a Spring Boot/PostgreSQL back‑end (not in this tree). It supports user auth (register/login), an admin panel, and multiple “trackers” (vehicles, credentials, financial, medical, stock‑market).

##### File structure
- Top‑level files: Angular configuration (angular.json, tsconfig*.json), package.json, README.
- src/app:
- app.module.ts, routing modules and config – the root Angular module and router.
- components/…: feature folders by domain (auth, admin‑panel, credential‑tracker, financial‑tracker, medical‑tracker, stock‑market‑tracker, vehicle‑tracker, dashboard, update‑user). Each contains its component(s), nested subcomponents for add/view/update operations.
- services/: Angular services for API calls (auth.service.ts, vehicle.service.ts, etc.).
- models/: TypeScript interfaces for request/response payloads.
- guards/: route guard for protected routes.
- constants/: endpoint constants.
- Public/assets and static files under src/index.html, styles.css.
- No back‑end code here, but README specifies a Spring Boot service with PostgreSQL and Liquibase.

##### README for additional insights
- Front‑end: Angular + Bootstrap.
- Back‑end: Spring Boot (Java 21), PostgreSQL + Liquibase, Gradle.
- Typical commands and project structure overview.

a. Main components
- Front‑end Angular client
- Modules: AuthModule, AdminModule, TrackerModules (Vehicle, Credential, Financial, Medical, StockMarket), SharedModule (services, models, guards, constants), AppRouter
- Back‑end Spring Boot API
- Controllers, Services, Repositories
- Database: PostgreSQL
- Migration tool: Liquibase
- External libraries: jsPDF/xlsx for export
b. Relationships & interactions
- Angular → HTTP(S) REST calls → Spring Boot controllers
- Controllers → service layer → repository layer → PostgreSQL
- Liquibase executes before application start to manage schema
- Angular route guard checks JWT/local‑storage token issued by back‑end
- Export libraries in Angular call browser APIs to generate PDFs/Excel
c. Architectural patterns / design principles
- Front‑end: Component‑based architecture, feature modules, Router for navigation, service layer for API integration, guard for route protection
- Back‑end: Layered architecture (Controller-Service-Repository), RESTful API, database migrations with Liquibase
- Separation of concerns between UI, API, data persistence
d. Key technologies
- Angular, TypeScript, Bootstrap, jsPDF, XLSX
- Spring Boot, Java, Gradle, PostgreSQL, Liquibase

##### Detailed capture of essential elements
- Route guard intercepting navigation
- Under each Tracker feature, list subcomponents (Add / View / Manage)
- On back‑end side, indicate typical CRUD endpoints for each tracker type
- Export feature: Angular → jsPDF/xlsx library → file download

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "Frontend (Angular Client)"
    direction TB
    AppModule["AppModule"]:::frontend
    AppRouting["AppRouting"]:::frontend
    Navbar["NavbarComponent"]:::frontend
    subgraph "Feature Modules"
      direction TB
      AuthModule["AuthModule"]:::frontend
      AdminModule["AdminModule"]:::frontend
      DashboardModule["DashboardComponent"]:::frontend
      VehicleModule["VehicleTrackerModule"]:::frontend
      CredentialModule["CredentialTrackerModule"]:::frontend
      FinancialModule["FinancialTrackerModule"]:::frontend
      MedicalModule["MedicalTrackerModule"]:::frontend
      StockModule["StockMarketTrackerModule"]:::frontend
      UpdateUser["UpdateUserComponent"]:::frontend
    end
    subgraph "Shared"
      direction TB
      Services["Services"]:::services
      Models["Models"]:::models
      Guards["AuthGuard"]:::guards
      Constants["API Constants"]:::constants
    end
  end

  subgraph "Backend (Spring Boot API)"
    direction TB
    Liquibase["Liquibase"]:::config
    Controllers["Controllers"]:::backend
    ServiceLayer["Services"]:::backend
    Repositories["Repositories"]:::backend
    Database["PostgreSQL"]:::database
  end

  AppModule --> AppRouting
  AppModule --> Navbar
  AppRouting --> AuthModule
  AppRouting --> AdminModule
  AppRouting --> DashboardModule
  AppRouting --> VehicleModule
  AppRouting --> CredentialModule
  AppRouting --> FinancialModule
  AppRouting --> MedicalModule
  AppRouting --> StockModule
  AppRouting --> UpdateUser

  AuthModule --> Services
  AdminModule --> Services
  DashboardModule --> Services
  VehicleModule --> Services
  CredentialModule --> Services
  FinancialModule --> Services
  MedicalModule --> Services
  StockModule --> Services
  UpdateUser --> Services

  Services -->|"HTTP REST calls"| Controllers
  Controllers --> ServiceLayer
  ServiceLayer --> Repositories
  Repositories --> Database
  Liquibase -.-> Database

  click AuthModule "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/tree/master/src/app/components/auth"
  click AdminModule "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/components/admin-panel/admin-panel.component.ts"
  click VehicleModule "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/tree/master/src/app/components/vehicle-tracker"
  click CredentialModule "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/tree/master/src/app/components/credential-tracker"
  click FinancialModule "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/tree/master/src/app/components/financial-tracker"
  click MedicalModule "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/components/medical-tracker/medical-tracker.component.ts"
  click StockModule "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/tree/master/src/app/components/stock-market-tracker"
  click DashboardModule "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/components/dashboard/dashboard.component.ts"
  click UpdateUser "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/components/update-user/update-user.component.ts"
  click AppRouting "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/app-routing.module.ts"
  click AppRouting "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/app.routes.ts"
  click AppModule "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/app.module.ts"
  click Services "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/services/auth.service.ts"
  click Services "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/services/vehicle.service.ts"
  click Models "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/tree/master/src/app/models"
  click Guards "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/guards/auth.guard.ts"
  click Constants "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/constants/api.constants.ts"
  click Navbar "https://github.com/siddhantpatni0407/angular-tracker-manager-ui/blob/master/src/app/navbar/navbar.component.ts"

  classDef frontend fill:#D0E6FF,stroke:#0366D6,stroke-width:1px
  classDef services fill:#ECFFDD,stroke:#28A745,stroke-width:1px
  classDef models fill:#FFF5BA,stroke:#DAA520,stroke-width:1px
  classDef guards fill:#FFE5E5,stroke:#D73A49,stroke-width:1px
  classDef constants fill:#EDEFF0,stroke:#6A737D,stroke-width:1px
  classDef backend fill:#FFEFD5,stroke:#D2691E,stroke-width:1px
  classDef config fill:#F0F8FF,stroke:#4682B4,stroke-width:1px,stroke-dasharray: 5 5
  classDef database fill:#EDEDED,stroke:#666666,stroke-width:1px,shape:cylinder
```
