External Portal Integration

Description

This feature enables the Admin Web Portal to connect with HLF's external Dynamics-based portal, ensuring the two systems work in harmony rather than overlapping or conflicting. The integration provides configuration screens for administrators to manage connection settings, credentials, and data synchronization rules. It ensures that user data, role information, and activity records can flow between Meander and external member portals without duplication or inconsistency.

User Flow

Click to expand

Analysis

Business Value

HLF is simultaneously redesigning its "Min Side" portal on Dynamics, and without deliberate coordination the two products risk creating a fragmented, confusing experience for peer mentors and coordinators who must use both. This integration protects the user experience by ensuring the systems complement rather than compete with each other. For Meander as a platform, offering configurable portal integration increases commercial appeal to larger organizations that already run existing member portals, reducing the adoption barrier and strengthening the value proposition for multi-system environments. It also future-proofs the architecture for additional partner integrations.

Implementation Notes

The integration layer should be implemented as a pluggable adapter in the backend API, with organization-scoped configuration stored in the integration_configs table. OAuth 2.0 or API key-based authentication against the external Dynamics portal must be supported, with secrets stored securely (encrypted at rest). The Admin Web Portal exposes an Integration Settings Page where org admins can input credentials, map field names, and enable or disable sync. All sync operations must be idempotent and logged to audit_logs. A webhook listener or polling mechanism handles inbound events from the external portal. Error handling must surface actionable messages to admins without exposing raw API errors.