# erjafariqbal/subscriber-management-platform architecture

> Architecture diagram of the GitHub repository erjafariqbal/subscriber-management-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/erjafariqbal/subscriber-management-platform
- Repository: https://github.com/erjafariqbal/subscriber-management-platform

## Overview

This repository is a Playwright end-to-end automation suite for the Procare portal, not the portal implementation itself. Its scenarios cover login, password recovery, dashboard, reports, subscribers, and renewal; the page objects implement browser interactions, while global setup performs a separate login and saves browser state. The test files and ForgotPassword implementation were not sampled, so their internal calls and detailed behavior are not represented. The shown page objects navigate to and interact with the external portal; no portal backend or data store is included.

Main entry points: [`pages/LoginPage.ts`](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/LoginPage.ts) (Login page object), [`pages/Dashboard.ts`](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/Dashboard.ts) (Dashboard page object), [`pages/SubscriberModule.ts`](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/SubscriberModule.ts) (Subscriber page object), [`global-setup.ts`](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/global-setup.ts) (Authenticated setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scenarios["Test scenarios"]
  node_runner(("Playwright runner"))
  node_login_scenarios["Login scenarios<br/>[loginPage.spec.ts]"]
  node_forgot_scenarios["Password recovery"]
  node_dashboard_scenarios["Dashboard scenarios<br/>[dashboard.spec.ts]"]
  node_reports_scenarios["Reports scenarios<br/>[reports.spec.ts]"]
  node_subscriber_scenarios["Subscriber scenarios"]
  node_renewal_scenarios["Renewal scenarios"]
end

subgraph group_interactions["Portal interactions"]
  node_login_page["Login page object<br/>[LoginPage.ts]"]
  node_dashboard_page["Dashboard page object<br/>[Dashboard.ts]"]
  node_subscriber_page["Subscriber page object"]
  node_forgot_page["Forgot-password page object<br/>[ForgotPassword.ts]"]
  node_reports_page["Reports page object<br/>[Reports.ts]"]
end

subgraph group_support["Automation support"]
  node_setup["Authenticated setup<br/>[global-setup.ts]"]
  node_excel["Excel reader<br/>[ExcelUtils.ts]"]
end

node_portal["Procare portal"]

node_login_page -->|"navigates and interacts"| node_portal
node_dashboard_page -->|"navigates and interacts"| node_portal
node_subscriber_page -->|"navigates and interacts"| node_portal
node_setup -->|"logs in"| node_portal

click node_login_scenarios "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/loginPage.spec.ts"
click node_forgot_scenarios "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/forgotPassword.spec.ts"
click node_dashboard_scenarios "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/dashboard.spec.ts"
click node_reports_scenarios "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/reports.spec.ts"
click node_subscriber_scenarios "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/subscriberPage.spec.ts"
click node_renewal_scenarios "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/renewalProcess.spec.ts"
click node_login_page "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/LoginPage.ts"
click node_dashboard_page "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/Dashboard.ts"
click node_subscriber_page "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/SubscriberModule.ts"
click node_forgot_page "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/ForgotPassword.ts"
click node_reports_page "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/Reports.ts"
click node_setup "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/global-setup.ts"
click node_excel "https://github.com/erjafariqbal/subscriber-management-platform/blob/master/utils/ExcelUtils.ts"

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_runner,node_login_scenarios,node_forgot_scenarios,node_dashboard_scenarios,node_reports_scenarios,node_subscriber_scenarios,node_renewal_scenarios toneBlue
class node_login_page,node_dashboard_page,node_subscriber_page,node_forgot_page,node_reports_page toneAmber
class node_setup,node_excel toneMint
class node_portal toneIndigo
```

## Components

### Test scenarios

- **Playwright runner**
- [Login scenarios](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/loginPage.spec.ts): `tests/loginPage.spec.ts`
- [Password recovery](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/forgotPassword.spec.ts): `tests/forgotPassword.spec.ts`
- [Dashboard scenarios](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/dashboard.spec.ts): `tests/dashboard.spec.ts`
- [Reports scenarios](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/reports.spec.ts): `tests/reports.spec.ts`
- [Subscriber scenarios](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/subscriberPage.spec.ts): `tests/subscriberPage.spec.ts`
- [Renewal scenarios](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/tests/renewalProcess.spec.ts): `tests/renewalProcess.spec.ts`

### Portal interactions

- [Login page object](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/LoginPage.ts): `pages/LoginPage.ts`
- [Dashboard page object](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/Dashboard.ts): `pages/Dashboard.ts`
- [Subscriber page object](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/SubscriberModule.ts): `pages/SubscriberModule.ts`
- [Forgot-password page object](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/ForgotPassword.ts): `pages/ForgotPassword.ts`
- [Reports page object](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/pages/Reports.ts): `pages/Reports.ts`

### Automation support

- [Authenticated setup](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/global-setup.ts): `global-setup.ts`
- [Excel reader](https://github.com/erjafariqbal/subscriber-management-platform/blob/master/utils/ExcelUtils.ts): `utils/ExcelUtils.ts`

### Other components

- **Procare portal**

## Connections

- Login page object → Procare portal: navigates and interacts (evidence: `pages/LoginPage.ts`)
- Dashboard page object → Procare portal: navigates and interacts (evidence: `pages/Dashboard.ts`)
- Subscriber page object → Procare portal: navigates and interacts (evidence: `pages/SubscriberModule.ts`)
- Authenticated setup → Procare portal: logs in (evidence: `global-setup.ts`)
