rikrdo/mercadodevida
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
mercadodevida/work/artifacts/CLUB-001/documenter.md

875 B
Raw Permalink Blame History

CLUB-001 — Documentation notes

New backend endpoints

  • GET /club/config
  • POST /club/join
  • GET /club/me
  • GET /club/movements
  • GET /admin/club/settings
  • PATCH /admin/club/settings

Contract notes

  • Anonymous Club identity is device-based for now.
  • Client receives the raw deviceToken once; database stores only device_token_hash.
  • The backend also persists the token in cookie mdv_club and accepts it again via cookie or x-club-device-token header.
  • club_transactions is the source of truth; club_members.current_balance_cents is a transactional cache.
  • Cashback is configurable through store_settings (club_cashback_bps) instead of hardcoded constants.

Scope boundary

  • CLUB-001 ships backend foundations only.
  • PWA screens, digital card UI, TPV integration, recovery flow and account linking remain for later CLUB phases.