# ajay9084/subscriptionmanagement architecture

> Architecture diagram of the GitHub repository ajay9084/subscriptionmanagement, 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/ajay9084/subscriptionmanagement
- Repository: https://github.com/ajay9084/subscriptionmanagement

## Overview

The platform exposes purchase and subscription APIs through two Spring services. Clients manage products and purchases in Purchase Service, which registers active subscriptions through Subscription Service; clients can also manage subscriptions directly. The README documents separate PostgreSQL databases, subscription states, caching, and scheduled tasks. Source excerpts were unavailable, so internal call chains and database ownership details beyond the README are not inferred.

Main entry points: [`purchase-service/src/main/java/com/example/purchase_service/controller`](https://github.com/ajay9084/subscriptionmanagement/tree/main/purchase-service/src/main/java/com/example/purchase_service/controller) (Purchase API), [`subscription/src/main/java/com/example/subscription/service`](https://github.com/ajay9084/subscriptionmanagement/tree/main/subscription/src/main/java/com/example/subscription/service) (Subscription Management), [`subscription/src/main/java/com/example/subscription/controller`](https://github.com/ajay9084/subscriptionmanagement/tree/main/subscription/src/main/java/com/example/subscription/controller) (Subscription API), [`purchase-service/src/main/java/com/example/purchase_service/service`](https://github.com/ajay9084/subscriptionmanagement/tree/main/purchase-service/src/main/java/com/example/purchase_service/service) (Purchases)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_purchase["Purchase Service"]
  node_purchase_api["Purchase API"]
  node_purchase_catalog["Product Catalog"]
  node_purchase_flow["Purchases"]
  node_subscription_client["Subscription Client"]
end

subgraph group_subscription["Subscription Service"]
  node_subscription_api["Subscription API"]
  node_subscription_admin["Subscription Management"]
  node_auth["Authentication"]
end

subgraph group_data["Persistence"]
  node_purchase_db[("purchase_db")]
  node_subscription_db[("subscription_db")]
end

subgraph group_lifecycle["Subscription Lifecycle"]
  node_state_lifecycle["Subscription States"]
  node_cache["Subscription Cache<br/>[CacheConfig.java]"]
  node_expiry["Expiry Scheduling"]
end

node_client(("Client / Postman"))

node_client -->|"creates products and purchases"| node_purchase_api
node_client -->|"manages subscriptions"| node_subscription_api
node_purchase_api -.-> node_purchase_catalog
node_purchase_api -.-> node_purchase_flow
node_purchase_api -->|"uses auth endpoints"| node_auth
node_purchase_flow -->|"registers active subscriptions"| node_subscription_client
node_subscription_client -->|"calls internal endpoint"| node_subscription_api
node_subscription_api -.-> node_subscription_admin
node_purchase_api -->|"reads and writes"| node_purchase_db
node_subscription_api -->|"reads and writes"| node_subscription_db
node_subscription_admin -->|"manages states"| node_state_lifecycle
node_subscription_admin -->|"uses caching"| node_cache
node_subscription_admin -->|"schedules tasks"| node_expiry

click node_purchase_api "https://github.com/ajay9084/subscriptionmanagement/tree/main/purchase-service/src/main/java/com/example/purchase_service/controller"
click node_purchase_catalog "https://github.com/ajay9084/subscriptionmanagement/tree/main/purchase-service/src/main/java/com/example/purchase_service/service"
click node_purchase_flow "https://github.com/ajay9084/subscriptionmanagement/tree/main/purchase-service/src/main/java/com/example/purchase_service/service"
click node_subscription_client "https://github.com/ajay9084/subscriptionmanagement/blob/main/purchase-service/src/main/java/com/example/purchase_service/client/SubscriptionClient.java"
click node_subscription_api "https://github.com/ajay9084/subscriptionmanagement/tree/main/subscription/src/main/java/com/example/subscription/controller"
click node_subscription_admin "https://github.com/ajay9084/subscriptionmanagement/tree/main/subscription/src/main/java/com/example/subscription/service"
click node_auth "https://github.com/ajay9084/subscriptionmanagement/blob/main/subscription/src/main/java/com/example/subscription/controller/AuthController.java"
click node_state_lifecycle "https://github.com/ajay9084/subscriptionmanagement/blob/main/subscription/src/main/java/com/example/subscription/enums/SubscriptionStatus.java"
click node_cache "https://github.com/ajay9084/subscriptionmanagement/blob/main/subscription/src/main/java/com/example/subscription/config/CacheConfig.java"
click node_expiry "https://github.com/ajay9084/subscriptionmanagement/blob/main/subscription/src/main/java/com/example/subscription/scheduler/SubscriptionExpiryScheduler.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_purchase_api,node_purchase_catalog,node_purchase_flow,node_subscription_client,node_client toneBlue
class node_subscription_api,node_subscription_admin,node_auth toneAmber
class node_purchase_db,node_subscription_db toneMint
class node_state_lifecycle,node_cache,node_expiry toneRose
```

## Components

### Purchase Service

- [Purchase API](https://github.com/ajay9084/subscriptionmanagement/tree/main/purchase-service/src/main/java/com/example/purchase_service/controller): `purchase-service/src/main/java/com/example/purchase_service/controller`
- [Product Catalog](https://github.com/ajay9084/subscriptionmanagement/tree/main/purchase-service/src/main/java/com/example/purchase_service/service): `purchase-service/src/main/java/com/example/purchase_service/service`
- [Purchases](https://github.com/ajay9084/subscriptionmanagement/tree/main/purchase-service/src/main/java/com/example/purchase_service/service): `purchase-service/src/main/java/com/example/purchase_service/service`
- [Subscription Client](https://github.com/ajay9084/subscriptionmanagement/blob/main/purchase-service/src/main/java/com/example/purchase_service/client/SubscriptionClient.java): `purchase-service/src/main/java/com/example/purchase_service/client/SubscriptionClient.java`

### Subscription Service

- [Subscription API](https://github.com/ajay9084/subscriptionmanagement/tree/main/subscription/src/main/java/com/example/subscription/controller): `subscription/src/main/java/com/example/subscription/controller`
- [Subscription Management](https://github.com/ajay9084/subscriptionmanagement/tree/main/subscription/src/main/java/com/example/subscription/service): `subscription/src/main/java/com/example/subscription/service`
- [Authentication](https://github.com/ajay9084/subscriptionmanagement/blob/main/subscription/src/main/java/com/example/subscription/controller/AuthController.java): `subscription/src/main/java/com/example/subscription/controller/AuthController.java`

### Persistence

- **purchase_db**
- **subscription_db**

### Subscription Lifecycle

- [Subscription States](https://github.com/ajay9084/subscriptionmanagement/blob/main/subscription/src/main/java/com/example/subscription/enums/SubscriptionStatus.java): `subscription/src/main/java/com/example/subscription/enums/SubscriptionStatus.java`
- [Subscription Cache](https://github.com/ajay9084/subscriptionmanagement/blob/main/subscription/src/main/java/com/example/subscription/config/CacheConfig.java): `subscription/src/main/java/com/example/subscription/config/CacheConfig.java`
- [Expiry Scheduling](https://github.com/ajay9084/subscriptionmanagement/blob/main/subscription/src/main/java/com/example/subscription/scheduler/SubscriptionExpiryScheduler.java): `subscription/src/main/java/com/example/subscription/scheduler/SubscriptionExpiryScheduler.java`

### Other components

- **Client / Postman**

## Connections

- Client / Postman → Purchase API: creates products and purchases (evidence: `README.md`)
- Client / Postman → Subscription API: manages subscriptions (evidence: `README.md`)
- Purchase API → Product Catalog
- Purchase API → Purchases
- Purchase API → Authentication: uses auth endpoints (evidence: `README.md`)
- Purchases → Subscription Client: registers active subscriptions (evidence: `README.md`)
- Subscription Client → Subscription API: calls internal endpoint (evidence: `README.md`)
- Subscription API → Subscription Management
- Purchase API → purchase_db: reads and writes (evidence: `README.md`)
- Subscription API → subscription_db: reads and writes (evidence: `README.md`)
- Subscription Management → Subscription States: manages states (evidence: `README.md`)
- Subscription Management → Subscription Cache: uses caching (evidence: `README.md`)
- Subscription Management → Expiry Scheduling: schedules tasks (evidence: `README.md`)
