# adithyaks2004/mobile-service-provider-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/adithyaks2004/mobile-service-provider-management-system
- Repository: https://github.com/adithyaks2004/mobile-service-provider-management-system

## Overview

This is a full-stack mobile-service management system. Customers register, verify email, log in, browse plans, activate a SIM, subscribe or recharge, then simulate usage and track remaining benefits; administrators manage customers, SIMs, and plans. The backend is documented as a REST controller–service–repository stack. Service-to-repository links are shown only where sampled source or the SOURCE INDEX supports them; several unsampled feature implementations are retained as nodes, with uncertain links omitted or marked unverified.

Main entry points: [`telecom/src/main/java/com/provider/telecom/service/RechargeService.java`](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/RechargeService.java) (Subscription and recharge), [`telecom/src/main/java/com/provider/telecom/repository/UserRepository.java`](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/UserRepository.java) (User records), [`telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java`](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java) (Email OTP service), [`telecom/src/main/java/com/provider/telecom/service/UsageService.java`](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/UsageService.java) (Usage tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web clients"]
  node_customer["Customer UI<br/>[customer.js]"]
  node_plans_ui["Plans UI<br/>[plans.js]"]
  node_usage_ui["Usage UI<br/>[usage.js]"]
  node_auth_ui["Auth UI<br/>[auth.js]"]
  node_admin_ui["Admin UI<br/>[admin-plans.js]"]
end

subgraph group_entry["REST API"]
  node_auth_api["Auth API"]
  node_sim_api["SIM API"]
  node_plan_api["Plan API"]
  node_admin_api["Admin APIs"]
  node_recharge_api["Recharge API"]
  node_usage_api["Usage API"]
end

subgraph group_identity["Identity and verification"]
  node_auth_service["Account service<br/>[AuthService.java]"]
  node_verify_service["Email OTP service"]
  node_email_service["Email delivery<br/>[EmailService.java]"]
end

subgraph group_operations["Telecom operations"]
  node_sim_service["SIM lifecycle"]
  node_plan_service["Plan management<br/>[PlanService.java]"]
  node_recharge_service["Subscription and recharge"]
  node_usage_service["Usage tracking<br/>[UsageService.java]"]
  node_customer_service["Customer administration"]
end

subgraph group_persistence["Data access"]
  node_user_repo[("User records")]
  node_sim_repo[("SIM records")]
  node_verification_repo[("Verification records")]
  node_plan_repo[("Plan records")]
  node_subscription_repo[("Subscription records")]
  node_transaction_repo[("Payment records")]
end

node_admin(("Administrator"))
node_customer_actor(("Customer"))
node_smtp["SMTP email"]

node_customer_actor -->|"registers and logs in"| node_auth_ui
node_auth_ui -->|"calls REST API"| node_auth_api
node_customer -->|"requests activation"| node_sim_api
node_plans_ui -->|"browses plans"| node_plan_api
node_customer -->|"subscribes and recharges"| node_recharge_api
node_usage_ui -->|"simulates usage"| node_usage_api
node_admin -->|"manages operations"| node_admin_ui
node_admin_ui -->|"uses admin endpoints"| node_admin_api
node_auth_api -->|"delegates account actions"| node_auth_service
node_auth_api -->|"verifies and resends OTP"| node_verify_service
node_sim_api -->|"delegates SIM actions"| node_sim_service
node_plan_api -->|"delegates plan actions"| node_plan_service
node_auth_service -->|"reads and saves users"| node_user_repo
node_auth_service -->|"sends verification code"| node_verify_service
node_verify_service -->|"looks up accounts"| node_user_repo
node_verify_service -->|"stores OTP records"| node_verification_repo
node_verify_service -->|"sends OTP email"| node_email_service
node_email_service -.->|"delivers email"| node_smtp
node_sim_service -->|"reads and updates SIMs"| node_sim_repo
node_sim_service -->|"looks up customer"| node_user_repo
node_recharge_service -->|"loads account"| node_user_repo
node_recharge_service -->|"checks SIM ownership"| node_sim_repo
node_recharge_service -->|"loads selected plan"| node_plan_repo
node_recharge_service -->|"creates subscription"| node_subscription_repo
node_recharge_service -->|"records payment"| node_transaction_repo
node_usage_service -->|"loads account"| node_user_repo
node_usage_service -->|"checks SIM ownership"| node_sim_repo
node_usage_service -->|"updates remaining benefits"| node_subscription_repo
node_plan_service -.->|"manages plans"| node_plan_repo
node_customer_service -.->|"manages customers"| node_user_repo

click node_customer "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/customer.js"
click node_plans_ui "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/plans.js"
click node_usage_ui "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/usage.js"
click node_auth_ui "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/auth.js"
click node_admin_ui "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/admin-plans.js"
click node_auth_api "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/AuthController.java"
click node_sim_api "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/SimCardController.java"
click node_plan_api "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/PlanController.java"
click node_admin_api "https://github.com/adithyaks2004/mobile-service-provider-management-system/tree/main/telecom/src/main/java/com/provider/telecom/controller"
click node_recharge_api "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/RechargeController.java"
click node_usage_api "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/UsageController.java"
click node_auth_service "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/AuthService.java"
click node_verify_service "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java"
click node_email_service "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/EmailService.java"
click node_sim_service "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/SimCardService.java"
click node_plan_service "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/PlanService.java"
click node_recharge_service "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/RechargeService.java"
click node_usage_service "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/UsageService.java"
click node_customer_service "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/AdminCustomerService.java"
click node_user_repo "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/UserRepository.java"
click node_sim_repo "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/SimCardRepository.java"
click node_verification_repo "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/VerificationCodeRepository.java"
click node_plan_repo "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/PlanRepository.java"
click node_subscription_repo "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/SubscriptionRepository.java"
click node_transaction_repo "https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/TransactionRepository.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_customer,node_plans_ui,node_usage_ui,node_auth_ui,node_admin_ui toneBlue
class node_auth_api,node_sim_api,node_plan_api,node_admin_api,node_recharge_api,node_usage_api toneAmber
class node_auth_service,node_verify_service,node_email_service toneMint
class node_sim_service,node_plan_service,node_recharge_service,node_usage_service,node_customer_service toneRose
class node_user_repo,node_sim_repo,node_verification_repo,node_plan_repo,node_subscription_repo,node_transaction_repo,node_admin,node_customer_actor,node_smtp toneIndigo
```

## Components

### Web clients

- [Customer UI](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/customer.js): `telecom-frontend/js/customer.js`
- [Plans UI](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/plans.js): `telecom-frontend/js/plans.js`
- [Usage UI](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/usage.js): `telecom-frontend/js/usage.js`
- [Auth UI](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/auth.js): `telecom-frontend/js/auth.js`
- [Admin UI](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom-frontend/js/admin-plans.js): `telecom-frontend/js/admin-plans.js`

### REST API

- [Auth API](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/AuthController.java): `telecom/src/main/java/com/provider/telecom/controller/AuthController.java`
- [SIM API](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/SimCardController.java): `telecom/src/main/java/com/provider/telecom/controller/SimCardController.java`
- [Plan API](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/PlanController.java): `telecom/src/main/java/com/provider/telecom/controller/PlanController.java`
- [Admin APIs](https://github.com/adithyaks2004/mobile-service-provider-management-system/tree/main/telecom/src/main/java/com/provider/telecom/controller): `telecom/src/main/java/com/provider/telecom/controller`
- [Recharge API](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/RechargeController.java): `telecom/src/main/java/com/provider/telecom/controller/RechargeController.java`
- [Usage API](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/controller/UsageController.java): `telecom/src/main/java/com/provider/telecom/controller/UsageController.java`

### Identity and verification

- [Account service](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/AuthService.java): `telecom/src/main/java/com/provider/telecom/service/AuthService.java`
- [Email OTP service](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java): `telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java`
- [Email delivery](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/EmailService.java): `telecom/src/main/java/com/provider/telecom/service/EmailService.java`

### Telecom operations

- [SIM lifecycle](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/SimCardService.java): `telecom/src/main/java/com/provider/telecom/service/SimCardService.java`
- [Plan management](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/PlanService.java): `telecom/src/main/java/com/provider/telecom/service/PlanService.java`
- [Subscription and recharge](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/RechargeService.java): `telecom/src/main/java/com/provider/telecom/service/RechargeService.java`
- [Usage tracking](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/UsageService.java): `telecom/src/main/java/com/provider/telecom/service/UsageService.java`
- [Customer administration](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/service/AdminCustomerService.java): `telecom/src/main/java/com/provider/telecom/service/AdminCustomerService.java`

### Data access

- [User records](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/UserRepository.java): `telecom/src/main/java/com/provider/telecom/repository/UserRepository.java`
- [SIM records](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/SimCardRepository.java): `telecom/src/main/java/com/provider/telecom/repository/SimCardRepository.java`
- [Verification records](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/VerificationCodeRepository.java): `telecom/src/main/java/com/provider/telecom/repository/VerificationCodeRepository.java`
- [Plan records](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/PlanRepository.java): `telecom/src/main/java/com/provider/telecom/repository/PlanRepository.java`
- [Subscription records](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/SubscriptionRepository.java): `telecom/src/main/java/com/provider/telecom/repository/SubscriptionRepository.java`
- [Payment records](https://github.com/adithyaks2004/mobile-service-provider-management-system/blob/main/telecom/src/main/java/com/provider/telecom/repository/TransactionRepository.java): `telecom/src/main/java/com/provider/telecom/repository/TransactionRepository.java`

### Other components

- **Administrator**
- **Customer**
- **SMTP email**

## Connections

- Customer → Auth UI: registers and logs in (evidence: `README.md`)
- Auth UI → Auth API: calls REST API (evidence: `README.md`)
- Customer UI → SIM API: requests activation (evidence: `README.md`)
- Plans UI → Plan API: browses plans (evidence: `README.md`)
- Customer UI → Recharge API: subscribes and recharges (evidence: `README.md`)
- Usage UI → Usage API: simulates usage (evidence: `README.md`)
- Administrator → Admin UI: manages operations (evidence: `README.md`)
- Admin UI → Admin APIs: uses admin endpoints (evidence: `README.md`)
- Auth API → Account service: delegates account actions (evidence: `telecom/src/main/java/com/provider/telecom/controller/AuthController.java`)
- Auth API → Email OTP service: verifies and resends OTP (evidence: `telecom/src/main/java/com/provider/telecom/controller/AuthController.java`)
- SIM API → SIM lifecycle: delegates SIM actions (evidence: `telecom/src/main/java/com/provider/telecom/controller/SimCardController.java`)
- Plan API → Plan management: delegates plan actions (evidence: `telecom/src/main/java/com/provider/telecom/controller/PlanController.java`)
- Account service → User records: reads and saves users (evidence: `telecom/src/main/java/com/provider/telecom/service/AuthService.java`)
- Account service → Email OTP service: sends verification code (evidence: `telecom/src/main/java/com/provider/telecom/service/AuthService.java`)
- Email OTP service → User records: looks up accounts (evidence: `telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java`)
- Email OTP service → Verification records: stores OTP records (evidence: `telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java`)
- Email OTP service → Email delivery: sends OTP email (evidence: `telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java`)
- Email delivery → SMTP email: delivers email
- SIM lifecycle → SIM records: reads and updates SIMs (evidence: `telecom/src/main/java/com/provider/telecom/service/SimCardService.java`)
- SIM lifecycle → User records: looks up customer (evidence: `telecom/src/main/java/com/provider/telecom/service/SimCardService.java`)
- Subscription and recharge → User records: loads account (evidence: `telecom/src/main/java/com/provider/telecom/service/RechargeService.java`)
- Subscription and recharge → SIM records: checks SIM ownership (evidence: `telecom/src/main/java/com/provider/telecom/service/RechargeService.java`)
- Subscription and recharge → Plan records: loads selected plan (evidence: `telecom/src/main/java/com/provider/telecom/service/RechargeService.java`)
- Subscription and recharge → Subscription records: creates subscription (evidence: `telecom/src/main/java/com/provider/telecom/service/RechargeService.java`)
- Subscription and recharge → Payment records: records payment (evidence: `telecom/src/main/java/com/provider/telecom/service/RechargeService.java`)
- Usage tracking → User records: loads account (evidence: `telecom/src/main/java/com/provider/telecom/service/UsageService.java`)
- Usage tracking → SIM records: checks SIM ownership (evidence: `telecom/src/main/java/com/provider/telecom/service/UsageService.java`)
- Usage tracking → Subscription records: updates remaining benefits (evidence: `telecom/src/main/java/com/provider/telecom/service/UsageService.java`)
- Plan management → Plan records: manages plans (evidence: `telecom/src/main/java/com/provider/telecom/service/PlanService.java`)
- Customer administration → User records: manages customers
