How simbaste/residmanager works
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.kt App router · LoginViewModel.kt Session and feature state · AppRoutes.kt Management routes · repository API repositories
Components 23
Multiplatform clients
- Android entry
app/androidApp/src/main/kotlin/com/resid/manager/MainActivity.kt - iOS entry
app/iosApp/iosApp/ContentView.swift - Web entry
app/webApp/src/webMain/kotlin/com/resid/manager/main.kt
Shared client
- App router
app/shared/src/commonMain/kotlin/com/resid/manager/App.kt - Sign-in and registration
app/shared/src/commonMain/kotlin/com/resid/manager/ui - Management shell
app/shared/src/commonMain/kotlin/com/resid/manager/ui/AppShell.kt - Residence features
app/shared/src/commonMain/kotlin/com/resid/manager/ui - Session and feature state
app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt - Auth validation
app/shared/src/commonMain/kotlin/com/resid/manager/validation/AuthValidator.kt - Session storage
app/shared/src/commonMain/kotlin/com/resid/manager/SessionStorage.kt - API repositories
app/shared/src/commonMain/kotlin/com/resid/manager/repository - HTTP client
app/shared/src/commonMain/kotlin/com/resid/manager/network/ApiClient.kt - Request and response DTOs
app/shared/src/commonMain/kotlin/com/resid/manager/dto
Server API
- Ktor application
server/src/main/kotlin/com/resid/manager/Application.kt - Authentication routes
server/src/main/kotlin/com/resid/manager/routes/AuthRoutes.kt - Management routes
server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt - JWT configuration
server/src/main/kotlin/com/resid/manager/auth/JwtConfig.kt
Domain and persistence
- Domain services
server/src/main/kotlin/com/resid/manager/service - Ticket operations
server/src/main/kotlin/com/resid/manager/service/TicketService.kt - Finance operations
server/src/main/kotlin/com/resid/manager/service/FinanceOperationService.kt - Database schema
server/src/main/kotlin/com/resid/manager/data/DatabaseSchema.kt
Other components
- Resident
- Configured database
Connections 28
- Resident → Android entry: uses
- Resident → iOS entry: uses
- Resident → Web entry: uses
- Android entry → App router: starts
app/androidApp/src/main/kotlin/com/resid/manager/MainActivity.kt - iOS entry → App router: hosts
- Web entry → App router: starts
app/webApp/src/webMain/kotlin/com/resid/manager/main.kt - App router → Sign-in and registration: shows
app/shared/src/commonMain/kotlin/com/resid/manager/App.kt - App router → Management shell: shows
app/shared/src/commonMain/kotlin/com/resid/manager/App.kt - App router → Session and feature state: resolves
app/shared/src/commonMain/kotlin/com/resid/manager/App.kt - Sign-in and registration → Session and feature state: uses
app/shared/src/commonMain/kotlin/com/resid/manager/ui/AppShell.kt - Session and feature state → Auth validation: validates with
app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt - Session and feature state → Session storage: uses
app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt - Management shell → Residence features: hosts
app/shared/src/commonMain/kotlin/com/resid/manager/ui/AppShell.kt - Session and feature state → API repositories: requests data
app/shared/src/commonMain/kotlin/com/resid/manager/viewmodel/LoginViewModel.kt - API repositories → HTTP client: sends requests
app/shared/src/commonMain/kotlin/com/resid/manager/repository/AuthRepository.kt - API repositories → Request and response DTOs: encodes and decodes
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
server/src/main/kotlin/com/resid/manager/Application.kt - Ktor application → Management routes: registers
server/src/main/kotlin/com/resid/manager/Application.kt - Authentication routes → JWT configuration: uses
server/src/main/kotlin/com/resid/manager/routes/AuthRoutes.kt - Management routes → JWT configuration: uses
server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt - Management routes → Domain services: dispatches to
server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt - Management routes → Request and response DTOs: reads and returns
server/src/main/kotlin/com/resid/manager/routes/AppRoutes.kt - Ticket operations → Database schema: queries and writes
server/src/main/kotlin/com/resid/manager/service/TicketService.kt - Finance operations → Database schema: queries and writes
server/src/main/kotlin/com/resid/manager/service/FinanceOperationService.kt - Ktor application → Configured database: connects
server/src/main/kotlin/com/resid/manager/Application.kt - Database schema → Configured database: defines tables for