Phase 5: BFF Service Decomposition - Split SalesforceOpportunityService (1055 lines) into focused services: - OpportunityQueryService: find/get operations - OpportunityCancellationService: cancellation workflows - OpportunityMutationService: create/update/link operations - SalesforceOpportunityService: thin facade (227 lines) Phase 6: Portal Component Decomposition - Refactor AccountCheckoutContainer (798 → 357 lines, 55% reduction) - Extract reusable checkout section components: - ResidenceCardUploadInput: eliminates 3x duplicated upload UI - PaymentMethodSection: payment method handling - IdentityVerificationSection: identity verification states - OrderSubmitSection: order summary and submission Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Portal Structure Overview
This app follows a feature-first architecture with a consolidated lib for shared utilities.
Structure:
src/
app/ # Next.js App Router
components/ # Design system (ui, layout, common)
features/ # Feature modules (auth, billing, subscriptions, ...)
lib/ # Core utils and services (api, query, env, utils, types)
providers/ # App-wide providers (e.g., QueryProvider)
styles/ # Global styles
Key changes:
- Merged former
core/andshared/intolib/. - Moved
components/providers/query-provider.tsxtoproviders/query-provider.tsx. - Introduced path aliases:
@/lib/*,@/providers/*.
Migration tips:
- Prefer importing from
@/lib/...going forward. - All
@/shared/*or@/core/*imports have been removed; use@/lib/*.