# wwolo/invoice-generator architecture

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

- Interactive diagram: https://gitdiagram.com/wwolo/invoice-generator
- Repository: https://github.com/wwolo/invoice-generator

## Overview

##### Main Components Identification

a) Feature Modules Layer
- Invoice Form Module
- Invoice Summary Module

b) Core Layer
- Core services and configurations

c) Shared Layer
- Reusable components
- Directives
- Pipes
- Services

d) Data Layer
- Models
- External data sources (company.json)

**[Browser] → [Angular Application]**
- ↓
- [Core Module] ← → [Shared Module]
- ↓
- [Feature Modules]
- /            \
**[Invoice Form]  [Invoice Summary]**

**[Invoice Form Component]**
- ↓
**[Invoice Item Form Component]**
- ↓
**[Shared Components/Directives]**
- Error Message Component
- Number Only Directive

**[Invoice Summary Component]**
- ↓
**[Company Info Component] [Invoice Items List Component]**
- ↓                         ↓
**[Invoice Summary Service] ← → [Invoice Service]**

##### Technical Details

- Angular v18 zoneless architecture
- TypeScript v5.5 implementation
- Tailwind CSS integration
- Form validation rules
- Data model structure

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Browser
        Client[Web Browser]
    end

    subgraph "Angular Application"
        App["App Component"]:::component
        click App "https://github.com/WWolo/invoice-generator/blob/main/src/app/app.component.ts"
        
        subgraph "Core Layer"
            Core["Core Configuration"]:::core
            AppConfig["App Configuration"]:::core
            Routes["Main Routes"]:::core
            click Core "https://github.com/WWolo/invoice-generator/blob/main/src/app/core/core.ts"
            click AppConfig "https://github.com/WWolo/invoice-generator/blob/main/src/app/app.config.ts"
            click Routes "https://github.com/WWolo/invoice-generator/blob/main/src/app/app.routes.ts"
        end

        subgraph "Feature Modules"
            subgraph "Invoice Form Module"
                InvoiceForm["Invoice Form Component"]:::feature
                InvoiceItemForm["Invoice Item Form Component"]:::feature
                click InvoiceForm "https://github.com/WWolo/invoice-generator/blob/main/src/app/feature/invoice-form/invoice-form.component.ts"
                click InvoiceItemForm "https://github.com/WWolo/invoice-generator/blob/main/src/app/feature/invoice-form/components/invoice-item-form/invoice-item-form.component.ts"
            end

            subgraph "Invoice Summary Module"
                InvoiceSummary["Invoice Summary Component"]:::feature
                CompanyInfo["Company Info Component"]:::feature
                InvoiceItemsList["Invoice Items List Component"]:::feature
                SummaryService["Invoice Summary Service"]:::service
                click InvoiceSummary "https://github.com/WWolo/invoice-generator/blob/main/src/app/feature/invoice-summary/invoice-summary.component.ts"
                click CompanyInfo "https://github.com/WWolo/invoice-generator/blob/main/src/app/feature/invoice-summary/components/company-info/company-info.component.ts"
                click InvoiceItemsList "https://github.com/WWolo/invoice-generator/blob/main/src/app/feature/invoice-summary/components/invoice-items-list/invoice-items-list.component.ts"
                click SummaryService "https://github.com/WWolo/invoice-generator/blob/main/src/app/feature/invoice-summary/invoice-summary.service.ts"
            end
        end

        subgraph "Shared Layer"
            ErrorMsg["Error Message Component"]:::shared
            NumberOnly["Number Only Directive"]:::shared
            PhoneFormat["Phone Format Pipe"]:::shared
            InvoiceService["Invoice Service"]:::service
            click ErrorMsg "https://github.com/WWolo/invoice-generator/blob/main/src/app/shared/components/error-message/error-message.component.ts"
            click NumberOnly "https://github.com/WWolo/invoice-generator/blob/main/src/app/shared/directives/number-only.directive.ts"
            click PhoneFormat "https://github.com/WWolo/invoice-generator/blob/main/src/app/shared/pipes/phone-format.pipe.ts"
            click InvoiceService "https://github.com/WWolo/invoice-generator/blob/main/src/app/shared/services/invoice.service.ts"
        end

        subgraph "Data Layer"
            CompanyModel["Company Model"]:::model
            InvoiceItemModel["Invoice Item Model"]:::model
            ItemFormModel["Item Form Model"]:::model
            CompanyData["Company Data (JSON)"]:::external
            click CompanyModel "https://github.com/WWolo/invoice-generator/blob/main/src/app/models/company.ts"
            click InvoiceItemModel "https://github.com/WWolo/invoice-generator/blob/main/src/app/models/invoice-item.ts"
            click ItemFormModel "https://github.com/WWolo/invoice-generator/blob/main/src/app/models/item-form.ts"
            click CompanyData "https://github.com/WWolo/invoice-generator/blob/main/src/assets/company.json"
        end
    end

    %% Relationships
    Client --> App
    App --> Core
    App --> Routes
    App --> AppConfig

    InvoiceForm --> InvoiceItemForm
    InvoiceForm --> ErrorMsg
    InvoiceItemForm --> NumberOnly
    
    InvoiceSummary --> CompanyInfo
    InvoiceSummary --> InvoiceItemsList
    InvoiceSummary --> SummaryService
    SummaryService --> InvoiceService
    
    CompanyInfo --> CompanyData
    CompanyInfo --> CompanyModel
    InvoiceItemsList --> InvoiceItemModel
    InvoiceItemForm --> ItemFormModel

    %% Styles
    classDef component fill:#d4d4d4,stroke:#333,stroke-width:2px
    classDef core fill:#ffe5cc,stroke:#333,stroke-width:2px
    classDef feature fill:#cce5ff,stroke:#333,stroke-width:2px
    classDef shared fill:#d5e8d4,stroke:#333,stroke-width:2px
    classDef service fill:#fff2cc,stroke:#333,stroke-width:2px
    classDef model fill:#e1d5e7,stroke:#333,stroke-width:2px
    classDef external fill:#f8cecc,stroke:#333,stroke-width:2px

    %% Legend
    subgraph Legend
        L1["Component"]:::component
        L2["Core"]:::core
        L3["Feature"]:::feature
        L4["Shared"]:::shared
        L5["Service"]:::service
        L6["Model"]:::model
        L7["External"]:::external
    end
```
