Assist_Design/docs/SUBSCRIPTION-SERVICE-MANAGEMENT.md
T. Narantuya bef5abcbda Refactor Freebit service and update SIM management components for improved clarity and functionality
- Consolidated and cleaned up type definitions in Freebit service interfaces for better readability.
- Enhanced error handling and logging in Freebit service methods to provide clearer feedback.
- Updated SIM management pages to streamline user interactions and improve UI components.
- Removed deprecated subscription detail page and restructured routing for better navigation.
- Added new notice and info row components in SIM cancellation page for improved user experience.
2025-09-11 16:21:54 +09:00

1.8 KiB

Subscription Service Management

Guidance for the unified Service Management area in the Subscriptions detail page. This area provides a dropdown to switch between different service types for a given subscription.

  • Location: Subscriptions > [Subscription] > Service Management
  • Selector: Service dropdown with options: SIM, Internet, Netgear, VPN
  • Current status: SIM available now; others are placeholders (coming soon)

UI Structure

apps/portal/src/features/service-management/
├── components/
│   └── ServiceManagementSection.tsx  # Container with service dropdown
└── index.ts
  • Header: Title + description, service dropdown selector
  • Body: Renders the active service panel
  • Default selection: SIM for SIM products; otherwise Internet

Service Panels

  • SIM: Renders the existing SIM management UI
    • Source: apps/portal/src/features/sim-management/components/SimManagementSection.tsx
    • Backend: /api/subscriptions/{id}/sim/*
  • Internet: Placeholder (coming soon)
  • Netgear: Placeholder (coming soon)
  • VPN: Placeholder (coming soon)

Integration

  • Entry point: apps/portal/src/app/(portal)/subscriptions/[id]/page.tsx renders ServiceManagementSection
  • Detection: SIM availability is inferred from subscription.productName including sim (case-insensitive)

Future Expansion

  • Replace placeholders with actual feature modules per service type
  • Gate options per subscription capabilities (disable/hide unsupported services)
  • Deep-linking: support ?service=sim|internet|netgear|vpn to preselect a panel
  • Telemetry: track panel usage and feature adoption

Notes

  • This structure avoids breaking changes to the existing SIM workflow while preparing a clean surface for additional services.
  • SIM documentation remains at docs/FREEBIT-SIM-MANAGEMENT.md and is unchanged functionally.