How adithyaks2004/mobile-service-provider-management-system works
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: RechargeService.java Subscription and recharge · UserRepository.java User records · VerificationCodeService.java Email OTP service · UsageService.java Usage tracking
Components 28
Web clients
- Customer UI
telecom-frontend/js/customer.js - Plans UI
telecom-frontend/js/plans.js - Usage UI
telecom-frontend/js/usage.js - Auth UI
telecom-frontend/js/auth.js - Admin UI
telecom-frontend/js/admin-plans.js
REST API
- Auth API
telecom/src/main/java/com/provider/telecom/controller/AuthController.java - SIM API
telecom/src/main/java/com/provider/telecom/controller/SimCardController.java - Plan API
telecom/src/main/java/com/provider/telecom/controller/PlanController.java - Admin APIs
telecom/src/main/java/com/provider/telecom/controller - Recharge API
telecom/src/main/java/com/provider/telecom/controller/RechargeController.java - Usage API
telecom/src/main/java/com/provider/telecom/controller/UsageController.java
Identity and verification
- Account service
telecom/src/main/java/com/provider/telecom/service/AuthService.java - Email OTP service
telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java - Email delivery
telecom/src/main/java/com/provider/telecom/service/EmailService.java
Telecom operations
- SIM lifecycle
telecom/src/main/java/com/provider/telecom/service/SimCardService.java - Plan management
telecom/src/main/java/com/provider/telecom/service/PlanService.java - Subscription and recharge
telecom/src/main/java/com/provider/telecom/service/RechargeService.java - Usage tracking
telecom/src/main/java/com/provider/telecom/service/UsageService.java - Customer administration
telecom/src/main/java/com/provider/telecom/service/AdminCustomerService.java
Data access
- User records
telecom/src/main/java/com/provider/telecom/repository/UserRepository.java - SIM records
telecom/src/main/java/com/provider/telecom/repository/SimCardRepository.java - Verification records
telecom/src/main/java/com/provider/telecom/repository/VerificationCodeRepository.java - Plan records
telecom/src/main/java/com/provider/telecom/repository/PlanRepository.java - Subscription records
telecom/src/main/java/com/provider/telecom/repository/SubscriptionRepository.java - Payment records
telecom/src/main/java/com/provider/telecom/repository/TransactionRepository.java
Other components
- Administrator
- Customer
- SMTP email
Connections 30
- Customer → Auth UI: registers and logs in
README.md - Auth UI → Auth API: calls REST API
README.md - Customer UI → SIM API: requests activation
README.md - Plans UI → Plan API: browses plans
README.md - Customer UI → Recharge API: subscribes and recharges
README.md - Usage UI → Usage API: simulates usage
README.md - Administrator → Admin UI: manages operations
README.md - Admin UI → Admin APIs: uses admin endpoints
README.md - Auth API → Account service: delegates account actions
telecom/src/main/java/com/provider/telecom/controller/AuthController.java - Auth API → Email OTP service: verifies and resends OTP
telecom/src/main/java/com/provider/telecom/controller/AuthController.java - SIM API → SIM lifecycle: delegates SIM actions
telecom/src/main/java/com/provider/telecom/controller/SimCardController.java - Plan API → Plan management: delegates plan actions
telecom/src/main/java/com/provider/telecom/controller/PlanController.java - Account service → User records: reads and saves users
telecom/src/main/java/com/provider/telecom/service/AuthService.java - Account service → Email OTP service: sends verification code
telecom/src/main/java/com/provider/telecom/service/AuthService.java - Email OTP service → User records: looks up accounts
telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java - Email OTP service → Verification records: stores OTP records
telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java - Email OTP service → Email delivery: sends OTP email
telecom/src/main/java/com/provider/telecom/service/VerificationCodeService.java - Email delivery → SMTP email: delivers email
- SIM lifecycle → SIM records: reads and updates SIMs
telecom/src/main/java/com/provider/telecom/service/SimCardService.java - SIM lifecycle → User records: looks up customer
telecom/src/main/java/com/provider/telecom/service/SimCardService.java - Subscription and recharge → User records: loads account
telecom/src/main/java/com/provider/telecom/service/RechargeService.java - Subscription and recharge → SIM records: checks SIM ownership
telecom/src/main/java/com/provider/telecom/service/RechargeService.java - Subscription and recharge → Plan records: loads selected plan
telecom/src/main/java/com/provider/telecom/service/RechargeService.java - Subscription and recharge → Subscription records: creates subscription
telecom/src/main/java/com/provider/telecom/service/RechargeService.java - Subscription and recharge → Payment records: records payment
telecom/src/main/java/com/provider/telecom/service/RechargeService.java - Usage tracking → User records: loads account
telecom/src/main/java/com/provider/telecom/service/UsageService.java - Usage tracking → SIM records: checks SIM ownership
telecom/src/main/java/com/provider/telecom/service/UsageService.java - Usage tracking → Subscription records: updates remaining benefits
telecom/src/main/java/com/provider/telecom/service/UsageService.java - Plan management → Plan records: manages plans
telecom/src/main/java/com/provider/telecom/service/PlanService.java - Customer administration → User records: manages customers