# simbaste/residmanager architecture

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

- Interactive diagram: https://gitdiagram.com/simbaste/residmanager
- Repository: https://github.com/simbaste/residmanager

## Overview

Resid Manager is a multiplatform residence-management client backed by a Ktor server. Users enter through a platform app, authenticate, and work in a shared app shell to manage residences and related housing, membership, leases, tickets, electricity, and finances. The client sends API requests to server routes, which apply domain operations and use persistent data. The graph includes documented UI and server capabilities, but several page and service implementations were not sampled; their internal links are omitted where call ownership cannot be verified.

Main entry points: [`app/shared/src/commonMain/kotlin/com/resid/manager/App.kt`](https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/App.kt) (App router), [`app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt`](https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt) (Session and feature state), [`server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt`](https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt) (Management routes), [`app/shared/src/commonMain/kotlin/com/resid/manager/repository`](https://github.com/simbaste/residmanager/tree/main/app/shared/src/commonMain/kotlin/com/resid/manager/repository) (API repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Multiplatform clients"]
  node_android["Android entry<br/>[MainActivity.kt]"]
  node_ios["iOS entry<br/>[ContentView.swift]"]
  node_web["Web entry<br/>[main.kt]"]
end

subgraph group_shared["Shared client"]
  node_app["App router<br/>[App.kt]"]
  node_authui["Sign-in and registration"]
  node_shell["Management shell<br/>[AppShell.kt]"]
  node_featureui["Residence features"]
  node_loginvm["Session and feature state<br/>[LoginViewModel.kt]"]
  node_validation["Auth validation<br/>[AuthValidator.kt]"]
  node_session["Session storage<br/>[SessionStorage.kt]"]
  node_repositories["API repositories"]
  node_api["HTTP client<br/>[ApiClient.kt]"]
  node_dtos["Request and response DTOs"]
end

subgraph group_server["Server API"]
  node_serverapp["Ktor application<br/>[Application.kt]"]
  node_authroutes["Authentication routes<br/>[AuthRoutes.kt]"]
  node_routes["Management routes<br/>[AppRoutes.kt]"]
  node_jwt["JWT configuration<br/>[JwtConfig.kt]"]
end

subgraph group_domain["Domain and persistence"]
  node_services["Domain services"]
  node_ticketservice["Ticket operations<br/>[TicketService.kt]"]
  node_financeservice["Finance operations"]
  node_dbschema[("Database schema<br/>[DatabaseSchema.kt]")]
end

node_resident(("Resident"))
node_database[("Configured database")]

node_resident -->|"uses"| node_android
node_resident -->|"uses"| node_ios
node_resident -->|"uses"| node_web
node_android -->|"starts"| node_app
node_ios -->|"hosts"| node_app
node_web -->|"starts"| node_app
node_app -->|"shows"| node_authui
node_app -->|"shows"| node_shell
node_app -->|"resolves"| node_loginvm
node_authui -.->|"uses"| node_loginvm
node_loginvm -.->|"validates with"| node_validation
node_loginvm -.->|"uses"| node_session
node_shell -.->|"hosts"| node_featureui
node_loginvm -->|"requests data"| node_repositories
node_repositories -->|"sends requests"| node_api
node_repositories -->|"encodes and decodes"| node_dtos
node_repositories -.->|"calls API"| node_routes
node_api -.->|"connects to"| node_serverapp
node_serverapp -->|"registers"| node_authroutes
node_serverapp -->|"registers"| node_routes
node_authroutes -->|"uses"| node_jwt
node_routes -->|"uses"| node_jwt
node_routes -->|"dispatches to"| node_services
node_routes -->|"reads and returns"| node_dtos
node_ticketservice -->|"queries and writes"| node_dbschema
node_financeservice -->|"queries and writes"| node_dbschema
node_serverapp -->|"connects"| node_database
node_dbschema -.->|"defines tables for"| node_database

click node_android "https://github.com/simbaste/residmanager/blob/main/app/androidApp/src/main/kotlin/com/resid/manager/MainActivity.kt"
click node_ios "https://github.com/simbaste/residmanager/blob/main/app/iosApp/iosApp/ContentView.swift"
click node_web "https://github.com/simbaste/residmanager/blob/main/app/webApp/src/webMain/kotlin/com/resid/manager/main.kt"
click node_app "https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/App.kt"
click node_authui "https://github.com/simbaste/residmanager/tree/main/app/shared/src/commonMain/kotlin/com/resid/manager/ui"
click node_shell "https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/ui/AppShell.kt"
click node_featureui "https://github.com/simbaste/residmanager/tree/main/app/shared/src/commonMain/kotlin/com/resid/manager/ui"
click node_loginvm "https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt"
click node_validation "https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/validation/AuthValidator.kt"
click node_session "https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/SessionStorage.kt"
click node_repositories "https://github.com/simbaste/residmanager/tree/main/app/shared/src/commonMain/kotlin/com/resid/manager/repository"
click node_api "https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/network/ApiClient.kt"
click node_dtos "https://github.com/simbaste/residmanager/tree/main/app/shared/src/commonMain/kotlin/com/resid/manager/dto"
click node_serverapp "https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/Application.kt"
click node_authroutes "https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/routes/AuthRoutes.kt"
click node_routes "https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt"
click node_jwt "https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/auth/JwtConfig.kt"
click node_services "https://github.com/simbaste/residmanager/tree/main/server/src/main/kotlin/com/resid/manager/service"
click node_ticketservice "https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/service/TicketService.kt"
click node_financeservice "https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/service/FinanceOperationService.kt"
click node_dbschema "https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/data/DatabaseSchema.kt"

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_android,node_ios,node_web toneBlue
class node_app,node_authui,node_shell,node_featureui,node_loginvm,node_validation,node_session,node_repositories,node_api,node_dtos,node_database toneAmber
class node_serverapp,node_authroutes,node_routes,node_jwt toneMint
class node_services,node_ticketservice,node_financeservice,node_dbschema toneRose
class node_resident toneIndigo
```

## Components

### Multiplatform clients

- [Android entry](https://github.com/simbaste/residmanager/blob/main/app/androidApp/src/main/kotlin/com/resid/manager/MainActivity.kt): `app/androidApp/src/main/kotlin/com/resid/manager/MainActivity.kt`
- [iOS entry](https://github.com/simbaste/residmanager/blob/main/app/iosApp/iosApp/ContentView.swift): `app/iosApp/iosApp/ContentView.swift`
- [Web entry](https://github.com/simbaste/residmanager/blob/main/app/webApp/src/webMain/kotlin/com/resid/manager/main.kt): `app/webApp/src/webMain/kotlin/com/resid/manager/main.kt`

### Shared client

- [App router](https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/App.kt): `app/shared/src/commonMain/kotlin/com/resid/manager/App.kt`
- [Sign-in and registration](https://github.com/simbaste/residmanager/tree/main/app/shared/src/commonMain/kotlin/com/resid/manager/ui): `app/shared/src/commonMain/kotlin/com/resid/manager/ui`
- [Management shell](https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/ui/AppShell.kt): `app/shared/src/commonMain/kotlin/com/resid/manager/ui/AppShell.kt`
- [Residence features](https://github.com/simbaste/residmanager/tree/main/app/shared/src/commonMain/kotlin/com/resid/manager/ui): `app/shared/src/commonMain/kotlin/com/resid/manager/ui`
- [Session and feature state](https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt): `app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt`
- [Auth validation](https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/validation/AuthValidator.kt): `app/shared/src/commonMain/kotlin/com/resid/manager/validation/AuthValidator.kt`
- [Session storage](https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/SessionStorage.kt): `app/shared/src/commonMain/kotlin/com/resid/manager/SessionStorage.kt`
- [API repositories](https://github.com/simbaste/residmanager/tree/main/app/shared/src/commonMain/kotlin/com/resid/manager/repository): `app/shared/src/commonMain/kotlin/com/resid/manager/repository`
- [HTTP client](https://github.com/simbaste/residmanager/blob/main/app/shared/src/commonMain/kotlin/com/resid/manager/network/ApiClient.kt): `app/shared/src/commonMain/kotlin/com/resid/manager/network/ApiClient.kt`
- [Request and response DTOs](https://github.com/simbaste/residmanager/tree/main/app/shared/src/commonMain/kotlin/com/resid/manager/dto): `app/shared/src/commonMain/kotlin/com/resid/manager/dto`

### Server API

- [Ktor application](https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/Application.kt): `server/src/main/kotlin/com/resid/manager/Application.kt`
- [Authentication routes](https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/routes/AuthRoutes.kt): `server/src/main/kotlin/com/resid/manager/routes/AuthRoutes.kt`
- [Management routes](https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt): `server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt`
- [JWT configuration](https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/auth/JwtConfig.kt): `server/src/main/kotlin/com/resid/manager/auth/JwtConfig.kt`

### Domain and persistence

- [Domain services](https://github.com/simbaste/residmanager/tree/main/server/src/main/kotlin/com/resid/manager/service): `server/src/main/kotlin/com/resid/manager/service`
- [Ticket operations](https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/service/TicketService.kt): `server/src/main/kotlin/com/resid/manager/service/TicketService.kt`
- [Finance operations](https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/service/FinanceOperationService.kt): `server/src/main/kotlin/com/resid/manager/service/FinanceOperationService.kt`
- [Database schema](https://github.com/simbaste/residmanager/blob/main/server/src/main/kotlin/com/resid/manager/data/DatabaseSchema.kt): `server/src/main/kotlin/com/resid/manager/data/DatabaseSchema.kt`

### Other components

- **Resident**
- **Configured database**

## Connections

- Resident → Android entry: uses
- Resident → iOS entry: uses
- Resident → Web entry: uses
- Android entry → App router: starts (evidence: `app/androidApp/src/main/kotlin/com/resid/manager/MainActivity.kt`)
- iOS entry → App router: hosts
- Web entry → App router: starts (evidence: `app/webApp/src/webMain/kotlin/com/resid/manager/main.kt`)
- App router → Sign-in and registration: shows (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/App.kt`)
- App router → Management shell: shows (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/App.kt`)
- App router → Session and feature state: resolves (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/App.kt`)
- Sign-in and registration → Session and feature state: uses (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/ui/AppShell.kt`)
- Session and feature state → Auth validation: validates with (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt`)
- Session and feature state → Session storage: uses (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt`)
- Management shell → Residence features: hosts (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/ui/AppShell.kt`)
- Session and feature state → API repositories: requests data (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt`)
- API repositories → HTTP client: sends requests (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/repository/AuthRepository.kt`)
- API repositories → Request and response DTOs: encodes and decodes (evidence: `app/shared/src/commonMain/kotlin/com/resid/manager/repository/AuthRepository.kt`)
- API repositories → Management routes: calls API
- HTTP client → Ktor application: connects to
- Ktor application → Authentication routes: registers (evidence: `server/src/main/kotlin/com/resid/manager/Application.kt`)
- Ktor application → Management routes: registers (evidence: `server/src/main/kotlin/com/resid/manager/Application.kt`)
- Authentication routes → JWT configuration: uses (evidence: `server/src/main/kotlin/com/resid/manager/routes/AuthRoutes.kt`)
- Management routes → JWT configuration: uses (evidence: `server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt`)
- Management routes → Domain services: dispatches to (evidence: `server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt`)
- Management routes → Request and response DTOs: reads and returns (evidence: `server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt`)
- Ticket operations → Database schema: queries and writes (evidence: `server/src/main/kotlin/com/resid/manager/service/TicketService.kt`)
- Finance operations → Database schema: queries and writes (evidence: `server/src/main/kotlin/com/resid/manager/service/FinanceOperationService.kt`)
- Ktor application → Configured database: connects (evidence: `server/src/main/kotlin/com/resid/manager/Application.kt`)
- Database schema → Configured database: defines tables for
