- Updated SalesforceOpportunityService to allow filtering by stages during opportunity retrieval, improving flexibility in eligibility checks. - Integrated DistributedLockService into InternetCatalogService and OrderOrchestrator to prevent race conditions when creating or reusing opportunities. - Refactored opportunity matching logic to ensure proper handling of stages during eligibility requests and order placements. - Improved documentation to clarify the opportunity lifecycle and eligibility verification processes, ensuring better understanding for future development.
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.
Guides
| Guide | Description |
|---|---|
| Complete Guide | Single, end-to-end explanation of how the portal works |
| System Overview | High-level architecture, data ownership, and caching |
| Accounts & Identity | Sign-up, WHMCS linking, and address/profile updates |
| Catalog & Checkout | Product source, pricing, and checkout flow |
| Eligibility & Verification | Internet eligibility + SIM ID verification |
| Orders & Provisioning | Order lifecycle in Salesforce → WHMCS fulfillment |
| Billing & Payments | Invoices, payment methods, billing links |
| Subscriptions | How active services are read and refreshed |
| Support Cases | Case creation/reading in Salesforce |
| UI Design System | UI tokens, page shells, component patterns |
Related Documentation
- Salesforce Requirements – Required fields, flows, and setup
- Architecture Overview – System design