# jhosefrea/gui-purchase-invoice-management architecture

> Architecture diagram of the GitHub repository jhosefrea/gui-purchase-invoice-management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jhosefrea/gui-purchase-invoice-management
- Repository: https://github.com/jhosefrea/gui-purchase-invoice-management

## Overview

##### Project type and purpose
- This is a full‑stack invoice‑management system. The repository you see is the Angular front‑end (“PROYECTO FRONT‑END”) that consumes a FastAPI back‑end.
- It uses Angular 19+, TailwindCSS, TypeScript, SOLID principles, clean‑code and a modular architecture.

##### File structure
- Top‑level files: angular.json, package.json, tsconfig*.json, tailwind.config.js, .env.example – standard Angular + Tailwind setup.
- src/app contains AppModule plus feature modules (dashboard, invoices, users, reports, login, welcome).
- src/app/services holds HTTP service classes (FetchApiDataService, FetchApiUserService, FetchApiReportService) and a ToasterService.
- src/shared contains reusable components (header, layout, sidebar-nav), utilities (enums, modal, models).
- public and src/assets contain static assets and global styles (Tailwind).

##### README for additional insights
- Core tech: Angular front‑end served via ng serve; FastAPI back‑end on Uvicorn at port 8002.
- Deploy/Run: environment variables (.env.example → environment.ts), Node.js 20+, Angular CLI, Python/FastAPI.

a. Main components:
– Browser/Client UI
– Angular App shell (AppModule)
– Feature Modules:
· DashboardModule
· InvoiceModule (details, edit, view)
· UsersModule (list, create, edit)
· ReportsModule
· AuthModule (login, welcome)
– SharedModule (header, layout, sidebar‑nav, modal)
– Service Layer (FetchApi… services + ToasterService)
– HTTP Client (Angular HttpClient)
– External Service: FastAPI REST API
– Database (e.g., PostgreSQL/MySQL behind FastAPI)
– Environment/config (environment.ts / .env)

b. Relationships and interactions:
– UI Components call injected Services → Services issue HTTP requests via HttpClient → FastAPI endpoints → Database → JSON responses → back to Services → UI Components.
– AuthModule handles login, stores tokens in environment or localStorage.
– SharedModule components provide consistent header/sidebar across all feature modules.
– TailwindCSS provides styling at the assets/styles layer.

c. Architectural patterns & design principles:
– Modular architecture: one feature per module, with AppRoutes managing lazy loading.
– SOLID / Clean Code: single‑responsibility services, reusable shared components, clear folder structure.
– Separation of concerns: UI vs. data vs. routing vs. styling (Tailwind).
– Dependency injection: Angular DI for services and shared components.

d. Key technologies & frameworks:
– Angular (Components, Modules, HttpClient, Routing)
– TypeScript, RxJS (observables)
– TailwindCSS for utility‑first styling
– FastAPI + Uvicorn on port 8002 (Python)
– RESTful JSON over HTTP
– Node.js / npm for build chain

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Browser / Client UI
    subgraph "Browser / Client UI" 
        direction TB
        IndexHTML["index.html"]:::ui
        MainTS["main.ts"]:::ui
    end

    %% Angular App Layers
    subgraph "Angular App" 
        direction TB

        subgraph "App Shell" 
            direction TB
            AppComponentTS["app.component.ts"]:::ui
            AppComponentHTML["app.component.html"]:::ui
            AppRoutesTS["app.routes.ts"]:::ui
            AppConfigTS["app.config.ts"]:::config
        end

        subgraph "Angular Feature Modules" 
            direction TB
            DashboardComponentTS["dashboard.component.ts"]:::ui
            InvoiceDetailsTS["invoice-details.component.ts"]:::ui
            InvoiceEditTS["invoice-edit.component.ts"]:::ui
            InvoiceViewTS["invoice-view.component.ts"]:::ui
            UsersComponentTS["users.component.ts"]:::ui
            UserCreateTS["user-create.component.ts"]:::ui
            UserEditTS["user-edit.component.ts"]:::ui
            ReportsViewTS["reports-view.component.ts"]:::ui
            LoginComponentTS["login.component.ts"]:::ui
            WelcomeComponentTS["welcome-page.component.ts"]:::ui
        end

        subgraph "SharedModule" 
            direction TB
            HeaderComponentTS["header.component.ts"]:::ui
            LayoutComponentTS["layout.component.ts"]:::ui
            SidebarComponentTS["sidebar-nav.component.ts"]:::ui
            Enums["alert-sms-toast.enum.ts"]:::config
            ModalComponentTS["modal.component.ts"]:::ui
            ModelInterface["response.toast.interface.ts"]:::config
        end

        subgraph "Service Layer" 
            direction TB
            FetchApiData["fetch-api-data.service.ts"]:::services
            FetchApiUser["fetch-api-user.service.ts"]:::services
            FetchApiReport["fetch-api-report.service.ts"]:::services
            Toaster["toaster.service.ts"]:::services
        end

        EnvExample[".env.example"]:::config
        TailwindConfig["tailwind.config.js"]:::config
        TailwindCSS["tailwind.css"]:::config

        HttpClient["Angular HttpClient"]:::services
    end

    %% Backend API
    subgraph "FastAPI Server :8002" 
        direction TB
        FastAPIRouting["Routing / Controllers"]:::api
        FastAPILogic["Business Logic"]:::api
        FastAPIDBAccess["Database Access"]:::api
    end

    Database["Database"]:::db

    %% Connections
    IndexHTML --> MainTS
    MainTS --> AppComponentTS
    AppComponentTS --> AppComponentHTML
    AppComponentTS --> AppRoutesTS
    AppRoutesTS --> DashboardComponentTS
    AppRoutesTS --> InvoiceDetailsTS
    AppRoutesTS --> InvoiceEditTS
    AppRoutesTS --> InvoiceViewTS
    AppRoutesTS --> UsersComponentTS
    AppRoutesTS --> ReportsViewTS
    AppRoutesTS --> LoginComponentTS
    AppRoutesTS --> WelcomeComponentTS

    DashboardComponentTS --> FetchApiData
    InvoiceDetailsTS --> FetchApiData
    InvoiceEditTS --> FetchApiData
    InvoiceViewTS --> FetchApiData
    UsersComponentTS --> FetchApiUser
    UserCreateTS --> FetchApiUser
    UserEditTS --> FetchApiUser
    ReportsViewTS --> FetchApiReport
    LoginComponentTS --> FetchApiData
    WelcomeComponentTS --> FetchApiData

    HeaderComponentTS -->|used by| DashboardComponentTS
    LayoutComponentTS -->|used by| DashboardComponentTS
    SidebarComponentTS -->|used by| DashboardComponentTS

    FetchApiData --> HttpClient
    FetchApiUser --> HttpClient
    FetchApiReport --> HttpClient
    Toaster --> FetchApiData

    HttpClient --> FastAPIRouting
    FastAPIRouting --> FastAPILogic
    FastAPILogic --> FastAPIDBAccess
    FastAPIDBAccess --> Database

    EnvExample --> AppConfigTS
    TailwindConfig --> TailwindCSS
    TailwindCSS --> AppComponentHTML

    %% Click Events
    click IndexHTML "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/index.html"
    click MainTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/main.ts"
    click AppComponentTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/app.component.ts"
    click AppComponentHTML "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/app.component.html"
    click AppRoutesTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/app.routes.ts"
    click AppConfigTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/app.config.ts"
    click DashboardComponentTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/dashboard/dashboard.component.ts"
    click InvoiceDetailsTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/invoice-details/invoice-details.component.ts"
    click InvoiceEditTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/invoice-edit/invoice-edit.component.ts"
    click InvoiceViewTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/invoice-view/invoice-view.component.ts"
    click UsersComponentTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/users/users.component.ts"
    click UserCreateTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/users/user-create/user-create.component.ts"
    click UserEditTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/users/user-edit/user-edit.component.ts"
    click ReportsViewTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/reports-view/reports-view.component.ts"
    click LoginComponentTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/login/login.component.ts"
    click WelcomeComponentTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/welcome-page/welcome-page.component.ts"
    click HeaderComponentTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/shared/components/header/header.component.ts"
    click LayoutComponentTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/shared/components/layout/layout.component.ts"
    click SidebarComponentTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/shared/components/sidebar-nav/sidebar-nav.component.ts"
    click Enums "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/shared/utils/enums/alert-sms-toast.enum.ts"
    click ModalComponentTS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/shared/utils/modal/modal.component.ts"
    click ModelInterface "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/shared/utils/models/response.toast.interface.ts"
    click FetchApiData "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/services/fetch-api-data.service.ts"
    click FetchApiUser "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/services/fetch-api-user.service.ts"
    click FetchApiReport "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/services/fetch-api-report.service.ts"
    click Toaster "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/app/services/toaster.service.ts"
    click EnvExample "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/.env.example"
    click TailwindConfig "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/tailwind.config.js"
    click TailwindCSS "https://github.com/jhosefrea/gui-purchase-invoice-management/blob/main/src/assets/styles/tailwind.css"

    %% Styles
    classDef ui fill:#d4edda,stroke:#155724;
    classDef services fill:#cce5ff,stroke:#004085;
    classDef api fill:#ffe5b4,stroke:#cc7000;
    classDef db fill:#e2e3e5,stroke:#6c757d;
    classDef config fill:#f8d7da,stroke:#721c24;
```
