# tomymonzon08-afk/tarjetasube_randisi_monzon architecture

> Architecture diagram of the GitHub repository tomymonzon08-afk/tarjetasube_randisi_monzon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tomymonzon08-afk/tarjetasube_randisi_monzon
- Repository: https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon

## Overview

TarjetaSube is a console simulation of Rosario transit and public-bike services, backed by an Entity Framework context. The main workflow creates cards and lines, accepts loads, then processes trips into persisted tickets; additional branches cover fare benefits, transfers, and bike rental, return, and penalties. The excerpts show the trip and bike domain behavior, while several service implementations are unsampled; those links are included only where the program excerpt or source index supports them.

Main entry points: [`TarjetaSube/TarjetaSube/Program.cs`](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Program.cs) (Simulation entry), [`TarjetaSube/TarjetaSube/Servicios/ViajeServicio.cs`](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/ViajeServicio.cs) (Trip processing), [`TarjetaSube/TarjetaSube/Clases/Colectivo.cs`](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/Colectivo.cs) (Bus line), [`TarjetaSube/TarjetaSube/Servicios/RetiroBiciServicio.cs`](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/RetiroBiciServicio.cs) (Bike withdrawal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Console application"]
  node_program["Simulation entry<br/>[Program.cs]"]
end

subgraph group_transit["Transit fares"]
  node_card_service["Card management<br/>[TarjetaServicio.cs]"]
  node_load_service["Card loading<br/>[CargaServicio.cs]"]
  node_trip_service["Trip processing<br/>[ViajeServicio.cs]"]
  node_bus_service["Line management"]
  node_card["Travel card<br/>[Tarjeta.cs]"]
  node_card_type["Fare category<br/>[TarjetaTipo.cs]"]
  node_bus["Bus line<br/>[Colectivo.cs]"]
  node_ticket["Trip ticket<br/>[Boleto.cs]"]
  node_trip_history["Trip history"]
  node_fare_rules["Fare and transfer rules<br/>[Reglas.cs]"]
  node_frequent_use["Frequent-use discount<br/>[UsoFrecuente.cs]"]
end

subgraph group_bikes["Bike sharing"]
  node_station_service["Station management"]
  node_withdrawal_service["Bike withdrawal"]
  node_return_service["Bike return"]
  node_station["Bike station<br/>[EstacionBici.cs]"]
  node_rental["Bike rental<br/>[AlquilerBici.cs]"]
  node_bike_history["Bike history<br/>[HistorialBici.cs]"]
end

subgraph group_persistence["Persistence and time"]
  node_context[("EF data context<br/>[TarjetaContext.cs]")]
  node_clock["Date provider"]
end

node_rider(("Transit user"))

node_rider -.->|"uses"| node_program
node_program -->|"manages cards"| node_card_service
node_program -->|"loads cards"| node_load_service
node_program -->|"creates lines"| node_bus_service
node_program -->|"processes trips"| node_trip_service
node_program -->|"manages stations"| node_station_service
node_program -->|"withdraws bikes"| node_withdrawal_service
node_program -->|"returns bikes"| node_return_service
node_card_service -->|"persists cards"| node_context
node_load_service -.->|"credits balance"| node_card
node_trip_service -->|"loads history, saves ticket"| node_context
node_trip_service -->|"gets current time"| node_clock
node_trip_service -->|"requests payment"| node_bus
node_trip_service -->|"builds history"| node_trip_history
node_bus -->|"checks transfers"| node_fare_rules
node_bus -->|"charges fare"| node_card
node_bus -->|"creates ticket"| node_ticket
node_card -->|"calculates fare"| node_card_type
node_card_type -->|"applies discount"| node_frequent_use
node_withdrawal_service -->|"loads and saves"| node_context
node_withdrawal_service -->|"gets current time"| node_clock
node_withdrawal_service -->|"requests withdrawal"| node_station
node_station -->|"creates rental"| node_rental
node_return_service -.->|"records return"| node_rental
node_rental -->|"adds penalty"| node_card

click node_program "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Program.cs"
click node_card_service "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/TarjetaServicio.cs"
click node_load_service "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/CargaServicio.cs"
click node_trip_service "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/ViajeServicio.cs"
click node_bus_service "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/ColectivoServicio.cs"
click node_card "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/Tarjeta.cs"
click node_card_type "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/TarjetaTipo.cs"
click node_bus "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/Colectivo.cs"
click node_ticket "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/Boleto.cs"
click node_trip_history "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/HistorialDeViajes.cs"
click node_fare_rules "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/Reglas.cs"
click node_frequent_use "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/UsoFrecuente.cs"
click node_station_service "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/EstacionBiciServicio.cs"
click node_withdrawal_service "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/RetiroBiciServicio.cs"
click node_return_service "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/DevolucionBiciServicio.cs"
click node_station "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/EstacionBici.cs"
click node_rental "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/AlquilerBici.cs"
click node_bike_history "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/HistorialBici.cs"
click node_context "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/TarjetaContext.cs"
click node_clock "https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/IProveedorDeFecha.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_program,node_rider toneBlue
class node_card_service,node_load_service,node_trip_service,node_bus_service,node_card,node_card_type,node_bus,node_ticket,node_trip_history,node_fare_rules,node_frequent_use toneAmber
class node_station_service,node_withdrawal_service,node_return_service,node_station,node_rental,node_bike_history toneMint
class node_context,node_clock toneRose
```

## Components

### Console application

- [Simulation entry](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Program.cs): `TarjetaSube/TarjetaSube/Program.cs`

### Transit fares

- [Card management](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/TarjetaServicio.cs): `TarjetaSube/TarjetaSube/Servicios/TarjetaServicio.cs`
- [Card loading](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/CargaServicio.cs): `TarjetaSube/TarjetaSube/Servicios/CargaServicio.cs`
- [Trip processing](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/ViajeServicio.cs): `TarjetaSube/TarjetaSube/Servicios/ViajeServicio.cs`
- [Line management](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/ColectivoServicio.cs): `TarjetaSube/TarjetaSube/Servicios/ColectivoServicio.cs`
- [Travel card](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/Tarjeta.cs): `TarjetaSube/TarjetaSube/Clases/Tarjeta.cs`
- [Fare category](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/TarjetaTipo.cs): `TarjetaSube/TarjetaSube/Clases/TarjetaTipo.cs`
- [Bus line](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/Colectivo.cs): `TarjetaSube/TarjetaSube/Clases/Colectivo.cs`
- [Trip ticket](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/Boleto.cs): `TarjetaSube/TarjetaSube/Clases/Boleto.cs`
- [Trip history](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/HistorialDeViajes.cs): `TarjetaSube/TarjetaSube/Clases/HistorialDeViajes.cs`
- [Fare and transfer rules](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/Reglas.cs): `TarjetaSube/TarjetaSube/Servicios/Reglas.cs`
- [Frequent-use discount](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/UsoFrecuente.cs): `TarjetaSube/TarjetaSube/Servicios/UsoFrecuente.cs`

### Bike sharing

- [Station management](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/EstacionBiciServicio.cs): `TarjetaSube/TarjetaSube/Servicios/EstacionBiciServicio.cs`
- [Bike withdrawal](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/RetiroBiciServicio.cs): `TarjetaSube/TarjetaSube/Servicios/RetiroBiciServicio.cs`
- [Bike return](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/DevolucionBiciServicio.cs): `TarjetaSube/TarjetaSube/Servicios/DevolucionBiciServicio.cs`
- [Bike station](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/EstacionBici.cs): `TarjetaSube/TarjetaSube/Clases/EstacionBici.cs`
- [Bike rental](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/AlquilerBici.cs): `TarjetaSube/TarjetaSube/Clases/AlquilerBici.cs`
- [Bike history](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Clases/HistorialBici.cs): `TarjetaSube/TarjetaSube/Clases/HistorialBici.cs`

### Persistence and time

- [EF data context](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/TarjetaContext.cs): `TarjetaSube/TarjetaSube/Servicios/TarjetaContext.cs`
- [Date provider](https://github.com/tomymonzon08-afk/tarjetasube_randisi_monzon/blob/main/TarjetaSube/TarjetaSube/Servicios/IProveedorDeFecha.cs): `TarjetaSube/TarjetaSube/Servicios/IProveedorDeFecha.cs`

### Other components

- **Transit user**

## Connections

- Transit user → Simulation entry: uses
- Simulation entry → Card management: manages cards (evidence: `TarjetaSube/TarjetaSube/Program.cs`)
- Simulation entry → Card loading: loads cards (evidence: `TarjetaSube/TarjetaSube/Program.cs`)
- Simulation entry → Line management: creates lines (evidence: `TarjetaSube/TarjetaSube/Program.cs`)
- Simulation entry → Trip processing: processes trips (evidence: `TarjetaSube/TarjetaSube/Program.cs`)
- Simulation entry → Station management: manages stations (evidence: `TarjetaSube/TarjetaSube/Program.cs`)
- Simulation entry → Bike withdrawal: withdraws bikes (evidence: `TarjetaSube/TarjetaSube/Program.cs`)
- Simulation entry → Bike return: returns bikes (evidence: `TarjetaSube/TarjetaSube/Program.cs`)
- Card management → EF data context: persists cards (evidence: `TarjetaSube/TarjetaSube/Servicios/TarjetaServicio.cs`)
- Card loading → Travel card: credits balance (evidence: `TarjetaSube/TarjetaSube/Servicios/CargaServicio.cs`)
- Trip processing → EF data context: loads history, saves ticket (evidence: `TarjetaSube/TarjetaSube/Servicios/ViajeServicio.cs`)
- Trip processing → Date provider: gets current time (evidence: `TarjetaSube/TarjetaSube/Servicios/ViajeServicio.cs`)
- Trip processing → Bus line: requests payment (evidence: `TarjetaSube/TarjetaSube/Servicios/ViajeServicio.cs`)
- Trip processing → Trip history: builds history (evidence: `TarjetaSube/TarjetaSube/Servicios/ViajeServicio.cs`)
- Bus line → Fare and transfer rules: checks transfers (evidence: `TarjetaSube/TarjetaSube/Clases/Colectivo.cs`)
- Bus line → Travel card: charges fare (evidence: `TarjetaSube/TarjetaSube/Clases/Colectivo.cs`)
- Bus line → Trip ticket: creates ticket (evidence: `TarjetaSube/TarjetaSube/Clases/Colectivo.cs`)
- Travel card → Fare category: calculates fare (evidence: `TarjetaSube/TarjetaSube/Clases/Tarjeta.cs`)
- Fare category → Frequent-use discount: applies discount (evidence: `TarjetaSube/TarjetaSube/Clases/TarjetaTipo.cs`)
- Bike withdrawal → EF data context: loads and saves (evidence: `TarjetaSube/TarjetaSube/Servicios/RetiroBiciServicio.cs`)
- Bike withdrawal → Date provider: gets current time (evidence: `TarjetaSube/TarjetaSube/Servicios/RetiroBiciServicio.cs`)
- Bike withdrawal → Bike station: requests withdrawal (evidence: `TarjetaSube/TarjetaSube/Servicios/RetiroBiciServicio.cs`)
- Bike station → Bike rental: creates rental (evidence: `TarjetaSube/TarjetaSube/Clases/EstacionBici.cs`)
- Bike return → Bike rental: records return (evidence: `TarjetaSube/TarjetaSube/Servicios/DevolucionBiciServicio.cs`)
- Bike rental → Travel card: adds penalty (evidence: `TarjetaSube/TarjetaSube/Clases/AlquilerBici.cs`)
