# alelunagit/facturadorarca architecture

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

- Interactive diagram: https://gitdiagram.com/alelunagit/facturadorarca
- Repository: https://github.com/alelunagit/facturadorarca

## Overview

##### Project Type and Purpose
- This is a layered, console‐based invoicing (facturación) management system written in C#, structured around a clean/hexagonal style:
- Domain layer with entities and interfaces
- Repository layer using Entity Framework Core for persistence
- Service layer implementing business logic
- UI layer presenting a console menu
- Separate test project validating the InvoiceService and other services

##### File Structure Analysis
- Top‐level folders:
- Parcial3/Domain – business entities (Client, Invoice, Item) and their interfaces (IPerson, IInvoice, IItem)
- Parcial3/Repositories – EF Core ApplicationDbContext, migrations, and generic IRepository
- Parcial3/Services – ICrudService, IInvoiceService, IItemService and their implementations
- Parcial3/UI – console menus (MainMenu, ClientMenu, InvoiceMenu, ItemMenu), input Reader, output Presentator
- FacturadorARCA.Tests – unit tests for services
- Parcial3/Program.cs and appsettings.json for startup and configuration
- docker-compose.yml for containerized database environment

##### README Insights
- Confirms a UML‐based design with core classes (Persona/Client, Factura/Invoice, Item)
- Emphasizes interfaces for contracts and inheritance for behavior reuse
- Mentions business validations and console menu structure

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        direction TB
        MainMenu["MainMenu"]:::ui
        ClientMenu["ClientMenu"]:::ui
        InvoiceMenu["InvoiceMenu"]:::ui
        ItemMenu["ItemMenu"]:::ui
        Reader["Reader"]:::ui
        Presentator["Presentator"]:::ui
    end

    %% Service Layer
    subgraph "Service Layer"
        direction TB
        ICrudService["ICrudService"]:::services
        IInvoiceService["IInvoiceService"]:::services
        IItemService["IItemService"]:::services
        CrudService["CrudService"]:::services
        ClientService["ClientService"]:::services
        InvoiceService["InvoiceService"]:::services
        ItemService["ItemService"]:::services
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        IPerson["IPerson"]:::domain
        IInvoice["IInvoice"]:::domain
        IItem["IItem"]:::domain
        Client["Client"]:::domain
        Invoice["Invoice"]:::domain
        Item["Item"]:::domain
    end

    %% Repository/Infrastructure Layer
    subgraph "Repository/Infrastructure Layer"
        direction TB
        IRepository["IRepository"]:::repo
        ApplicationDbContext["ApplicationDbContext"]:::repo
        RepositoryImpl["Repository<T>"]:::repo
        Migrations["Migrations"]:::repo
    end

    %% Database
    Database[(Database)]:::db

    %% Test Project
    subgraph "Test Project"
        direction TB
        TestProj["FacturadorARCA.Tests.csproj"]:::test
        InvoiceServiceTest["InvoiceServiceTest"]:::test
        UnitTest1["UnitTest1"]:::test
    end

    %% Layer Connections
    MainMenu -->|"calls"| InvoiceService
    ClientMenu -->|"calls"| ClientService
    InvoiceMenu -->|"calls"| InvoiceService
    ItemMenu -->|"calls"| ItemService
    Reader -->|"provides input to"| MainMenu
    Presentator -->|"displays output from"| MainMenu

    CrudService -->|"depends on"| IRepository
    ClientService -->|"implements ICrudService & depends on"| IRepository
    InvoiceService -->|"implements IInvoiceService & depends on"| IRepository
    ItemService -->|"implements IItemService & depends on"| IRepository

    ICrudService -->|"contract for"| CrudService
    IInvoiceService -->|"contract for"| InvoiceService
    IItemService -->|"contract for"| ItemService

    IRepository -->|"CRUD operations on"| ApplicationDbContext
    RepositoryImpl -->|"implements IRepository"| IRepository
    ApplicationDbContext -->|"maps Entities"| Client
    ApplicationDbContext -->|"maps Entities"| Invoice
    ApplicationDbContext -->|"maps Entities"| Item
    Migrations -->|"EF Core migrations"| ApplicationDbContext

    ApplicationDbContext -->|"persists to"| Database

    InvoiceService -->|"uses domain contracts"| IInvoice
    ClientService -->|"uses domain contracts"| IPerson
    ItemService -->|"uses domain contracts"| IItem

    %% Test references
    TestProj -->|"tests"| InvoiceService
    TestProj -->|"tests"| CrudService
    InvoiceServiceTest -->|"unit tests for"| InvoiceService
    UnitTest1 -->|"generic tests for"| CrudService

    %% Click Events UI
    click MainMenu "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/UI/MainMenu.cs"
    click ClientMenu "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/UI/ClientMenu.cs"
    click InvoiceMenu "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/UI/InvoiceMenu.cs"
    click ItemMenu "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/UI/ItemMenu.cs"
    click Reader "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/UI/Reader.cs"
    click Presentator "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/UI/Presentator.cs"

    %% Click Events Services
    click ICrudService "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Services/Interfaces/ICrudService.cs"
    click IInvoiceService "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Services/Interfaces/IInvoiceService.cs"
    click IItemService "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Services/Interfaces/IItemService.cs"
    click CrudService "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Services/Implementations/CrudService.cs"
    click ClientService "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Services/Implementations/ClientService.cs"
    click InvoiceService "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Services/Implementations/InvoiceService.cs"
    click ItemService "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Services/Implementations/ItemService.cs"

    %% Click Events Domain
    click IPerson "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Domain/Interfaces/IPerson.cs"
    click IInvoice "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Domain/Interfaces/IInvoice.cs"
    click IItem "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Domain/Interfaces/IItem.cs"
    click Client "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Domain/Implementations/Client.cs"
    click Invoice "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Domain/Implementations/Invoice.cs"
    click Item "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Domain/Implementations/Item.cs"

    %% Click Events Repository
    click IRepository "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Repositories/Interfaces/IRepository.cs"
    click ApplicationDbContext "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Repositories/Implementations/ApplicationDbContext.cs"
    click RepositoryImpl "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Repositories/Implementations/Repository.cs"
    click Migrations "https://github.com/alelunagit/facturadorarca/tree/master/Parcial3/Repositories/Migrations"

    %% Click Events Configuration & Startup
    click Program "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/Program.cs"
    click appsettings "https://github.com/alelunagit/facturadorarca/blob/master/Parcial3/appsettings.json"
    click docker "https://github.com/alelunagit/facturadorarca/blob/master/docker-compose.yml"

    %% Click Events Tests
    click TestProj "https://github.com/alelunagit/facturadorarca/blob/master/FacturadorARCA.Tests/FacturadorARCA.Tests.csproj"
    click InvoiceServiceTest "https://github.com/alelunagit/facturadorarca/blob/master/FacturadorARCA.Tests/InvoiceServiceTest.cs"
    click UnitTest1 "https://github.com/alelunagit/facturadorarca/blob/master/FacturadorARCA.Tests/UnitTest1.cs"

    %% Styles
    classDef ui fill:#cce5ff,stroke:#004085,color:#004085
    classDef services fill:#d4edda,stroke:#155724,color:#155724
    classDef domain fill:#fff3cd,stroke:#856404,color:#856404
    classDef repo fill:#ffe5b4,stroke:#cc7000,color:#cc7000
    classDef db fill:#d6d8d9,stroke:#1b1e21,color:#1b1e21
    classDef test fill:#e2d0f7,stroke:#4b088a,color:#4b088a
```
