How 0x1kaan/pualim-app works
Pualım is a QR-based digital loyalty platform for Turkish cafés, designed to let customers use a loyalty card without installing an app. The customer workflow is phone verification by SMS, access to a café’s digital card, and viewing stamps, rewards, and visit history; the card UI also exposes a stamp-request flow. Café owners have onboarding and dashboard areas for café setup, customers, campaigns, analytics, and settings. The sampled sources confirm OTP and café/campaign/customer API behavior; dashboard-to-API wiring and several card actions were not sampled, so those relationships are not asserted.
Main entry points: admin.ts Admin client · LoyaltyCardClient.tsx Card experience · server.ts Server client · DashboardClient.tsx Owner dashboard
Components 30
Customer loyalty
- QR loyalty card
src/app/card/[slug]/page.tsx - Card experience
src/components/card/LoyaltyCardClient.tsx - Stamp grid
src/components/card/StampGrid.tsx - Rewards list
src/components/card/RewardsList.tsx - Visit history
src/components/card/VisitHistory.tsx
Café management
- Café onboarding
src/app/(dashboard)/onboarding/page.tsx - Owner dashboard
src/app/(dashboard)/dashboard/DashboardClient.tsx - Customer management
src/app/(dashboard)/customers/CustomersClient.tsx - Campaign management
src/app/(dashboard)/campaigns/CampaignsClient.tsx - Analytics
src/app/(dashboard)/analytics/AnalyticsClient.tsx - Café settings
src/app/(dashboard)/settings/SettingsClient.tsx
Application backend
- Send OTP
src/app/api/auth/send-otp/route.ts - Verify OTP
src/app/api/auth/verify-otp/route.ts - Café API
src/app/api/cafe/route.ts - Campaign API
src/app/api/campaigns/route.ts - Customers API
src/app/api/customers/route.ts - Analytics API
src/app/api/analytics/summary/route.ts - Stamp request API
src/app/api/stamps/request/route.ts - Stamp approval API
src/app/api/stamps/approve/route.ts - Card customer API
src/app/api/card/[slug]/customer/route.ts - Card rewards API
src/app/api/card/rewards/route.ts - Card history API
src/app/api/card/history/route.ts - Reward redemption API
src/app/api/rewards/redeem/route.ts
Platform services
- Server client
src/lib/supabase/server.ts - Admin client
src/lib/supabase/admin.ts - Supabase data
src/types/database.ts - SMS sender
src/lib/notifications/sms.ts
Other components
- Café customer
- Café owner
- SMS provider
Connections 33
- Café customer → QR loyalty card: opens
- QR loyalty card → Card experience: renders
- Card experience → Send OTP: requests code
src/components/card/LoyaltyCardClient.tsx - Card experience → Verify OTP: verifies code
src/components/card/LoyaltyCardClient.tsx - Card experience → Card customer API: loads customer
src/components/card/LoyaltyCardClient.tsx - Card experience → Stamp grid: renders
src/components/card/LoyaltyCardClient.tsx - Card experience → Rewards list: renders
src/components/card/LoyaltyCardClient.tsx - Card experience → Visit history: renders
src/components/card/LoyaltyCardClient.tsx - Card experience → Stamp request API: requests stamp
- Café owner → Café onboarding: sets up café
- Café owner → Owner dashboard: manages café
- Owner dashboard → Customer management: opens
- Owner dashboard → Campaign management: opens
- Owner dashboard → Analytics: opens
- Owner dashboard → Café settings: opens
- Send OTP → Admin client: reads and writes
src/app/api/auth/send-otp/route.ts - Send OTP → SMS sender: sends message
src/app/api/auth/send-otp/route.ts - SMS sender → SMS provider: delivers SMS
- Verify OTP → Admin client: reads and writes
src/app/api/auth/verify-otp/route.ts - Café API → Server client: authenticates and reads
src/app/api/cafe/route.ts - Café API → Admin client: creates café
src/app/api/cafe/route.ts - Campaign API → Server client: reads and writes
src/app/api/campaigns/route.ts - Customers API → Server client: reads customers
src/app/api/customers/route.ts - Analytics API → Server client: queries summary
src/app/api/analytics/summary/route.ts - Card customer API → Admin client: reads customer
- Card rewards API → Admin client: reads rewards
src/app/api/card/rewards/route.ts - Card history API → Admin client: reads history
src/app/api/card/history/route.ts - Stamp request API → Admin client: records request
src/app/api/stamps/request/route.ts - Stamp approval API → Server client: authenticates
src/app/api/stamps/approve/route.ts - Stamp approval API → Admin client: approves stamp
src/app/api/stamps/approve/route.ts - Reward redemption API → Admin client: redeems reward
src/app/api/rewards/redeem/route.ts - Server client → Supabase data: types queries
src/lib/supabase/server.ts - Admin client → Supabase data: types queries
src/lib/supabase/admin.ts