GymPulse: Boutique Gym Member Retention & Analytics Hub

Integrations

• Required: an email provider for campaign delivery and webhooks.
• Optional after validation: a gym system CSV export; direct vendor sync is outside the MVP.
• Optional automation may relay approved contacts or staff alerts, but it must not choose who is contacted.

Data flow

1. A validated CSV creates or updates members and appends deduplicated visits.
2. The evaluator reads active memberships and recent visits, then writes a RiskSnapshot with reason codes.
3. A manager selects snapshots, confirms consent, and creates CampaignContacts.
4. The email adapter sends only approved contacts and records delivery webhooks.
5. Staff attach responses or later visits to the contact outcome view.

Failure handling

• Keep invalid import rows out of committed data and offer a downloadable error file.
• Mark provider timeouts as retryable without creating duplicate sends.
• If a webhook signature fails, quarantine the event and leave the prior delivery state unchanged.

Security

• Scope every query to the gym account.
• Restrict exports and campaign approval to manager roles.
• Encrypt transport and avoid placing health information in campaign copy.
• Store consent checks and operator identity for every send.

Rate limits

• Limit imports by file size and row count.
• Throttle campaign sends per gym and honor provider limits.
• Debounce repeated risk evaluations for the same attendance batch.