CrossKit Member – Membership & Referral Commission System

CrossKit Member — Turn One-Time Buyers into Repeat Customers

A production-ready membership + referral commission system built with FastAPI and MySQL. It ships with a complete member center, a full admin back office, and a REST API documented by Swagger UI — ready to run with pip install -r requirements.txt and one command.

Unlike "template-only" scripts, every module here is connected: a paid order creates commission records automatically, a referral link binds the parent user, points are earned on consumption and can be deducted at checkout, and withdrawal requests flow into an admin approval queue. Nothing is a mockup.

What's inside

• Member Center — profile, tier badge, points, withdrawable commission, invite link & code, benefit grid, upgrade pricing cards, referral dashboard.
• 3-Tier Membership — Free / Pro / Premium, auto-upgrade by cumulative spend + referral count, configurable discount rate per tier.
• 2-Level Referral Commission — Level-1 and Level-2 rates, auto calculation on order completion, unsettled → settled lifecycle, anti-abuse IP binding (1 bind per IP / 24h).
• Points Marketing — daily check-in with streak bonus, consumption points (¥1 = 1 point), referral points, point deduction at checkout, full point ledger.
• Withdrawal Workflow — minimum amount threshold, bank/Alipay account, pending → approved / rejected, admin review with reason.
• Admin Back Office (AdminLTE 3) — KPI dashboard, user management (search / ban / unban), tier config, order list, commission ledger, withdrawal approval.
• EDM & Notifications — email templates, subscriber list, in-app notifications, SMS code support.
• Marketing Landing Page — conversion-oriented hero, feature blocks, case studies, comparison table, blog teasers, CTA with lead capture popup.
• Security — JWT auth, bcrypt password hashing, role guard (user/admin), rate limiting middleware, operation audit log.
• Extras — Creem payment checkout integration (optional), i18n core, Dockerfile + docker-compose, systemd service file, pytest suite.

Tech stack

BackendPython 3.8+ · FastAPI 0.109 · SQLAlchemy 2.0 · Uvicorn · Pydantic v2 DatabaseMySQL 8.0 / 5.7 (PyMySQL, 15 tables, auto-create on boot) FrontendBootstrap 4.6 · AdminLTE 3.2 · jQuery 3.6 · Font Awesome 6.4 · vanilla ES6 AuthJWT (python-jose) + bcrypt (passlib) DocsSwagger UI / ReDoc — 67+ endpoints auto-generated

Why buy this

• Fully functional, not a skeleton — 67 API routes, 15 data models, 10 ready pages, zero placeholder screens.
• No build toolchain — pure HTML + CDN assets; edit a file, refresh the browser. Deploys on any $5 VPS.
• Responsive — desktop admin, tablet and mobile member center all verified.
• White-label friendly — single CSS variable block controls brand colors; all copy is centralized.
• Documented — README, API.md, DEPLOY.md, docker-compose and seed script included.

Quick start

pip install -r requirements.txt
# edit .env with your MySQL credentials
python main.py            # -> http://127.0.0.1:8000
Admin: admin / admin123   # change immediately after first login

License: single commercial end-product use. Resale / redistribution of source code is not permitted.