Lipila-tech/creator-monetization

Zambia First creator web based monetization app # 🇿🇲 TipZed Monetization App - MVP ## Overview This repository contains the code and documentation for the TipZed Monetization MVP, focused on enabling Zambian creators to get paid locally. The backend API is built with Django REST Framework and provides endpoints for authentication, creator profiles, wallets, payments, payouts, and admin reconciliation. The frontend is built with React and integrates with the backend to provide a seamless user experience. --- ## MVP Scope **Core User Flows:** - [x] Creators sign up, create profiles, set up payout accounts (mobile money or bank) - [x] Fans discover creators, send payments via mobile money - [x] Creators see balances, request payouts - [x] Admin approves payouts, reconciles transactions ## Quick Start Read the backend readme for API setup and development instructions: backend/README.md ### Setup Frontend Read the frontend readme for UI setup and development instructions: frontend/README.md --- ## System Architecture ## Complete Payment Flow ## Core Components ### Auth & User Service - User registration (email + password) and social login (Google OAuth) - JWT authentication with access and refresh tokens - Role-based access control (creator, patron, admin, guest) - JWT authentication & refresh tokens ### Creator Profiles Service - Public creator profiles (discoverable) - Profile editing - Dashboard for creators to view stats, manage payouts ### Wallet & Ledger Service - Immutable transaction ledger (append-only) - Wallet balance calculated from ledger - No manual balance editing (audit trail) - Receive weekly payouts from TIPZED - Idempotent payment processing (prevent duplicates) ### Payments Integration - Initiate mobile money payments - Webhook handling from mobile money provider - Payment state machine (pending → success/failed) - Idempotency (prevent duplicate charges) ### Payouts & Admin - Creator payout requests - Admin approval/rejection - Automatic weekly payout processing - Admin reco …