21 lines
875 B
Markdown
21 lines
875 B
Markdown
# 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.
|