Assist_Design/docs/portal-guides/README.md

# Portal Guides (How It Works)

These guides explain what the portal does, how data moves between WHMCS and Salesforce, and where caching affects what people see. They avoid deep implementation detail and focus on flows, data ownership, and error handling.

Start with `system-overview.md`, then jump into the feature you care about:

- `COMPLETE-GUIDE.md` — single, end-to-end explanation of how the portal works
- `system-overview.md` — high-level architecture, data ownership, and caching quick reference.
- `accounts-and-identity.md` — how sign-up, WHMCS linking, and address/profile updates behave.
- `catalog-and-checkout.md` — where products/pricing come from and what we check before checkout.
- `eligibility-and-verification.md` — internet eligibility + SIM ID verification (Salesforce-driven).
- `orders-and-provisioning.md` — order lifecycle in Salesforce and how it is fulfilled into WHMCS.
- `billing-and-payments.md` — invoices, payment methods, and how billing links are handled.
- `subscriptions.md` — how active services are read and refreshed.
- `support-cases.md` — how cases are created/read in Salesforce from the portal.
- `ui-design-system.md` — UI tokens, page shells, and component patterns to keep pages consistent.
Add Portal Guides section to documentation - Introduced a new "Portal Guides" section in the README and docs/README.md to provide high-level overviews and detailed explanations of various portal functionalities, including accounts, catalog, orders, billing, subscriptions, and support cases. - Updated the main README to link to the new portal guides for better navigation and user guidance. 2025-12-15 14:13:08 +09:00			`# Portal Guides (How It Works)`

			`These guides explain what the portal does, how data moves between WHMCS and Salesforce, and where caching affects what people see. They avoid deep implementation detail and focus on flows, data ownership, and error handling.`

			Start with `system-overview.md`, then jump into the feature you care about:

			- `COMPLETE-GUIDE.md` — single, end-to-end explanation of how the portal works
			- `system-overview.md` — high-level architecture, data ownership, and caching quick reference.
			- `accounts-and-identity.md` — how sign-up, WHMCS linking, and address/profile updates behave.
			- `catalog-and-checkout.md` — where products/pricing come from and what we check before checkout.
Add Residence Card Submission and Verification Features - Introduced ResidenceCardSubmission model to handle user submissions of residence cards, including status tracking and file management. - Updated User model to include a relation to ResidenceCardSubmission for better user data management. - Enhanced the checkout process to require residence card submission for SIM orders, improving compliance and verification. - Integrated VerificationModule into the application, updating relevant modules and routes to support new verification features. - Refactored various components and services to utilize the new residence card functionality, ensuring a seamless user experience. - Updated public-facing views to guide users through the residence card submission process, enhancing clarity and accessibility. 2025-12-18 18:12:20 +09:00			- `eligibility-and-verification.md` — internet eligibility + SIM ID verification (Salesforce-driven).
Add Portal Guides section to documentation - Introduced a new "Portal Guides" section in the README and docs/README.md to provide high-level overviews and detailed explanations of various portal functionalities, including accounts, catalog, orders, billing, subscriptions, and support cases. - Updated the main README to link to the new portal guides for better navigation and user guidance. 2025-12-15 14:13:08 +09:00			- `orders-and-provisioning.md` — order lifecycle in Salesforce and how it is fulfilled into WHMCS.
			- `billing-and-payments.md` — invoices, payment methods, and how billing links are handled.
			- `subscriptions.md` — how active services are read and refreshed.
			- `support-cases.md` — how cases are created/read in Salesforce from the portal.
Refactor UI components and enhance styling consistency across the portal - Updated various components to use consistent color tokens, improving visual coherence. - Refactored layout components to utilize the new PublicShell for better structure. - Enhanced error and status messaging styles for improved user feedback. - Standardized button usage across forms and modals for a unified interaction experience. - Introduced new UI design tokens and guidelines in documentation to support future development. 2025-12-16 13:54:31 +09:00			- `ui-design-system.md` — UI tokens, page shells, and component patterns to keep pages consistent.