# shreshth02/trackmysubs architecture

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

- Interactive diagram: https://gitdiagram.com/shreshth02/trackmysubs
- Repository: https://github.com/shreshth02/trackmysubs

## Overview

TrackMySubs is a subscription-tracking web app: users register or log in, then manage subscriptions and view billing and spending summaries. Angular components call frontend services, which make HTTP requests to the Spring API; backend services handle user and subscription operations, backed by persistence and authentication support. The README names PostgreSQL and Redis, and the sampled login service directly uses Redis for failed-login limits. Some backend security wiring and route details are unsampled, so those relationships are shown only where documented or left out.

Main entry points: [`trackmysubs-backend/src/main/java/com/trackmysubs/service/UserService.java`](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/service/UserService.java) (User operations), [`trackmysubs-backend/src/main/java/com/trackmysubs/service/SubscriptionService.java`](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/service/SubscriptionService.java) (Subscription operations), [`trackmysubs-backend/src/main/java/com/trackmysubs/service/AuthService.java`](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/service/AuthService.java) (Login and rate limits), [`trackmysubs-frontend/src/app/services/auth.service.ts`](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/services/auth.service.ts) (Auth client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Angular client"]
  node_login_ui["Login and registration<br/>[login.component.ts]"]
  node_dashboard["Dashboard"]
  node_sub_form["Subscription form"]
  node_auth_front["Auth client<br/>[auth.service.ts]"]
  node_sub_front["Subscription client"]
  node_guard["Route guard<br/>[auth.guard.ts]"]
  node_interceptor["Auth interceptor"]
  node_sub_model["Subscription model"]
end

subgraph group_api["Spring API"]
  node_auth_controller["Auth endpoints"]
  node_user_controller["User endpoints"]
  node_sub_controller["Subscription endpoints"]
  node_api_user["API user<br/>[UserResponse.java]"]
  node_api_sub["API subscription"]
end

subgraph group_domain["User and subscriptions"]
  node_user_service["User operations<br/>[UserService.java]"]
  node_sub_service["Subscription operations"]
  node_user_repo["User repository"]
  node_sub_repo["Subscription repository"]
  node_user_entity["User record<br/>[User.java]"]
  node_sub_entity["Subscription record<br/>[Subscription.java]"]
end

subgraph group_auth["Authentication"]
  node_auth_service["Login and rate limits<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_security_filter["JWT filter and security"]
end

node_visitor(("User"))
node_postgres[("PostgreSQL")]
node_redis[("Redis")]

node_visitor -->|"signs in"| node_login_ui
node_visitor -.->|"manages plans"| node_dashboard
node_login_ui -->|"submits credentials"| node_auth_front
node_dashboard -->|"loads and edits"| node_sub_front
node_sub_form -->|"uses fields"| node_sub_model
node_dashboard -->|"displays plans"| node_sub_model
node_guard -->|"checks session"| node_auth_front
node_interceptor -->|"gets token"| node_auth_front
node_auth_front -.->|"HTTP auth requests"| node_auth_controller
node_sub_front -.->|"HTTP subscription requests"| node_sub_controller
node_auth_controller -->|"delegates login"| node_auth_service
node_user_controller -->|"delegates user actions"| node_user_service
node_sub_controller -->|"delegates requests"| node_sub_service
node_user_service -->|"reads and saves"| node_user_repo
node_sub_service -->|"reads and saves"| node_sub_repo
node_sub_service -->|"resolves owner"| node_user_repo
node_user_repo -->|"stores"| node_user_entity
node_sub_repo -->|"stores"| node_sub_entity
node_user_entity -.->|"persisted data"| node_postgres
node_sub_entity -.->|"persisted data"| node_postgres
node_auth_service -->|"finds account"| node_user_repo
node_auth_service -->|"generates token"| node_jwt
node_auth_service -->|"tracks login failures"| node_redis
node_user_service -->|"generates registration token"| node_jwt
node_security_filter -.->|"validates token"| node_jwt
node_sub_service -->|"returns subscription data"| node_api_sub
node_user_service -->|"returns profile data"| node_api_user

click node_login_ui "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/components/login/login.component.ts"
click node_dashboard "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/components/dashboard/dashboard.component.ts"
click node_sub_form "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/components/subscription-form/subscription-form.component.ts"
click node_auth_front "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/services/auth.service.ts"
click node_sub_front "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/services/subscription.service.ts"
click node_guard "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/guards/auth.guard.ts"
click node_interceptor "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/interceptors/auth.interceptor.ts"
click node_sub_model "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/models/subscription.model.ts"
click node_auth_controller "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/controller/AuthController.java"
click node_user_controller "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/controller/UserController.java"
click node_sub_controller "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/controller/SubscriptionController.java"
click node_user_service "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/service/UserService.java"
click node_sub_service "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/service/SubscriptionService.java"
click node_user_repo "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/repository/UserRepository.java"
click node_sub_repo "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/repository/SubscriptionRepository.java"
click node_user_entity "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/entity/User.java"
click node_sub_entity "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/entity/Subscription.java"
click node_auth_service "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/service/AuthService.java"
click node_jwt "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/security/JwtService.java"
click node_security_filter "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/security/JwtAuthenticationFilter.java"
click node_api_user "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/dto/UserResponse.java"
click node_api_sub "https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/dto/SubscriptionResponse.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_login_ui,node_dashboard,node_sub_form,node_auth_front,node_sub_front,node_guard,node_interceptor,node_sub_model,node_visitor toneBlue
class node_auth_controller,node_user_controller,node_sub_controller,node_api_user,node_api_sub,node_postgres,node_redis toneAmber
class node_user_service,node_sub_service,node_user_repo,node_sub_repo,node_user_entity,node_sub_entity toneMint
class node_auth_service,node_jwt,node_security_filter toneRose
```

## Components

### Angular client

- [Login and registration](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/components/login/login.component.ts): `trackmysubs-frontend/src/app/components/login/login.component.ts`
- [Dashboard](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/components/dashboard/dashboard.component.ts): `trackmysubs-frontend/src/app/components/dashboard/dashboard.component.ts`
- [Subscription form](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/components/subscription-form/subscription-form.component.ts): `trackmysubs-frontend/src/app/components/subscription-form/subscription-form.component.ts`
- [Auth client](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/services/auth.service.ts): `trackmysubs-frontend/src/app/services/auth.service.ts`
- [Subscription client](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/services/subscription.service.ts): `trackmysubs-frontend/src/app/services/subscription.service.ts`
- [Route guard](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/guards/auth.guard.ts): `trackmysubs-frontend/src/app/guards/auth.guard.ts`
- [Auth interceptor](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/interceptors/auth.interceptor.ts): `trackmysubs-frontend/src/app/interceptors/auth.interceptor.ts`
- [Subscription model](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-frontend/src/app/models/subscription.model.ts): `trackmysubs-frontend/src/app/models/subscription.model.ts`

### Spring API

- [Auth endpoints](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/controller/AuthController.java): `trackmysubs-backend/src/main/java/com/trackmysubs/controller/AuthController.java`
- [User endpoints](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/controller/UserController.java): `trackmysubs-backend/src/main/java/com/trackmysubs/controller/UserController.java`
- [Subscription endpoints](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/controller/SubscriptionController.java): `trackmysubs-backend/src/main/java/com/trackmysubs/controller/SubscriptionController.java`
- [API user](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/dto/UserResponse.java): `trackmysubs-backend/src/main/java/com/trackmysubs/dto/UserResponse.java`
- [API subscription](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/dto/SubscriptionResponse.java): `trackmysubs-backend/src/main/java/com/trackmysubs/dto/SubscriptionResponse.java`

### User and subscriptions

- [User operations](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/service/UserService.java): `trackmysubs-backend/src/main/java/com/trackmysubs/service/UserService.java`
- [Subscription operations](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/service/SubscriptionService.java): `trackmysubs-backend/src/main/java/com/trackmysubs/service/SubscriptionService.java`
- [User repository](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/repository/UserRepository.java): `trackmysubs-backend/src/main/java/com/trackmysubs/repository/UserRepository.java`
- [Subscription repository](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/repository/SubscriptionRepository.java): `trackmysubs-backend/src/main/java/com/trackmysubs/repository/SubscriptionRepository.java`
- [User record](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/entity/User.java): `trackmysubs-backend/src/main/java/com/trackmysubs/entity/User.java`
- [Subscription record](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/entity/Subscription.java): `trackmysubs-backend/src/main/java/com/trackmysubs/entity/Subscription.java`

### Authentication

- [Login and rate limits](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/service/AuthService.java): `trackmysubs-backend/src/main/java/com/trackmysubs/service/AuthService.java`
- [JWT service](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/security/JwtService.java): `trackmysubs-backend/src/main/java/com/trackmysubs/security/JwtService.java`
- [JWT filter and security](https://github.com/shreshth02/trackmysubs/blob/main/trackmysubs-backend/src/main/java/com/trackmysubs/security/JwtAuthenticationFilter.java): `trackmysubs-backend/src/main/java/com/trackmysubs/security/JwtAuthenticationFilter.java`

### Other components

- **User**
- **PostgreSQL**
- **Redis**

## Connections

- User → Login and registration: signs in
- User → Dashboard: manages plans
- Login and registration → Auth client: submits credentials (evidence: `trackmysubs-frontend/src/app/components/login/login.component.ts`)
- Dashboard → Subscription client: loads and edits (evidence: `trackmysubs-frontend/src/app/components/dashboard/dashboard.component.ts`)
- Subscription form → Subscription model: uses fields (evidence: `trackmysubs-frontend/src/app/components/subscription-form/subscription-form.component.ts`)
- Dashboard → Subscription model: displays plans (evidence: `trackmysubs-frontend/src/app/components/dashboard/dashboard.component.ts`)
- Route guard → Auth client: checks session (evidence: `trackmysubs-frontend/src/app/guards/auth.guard.ts`)
- Auth interceptor → Auth client: gets token (evidence: `trackmysubs-frontend/src/app/interceptors/auth.interceptor.ts`)
- Auth client → Auth endpoints: HTTP auth requests
- Subscription client → Subscription endpoints: HTTP subscription requests
- Auth endpoints → Login and rate limits: delegates login (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/controller/AuthController.java`)
- User endpoints → User operations: delegates user actions (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/controller/UserController.java`)
- Subscription endpoints → Subscription operations: delegates requests (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/controller/SubscriptionController.java`)
- User operations → User repository: reads and saves (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/service/UserService.java`)
- Subscription operations → Subscription repository: reads and saves (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/service/SubscriptionService.java`)
- Subscription operations → User repository: resolves owner (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/service/SubscriptionService.java`)
- User repository → User record: stores (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/repository/UserRepository.java`)
- Subscription repository → Subscription record: stores (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/repository/SubscriptionRepository.java`)
- User record → PostgreSQL: persisted data
- Subscription record → PostgreSQL: persisted data
- Login and rate limits → User repository: finds account (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/service/AuthService.java`)
- Login and rate limits → JWT service: generates token (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/service/AuthService.java`)
- Login and rate limits → Redis: tracks login failures (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/service/AuthService.java`)
- User operations → JWT service: generates registration token (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/service/UserService.java`)
- JWT filter and security → JWT service: validates token (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/security/JwtAuthenticationFilter.java`)
- Subscription operations → API subscription: returns subscription data (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/service/SubscriptionService.java`)
- User operations → API user: returns profile data (evidence: `trackmysubs-backend/src/main/java/com/trackmysubs/service/UserService.java`)
