# leodviana/acesapp architecture

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

- Interactive diagram: https://gitdiagram.com/leodviana/acesapp
- Repository: https://github.com/leodviana/acesapp

## Overview

Aces is a Xamarin.Forms mobile app for users and professors to manage dental appointments and related account information. The flow begins with login or restoring a saved session, then navigates to role-specific screens; view models use the API service for scheduling, profile, professor, and ranking operations. Schedule changes and their history are distinct capabilities. The graph reflects explicit navigation registrations and API calls; unsampled screens and service methods are represented only where the source index or excerpts support them.

Main entry points: [`Aces/AcesApp/AcesApp/App.xaml.cs`](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/App.xaml.cs) (App startup), [`Aces/AcesApp/AcesApp/Services/ApiService.cs`](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Services/ApiService.cs) (API client), [`Aces/AcesApp/AcesApp/Interfaces/IApiService.cs`](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Interfaces/IApiService.cs) (API contract), [`Aces/AcesApp/AcesApp/ViewModels/ViewModelBase.cs`](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/ViewModelBase.cs) (View-model base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["App and navigation"]
  node_app["App startup<br/>[App.xaml.cs]"]
  node_main["Main navigation"]
  node_tab_icons["Tab icon contract<br/>[ITabPageIcons.cs]"]
end

subgraph group_accounts["Accounts and profiles"]
  node_login["Login flow"]
  node_profile["User profile"]
  node_profprofile["Professor profile"]
  node_professors["Professor directory"]
  node_ranking["Rankings"]
end

subgraph group_scheduling["Classes and scheduling"]
  node_lessons["User lessons"]
  node_coachlessons["Professor lessons"]
  node_edit["Edit schedule"]
  node_changes["Schedule history"]
end

subgraph group_shared["API and domain types"]
  node_base["View-model base<br/>[ViewModelBase.cs]"]
  node_api["API client<br/>[ApiService.cs]"]
  node_api_contract["API contract<br/>[IApiService.cs]"]
  node_user_model["User data<br/>[Usuario.cs]"]
  node_event_model["Event data<br/>[Events.cs]"]
  node_log_model["Lesson-change log<br/>[AulasLog.cs]"]
  node_prof_model["Professor data<br/>[Professor.cs]"]
  node_ranking_model["Ranking data<br/>[Ranking.cs]"]
  node_response["API response<br/>[Response.cs]"]
end

node_user(("App user"))
node_backend{{"Application API"}}

node_user -->|"opens app"| node_app
node_app -->|"routes when signed out"| node_login
node_app -->|"routes saved session"| node_main
node_app -->|"registers navigation"| node_profile
node_app -->|"registers navigation"| node_profprofile
node_app -->|"registers navigation"| node_professors
node_app -->|"registers navigation"| node_lessons
node_app -->|"registers navigation"| node_coachlessons
node_app -->|"registers navigation"| node_edit
node_app -->|"registers navigation"| node_changes
node_app -->|"registers navigation"| node_ranking
node_login -->|"uses API"| node_api_contract
node_profile -->|"uses API"| node_api_contract
node_profprofile -->|"uses API"| node_api_contract
node_professors -->|"uses API"| node_api_contract
node_lessons -->|"uses API"| node_api_contract
node_coachlessons -->|"uses API"| node_api_contract
node_edit -->|"uses API"| node_api_contract
node_changes -->|"uses API"| node_api_contract
node_ranking -->|"uses API"| node_api_contract
node_api -->|"sends HTTP requests"| node_backend
node_app -->|"registers service"| node_api
node_api -->|"implements"| node_api_contract
node_lessons -->|"inherits"| node_base
node_coachlessons -->|"inherits"| node_base
node_login -->|"inherits"| node_base
node_profile -->|"inherits"| node_base
node_profprofile -->|"inherits"| node_base
node_edit -->|"inherits"| node_base
node_changes -->|"inherits"| node_base
node_ranking -->|"inherits"| node_base
node_api -->|"returns results"| node_response
node_api -->|"serializes user"| node_user_model
node_api -->|"sends event data"| node_event_model
node_api -->|"deserializes rankings"| node_ranking_model
node_api -->|"handles professor data"| node_prof_model
node_api -->|"sends change log"| node_log_model
node_app -.->|"registers tab navigation"| node_tab_icons

click node_app "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/App.xaml.cs"
click node_login "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/LoginPageViewModel.cs"
click node_main "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/MainPage2ViewModel.cs"
click node_profile "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/PerfilPageViewModel.cs"
click node_profprofile "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/PerfilProfessorViewModel.cs"
click node_professors "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/ProfessorPageViewModel.cs"
click node_lessons "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/AulasPageViewModel.cs"
click node_coachlessons "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/AulasProfessorPage2ViewModel.cs"
click node_edit "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/ModificaHorarioPageViewModel.cs"
click node_changes "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/ModificacoesViewModel.cs"
click node_ranking "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/RankingCategoriaViewModel.cs"
click node_base "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/ViewModelBase.cs"
click node_api "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Services/ApiService.cs"
click node_api_contract "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Interfaces/IApiService.cs"
click node_user_model "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/Usuario.cs"
click node_event_model "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/Events.cs"
click node_log_model "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/AulasLog.cs"
click node_prof_model "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/Professor.cs"
click node_ranking_model "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/Ranking.cs"
click node_response "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/Response.cs"
click node_tab_icons "https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Interfaces/ITabPageIcons.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_app,node_main,node_tab_icons,node_user toneBlue
class node_login,node_profile,node_profprofile,node_professors,node_ranking toneAmber
class node_lessons,node_coachlessons,node_edit,node_changes,node_backend toneMint
class node_base,node_api,node_api_contract,node_user_model,node_event_model,node_log_model,node_prof_model,node_ranking_model,node_response toneRose
```

## Components

### App and navigation

- [App startup](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/App.xaml.cs): `Aces/AcesApp/AcesApp/App.xaml.cs`
- [Main navigation](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/MainPage2ViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/MainPage2ViewModel.cs`
- [Tab icon contract](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Interfaces/ITabPageIcons.cs): `Aces/AcesApp/AcesApp/Interfaces/ITabPageIcons.cs`

### Accounts and profiles

- [Login flow](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/LoginPageViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/LoginPageViewModel.cs`
- [User profile](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/PerfilPageViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/PerfilPageViewModel.cs`
- [Professor profile](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/PerfilProfessorViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/PerfilProfessorViewModel.cs`
- [Professor directory](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/ProfessorPageViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/ProfessorPageViewModel.cs`
- [Rankings](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/RankingCategoriaViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/RankingCategoriaViewModel.cs`

### Classes and scheduling

- [User lessons](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/AulasPageViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/AulasPageViewModel.cs`
- [Professor lessons](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/AulasProfessorPage2ViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/AulasProfessorPage2ViewModel.cs`
- [Edit schedule](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/ModificaHorarioPageViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/ModificaHorarioPageViewModel.cs`
- [Schedule history](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/ModificacoesViewModel.cs): `Aces/AcesApp/AcesApp/ViewModels/ModificacoesViewModel.cs`

### API and domain types

- [View-model base](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/ViewModelBase.cs): `Aces/AcesApp/AcesApp/ViewModels/ViewModelBase.cs`
- [API client](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Services/ApiService.cs): `Aces/AcesApp/AcesApp/Services/ApiService.cs`
- [API contract](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Interfaces/IApiService.cs): `Aces/AcesApp/AcesApp/Interfaces/IApiService.cs`
- [User data](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/Usuario.cs): `Aces/AcesApp/AcesApp/Models/Usuario.cs`
- [Event data](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/Events.cs): `Aces/AcesApp/AcesApp/Models/Events.cs`
- [Lesson-change log](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/AulasLog.cs): `Aces/AcesApp/AcesApp/Models/AulasLog.cs`
- [Professor data](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/Professor.cs): `Aces/AcesApp/AcesApp/Models/Professor.cs`
- [Ranking data](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/Models/Ranking.cs): `Aces/AcesApp/AcesApp/Models/Ranking.cs`
- [API response](https://github.com/leodviana/acesapp/blob/main/Aces/AcesApp/AcesApp/ViewModels/Response.cs): `Aces/AcesApp/AcesApp/ViewModels/Response.cs`

### Other components

- **App user**
- **Application API**

## Connections

- App user → App startup: opens app (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → Login flow: routes when signed out (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → Main navigation: routes saved session (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → User profile: registers navigation (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → Professor profile: registers navigation (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → Professor directory: registers navigation (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → User lessons: registers navigation (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → Professor lessons: registers navigation (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → Edit schedule: registers navigation (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → Schedule history: registers navigation (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- App startup → Rankings: registers navigation (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- Login flow → API contract: uses API (evidence: `Aces/AcesApp/AcesApp/ViewModels/LoginPageViewModel.cs`)
- User profile → API contract: uses API (evidence: `Aces/AcesApp/AcesApp/ViewModels/PerfilPageViewModel.cs`)
- Professor profile → API contract: uses API (evidence: `Aces/AcesApp/AcesApp/ViewModels/PerfilProfessorViewModel.cs`)
- Professor directory → API contract: uses API (evidence: `Aces/AcesApp/AcesApp/ViewModels/ProfessorPageViewModel.cs`)
- User lessons → API contract: uses API (evidence: `Aces/AcesApp/AcesApp/ViewModels/AulasPageViewModel.cs`)
- Professor lessons → API contract: uses API (evidence: `Aces/AcesApp/AcesApp/ViewModels/AulasProfessorPage2ViewModel.cs`)
- Edit schedule → API contract: uses API (evidence: `Aces/AcesApp/AcesApp/ViewModels/ModificaHorarioPageViewModel.cs`)
- Schedule history → API contract: uses API (evidence: `Aces/AcesApp/AcesApp/ViewModels/ModificacoesViewModel.cs`)
- Rankings → API contract: uses API (evidence: `Aces/AcesApp/AcesApp/ViewModels/RankingCategoriaViewModel.cs`)
- API client → Application API: sends HTTP requests (evidence: `Aces/AcesApp/AcesApp/Services/ApiService.cs`)
- App startup → API client: registers service (evidence: `Aces/AcesApp/AcesApp/App.xaml.cs`)
- API client → API contract: implements (evidence: `Aces/AcesApp/AcesApp/Services/ApiService.cs`)
- User lessons → View-model base: inherits (evidence: `Aces/AcesApp/AcesApp/ViewModels/AulasPageViewModel.cs`)
- Professor lessons → View-model base: inherits (evidence: `Aces/AcesApp/AcesApp/ViewModels/AulasProfessorPage2ViewModel.cs`)
- Login flow → View-model base: inherits (evidence: `Aces/AcesApp/AcesApp/ViewModels/LoginPageViewModel.cs`)
- User profile → View-model base: inherits (evidence: `Aces/AcesApp/AcesApp/ViewModels/PerfilPageViewModel.cs`)
- Professor profile → View-model base: inherits (evidence: `Aces/AcesApp/AcesApp/ViewModels/PerfilProfessorViewModel.cs`)
- Edit schedule → View-model base: inherits (evidence: `Aces/AcesApp/AcesApp/ViewModels/ModificaHorarioPageViewModel.cs`)
- Schedule history → View-model base: inherits (evidence: `Aces/AcesApp/AcesApp/ViewModels/ModificacoesViewModel.cs`)
- Rankings → View-model base: inherits (evidence: `Aces/AcesApp/AcesApp/ViewModels/RankingCategoriaViewModel.cs`)
- API client → API response: returns results (evidence: `Aces/AcesApp/AcesApp/Services/ApiService.cs`)
- API client → User data: serializes user (evidence: `Aces/AcesApp/AcesApp/Services/ApiService.cs`)
- API client → Event data: sends event data (evidence: `Aces/AcesApp/AcesApp/Services/ApiService.cs`)
- API client → Ranking data: deserializes rankings (evidence: `Aces/AcesApp/AcesApp/Services/ApiService.cs`)
- API client → Professor data: handles professor data (evidence: `Aces/AcesApp/AcesApp/Services/ApiService.cs`)
- API client → Lesson-change log: sends change log (evidence: `Aces/AcesApp/AcesApp/Services/ApiService.cs`)
- App startup → Tab icon contract: registers tab navigation
