# svictorsena/property-manager architecture

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

- Interactive diagram: https://gitdiagram.com/svictorsena/property-manager
- Repository: https://github.com/svictorsena/property-manager

## Overview

Pinguinos is a property-rental management application with an Angular client and Spring backend. Users log in; owners can manage properties and tenants and access contract, payment, maintenance, reporting, and settings areas, while tenants have a dashboard. The backend supports authentication, invitation-based tenant registration, and property and tenant operations. The tree documents additional workspace pages, but their runtime behavior and client-to-server wiring were not sampled, so those links are not asserted.

Main entry points: [`backend/src/main/java/com/pinguinos/backend/service/AuthService.java`](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/AuthService.java) (Authentication service), [`backend/src/main/java/com/pinguinos/backend/service/TenantService.java`](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/TenantService.java) (Tenant operations), [`frontend/src/app/app.routes.ts`](https://github.com/svictorsena/property-manager/blob/master/frontend/src/app/app.routes.ts) (Route dispatch), [`backend/src/main/java/com/pinguinos/backend/service/InviteTokenService.java`](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/InviteTokenService.java) (Invitation tokens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_app["Angular app<br/>[app.ts]"]
  node_routes["Route dispatch<br/>[app.routes.ts]"]
end

subgraph group_auth["Authentication"]
  node_auth_ui["Login and register"]
  node_auth_client["Auth client service<br/>[auth-service.ts]"]
end

subgraph group_owner["Owner workspace"]
  node_owner_pages["Owner pages"]
end

subgraph group_tenant["Tenant workspace"]
  node_tenant_page["Tenant dashboard"]
end

subgraph group_backend["Backend services"]
  node_auth_controller["Auth endpoints"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_invite_controller["Invitation endpoints"]
  node_invite_service["Invitation tokens"]
  node_tenant_controller["Tenant endpoints"]
  node_tenant_service["Tenant operations<br/>[TenantService.java]"]
  node_property_controller["Property endpoints"]
  node_property_service["Property operations"]
  node_property_filter["Property query filter"]
  node_property_spec["Property specification"]
  node_tenant_filter["Tenant query filter"]
  node_tenant_spec["Tenant specification"]
  node_user_repo["User repository"]
  node_tenant_repo["Tenant repository"]
  node_invite_repo["Invitation repository"]
  node_property_repo["Property repository"]
  node_domain_models["Rental domain models"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_cookie["Cookie utilities<br/>[CookieUtil.java]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"configures"| node_routes
node_routes -->|"loads"| node_auth_ui
node_routes -->|"loads"| node_owner_pages
node_routes -->|"loads"| node_tenant_page
node_auth_ui -.->|"uses"| node_auth_client
node_auth_controller -->|"delegates"| node_auth_service
node_auth_controller -->|"looks up tokens"| node_invite_service
node_auth_service -->|"resolves owner"| node_invite_service
node_auth_service -->|"creates tenant"| node_tenant_service
node_auth_service -->|"reads users"| node_user_repo
node_auth_service -->|"creates token"| node_jwt
node_auth_service -->|"sets cookie"| node_cookie
node_invite_controller -->|"delegates"| node_invite_service
node_invite_service -->|"reads and writes"| node_invite_repo
node_tenant_controller -->|"delegates"| node_tenant_service
node_tenant_service -->|"queries tenants"| node_tenant_repo
node_tenant_service -->|"reads and saves"| node_user_repo
node_tenant_service -->|"builds filter"| node_tenant_filter
node_tenant_filter -->|"creates specification"| node_tenant_spec
node_property_controller -->|"delegates"| node_property_service
node_property_service -->|"queries and saves"| node_property_repo
node_property_service -->|"builds filter"| node_property_filter
node_property_filter -->|"creates specification"| node_property_spec
node_user_repo -->|"persists users"| node_domain_models
node_tenant_repo -->|"persists tenants"| node_domain_models
node_invite_repo -->|"persists invitations"| node_domain_models
node_property_repo -.->|"persists properties"| node_domain_models

click node_app "https://github.com/svictorsena/property-manager/blob/master/frontend/src/app/app.ts"
click node_routes "https://github.com/svictorsena/property-manager/blob/master/frontend/src/app/app.routes.ts"
click node_auth_ui "https://github.com/svictorsena/property-manager/tree/master/frontend/src/app/features/auth/presentation/pages"
click node_auth_client "https://github.com/svictorsena/property-manager/blob/master/frontend/src/app/features/auth/services/auth-service.ts"
click node_owner_pages "https://github.com/svictorsena/property-manager/tree/master/frontend/src/app/features/owner/presentation/pages"
click node_tenant_page "https://github.com/svictorsena/property-manager/blob/master/frontend/src/app/features/tenant/presentation/pages/dashboard/tenant-dashboard.ts"
click node_auth_controller "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/controller/AuthController.java"
click node_auth_service "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/AuthService.java"
click node_invite_controller "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/controller/InviteTokenController.java"
click node_invite_service "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/InviteTokenService.java"
click node_tenant_controller "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/controller/OwnerController.java"
click node_tenant_service "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/TenantService.java"
click node_property_controller "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/controller/PropertyController.java"
click node_property_service "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/PropertyService.java"
click node_property_filter "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/queryFilter/PropertyQueryFilter.java"
click node_property_spec "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/specification/PropertySpecification.java"
click node_tenant_filter "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/queryFilter/TenantQueryFilter.java"
click node_tenant_spec "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/specification/TenantSpecification.java"
click node_user_repo "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/UserRepository.java"
click node_tenant_repo "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/TenantRepository.java"
click node_invite_repo "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/InviteTokenRepository.java"
click node_property_repo "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/PropertyRepository.java"
click node_domain_models "https://github.com/svictorsena/property-manager/tree/master/backend/src/main/java/com/pinguinos/backend/model"
click node_jwt "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/util/JwtUtil.java"
click node_cookie "https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/util/CookieUtil.java"

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_routes,node_user toneBlue
class node_auth_ui,node_auth_client toneAmber
class node_owner_pages toneMint
class node_tenant_page toneRose
class node_auth_controller,node_auth_service,node_invite_controller,node_invite_service,node_tenant_controller,node_tenant_service,node_property_controller,node_property_service,node_property_filter,node_property_spec,node_tenant_filter,node_tenant_spec,node_user_repo,node_tenant_repo,node_invite_repo,node_property_repo,node_domain_models,node_jwt,node_cookie toneIndigo
```

## Components

### Angular client

- [Angular app](https://github.com/svictorsena/property-manager/blob/master/frontend/src/app/app.ts): `frontend/src/app/app.ts`
- [Route dispatch](https://github.com/svictorsena/property-manager/blob/master/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`

### Authentication

- [Login and register](https://github.com/svictorsena/property-manager/tree/master/frontend/src/app/features/auth/presentation/pages): `frontend/src/app/features/auth/presentation/pages`
- [Auth client service](https://github.com/svictorsena/property-manager/blob/master/frontend/src/app/features/auth/services/auth-service.ts): `frontend/src/app/features/auth/services/auth-service.ts`

### Owner workspace

- [Owner pages](https://github.com/svictorsena/property-manager/tree/master/frontend/src/app/features/owner/presentation/pages): `frontend/src/app/features/owner/presentation/pages`

### Tenant workspace

- [Tenant dashboard](https://github.com/svictorsena/property-manager/blob/master/frontend/src/app/features/tenant/presentation/pages/dashboard/tenant-dashboard.ts): `frontend/src/app/features/tenant/presentation/pages/dashboard/tenant-dashboard.ts`

### Backend services

- [Auth endpoints](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/controller/AuthController.java): `backend/src/main/java/com/pinguinos/backend/controller/AuthController.java`
- [Authentication service](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/AuthService.java): `backend/src/main/java/com/pinguinos/backend/service/AuthService.java`
- [Invitation endpoints](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/controller/InviteTokenController.java): `backend/src/main/java/com/pinguinos/backend/controller/InviteTokenController.java`
- [Invitation tokens](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/InviteTokenService.java): `backend/src/main/java/com/pinguinos/backend/service/InviteTokenService.java`
- [Tenant endpoints](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/controller/OwnerController.java): `backend/src/main/java/com/pinguinos/backend/controller/OwnerController.java`
- [Tenant operations](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/TenantService.java): `backend/src/main/java/com/pinguinos/backend/service/TenantService.java`
- [Property endpoints](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/controller/PropertyController.java): `backend/src/main/java/com/pinguinos/backend/controller/PropertyController.java`
- [Property operations](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/service/PropertyService.java): `backend/src/main/java/com/pinguinos/backend/service/PropertyService.java`
- [Property query filter](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/queryFilter/PropertyQueryFilter.java): `backend/src/main/java/com/pinguinos/backend/repository/queryFilter/PropertyQueryFilter.java`
- [Property specification](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/specification/PropertySpecification.java): `backend/src/main/java/com/pinguinos/backend/repository/specification/PropertySpecification.java`
- [Tenant query filter](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/queryFilter/TenantQueryFilter.java): `backend/src/main/java/com/pinguinos/backend/repository/queryFilter/TenantQueryFilter.java`
- [Tenant specification](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/specification/TenantSpecification.java): `backend/src/main/java/com/pinguinos/backend/repository/specification/TenantSpecification.java`
- [User repository](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/UserRepository.java): `backend/src/main/java/com/pinguinos/backend/repository/UserRepository.java`
- [Tenant repository](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/TenantRepository.java): `backend/src/main/java/com/pinguinos/backend/repository/TenantRepository.java`
- [Invitation repository](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/InviteTokenRepository.java): `backend/src/main/java/com/pinguinos/backend/repository/InviteTokenRepository.java`
- [Property repository](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/repository/PropertyRepository.java): `backend/src/main/java/com/pinguinos/backend/repository/PropertyRepository.java`
- [Rental domain models](https://github.com/svictorsena/property-manager/tree/master/backend/src/main/java/com/pinguinos/backend/model): `backend/src/main/java/com/pinguinos/backend/model`
- [JWT utilities](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/util/JwtUtil.java): `backend/src/main/java/com/pinguinos/backend/util/JwtUtil.java`
- [Cookie utilities](https://github.com/svictorsena/property-manager/blob/master/backend/src/main/java/com/pinguinos/backend/util/CookieUtil.java): `backend/src/main/java/com/pinguinos/backend/util/CookieUtil.java`

### Other components

- **User**

## Connections

- User → Angular app: uses
- Angular app → Route dispatch: configures
- Route dispatch → Login and register: loads (evidence: `frontend/src/app/app.routes.ts`)
- Route dispatch → Owner pages: loads (evidence: `frontend/src/app/app.routes.ts`)
- Route dispatch → Tenant dashboard: loads (evidence: `frontend/src/app/app.routes.ts`)
- Login and register → Auth client service: uses
- Auth endpoints → Authentication service: delegates (evidence: `backend/src/main/java/com/pinguinos/backend/controller/AuthController.java`)
- Auth endpoints → Invitation tokens: looks up tokens (evidence: `backend/src/main/java/com/pinguinos/backend/controller/AuthController.java`)
- Authentication service → Invitation tokens: resolves owner (evidence: `backend/src/main/java/com/pinguinos/backend/service/AuthService.java`)
- Authentication service → Tenant operations: creates tenant (evidence: `backend/src/main/java/com/pinguinos/backend/service/AuthService.java`)
- Authentication service → User repository: reads users (evidence: `backend/src/main/java/com/pinguinos/backend/service/AuthService.java`)
- Authentication service → JWT utilities: creates token (evidence: `backend/src/main/java/com/pinguinos/backend/service/AuthService.java`)
- Authentication service → Cookie utilities: sets cookie (evidence: `backend/src/main/java/com/pinguinos/backend/service/AuthService.java`)
- Invitation endpoints → Invitation tokens: delegates (evidence: `backend/src/main/java/com/pinguinos/backend/controller/InviteTokenController.java`)
- Invitation tokens → Invitation repository: reads and writes (evidence: `backend/src/main/java/com/pinguinos/backend/service/InviteTokenService.java`)
- Tenant endpoints → Tenant operations: delegates (evidence: `backend/src/main/java/com/pinguinos/backend/controller/OwnerController.java`)
- Tenant operations → Tenant repository: queries tenants (evidence: `backend/src/main/java/com/pinguinos/backend/service/TenantService.java`)
- Tenant operations → User repository: reads and saves (evidence: `backend/src/main/java/com/pinguinos/backend/service/TenantService.java`)
- Tenant operations → Tenant query filter: builds filter (evidence: `backend/src/main/java/com/pinguinos/backend/service/TenantService.java`)
- Tenant query filter → Tenant specification: creates specification (evidence: `backend/src/main/java/com/pinguinos/backend/repository/queryFilter/TenantQueryFilter.java`)
- Property endpoints → Property operations: delegates (evidence: `backend/src/main/java/com/pinguinos/backend/controller/PropertyController.java`)
- Property operations → Property repository: queries and saves (evidence: `backend/src/main/java/com/pinguinos/backend/service/PropertyService.java`)
- Property operations → Property query filter: builds filter (evidence: `backend/src/main/java/com/pinguinos/backend/service/PropertyService.java`)
- Property query filter → Property specification: creates specification (evidence: `backend/src/main/java/com/pinguinos/backend/repository/queryFilter/PropertyQueryFilter.java`)
- User repository → Rental domain models: persists users (evidence: `backend/src/main/java/com/pinguinos/backend/repository/UserRepository.java`)
- Tenant repository → Rental domain models: persists tenants (evidence: `backend/src/main/java/com/pinguinos/backend/repository/TenantRepository.java`)
- Invitation repository → Rental domain models: persists invitations (evidence: `backend/src/main/java/com/pinguinos/backend/repository/InviteTokenRepository.java`)
- Property repository → Rental domain models: persists properties
