003
Archive 003Tool
SMM-Reseller
Custom SMM panel development: marketing site, order cabinet, RBAC admin, prepaid balance, and provider panel integrations. Social media growth platform (Instagram, Telegram, YouTube, TikTok) built with Next.js and FastAPI
01 /About
Custom SMM panel development: marketing site, order cabinet, RBAC admin, prepaid balance, and provider panel integrations. Social media growth platform (Instagram, Telegram, YouTube, TikTok) built with Next.js and FastAPI.
Delivered on commission, tailored to the client's requirements.
02 /🎯 Overview
- 01Branded SMM reseller: it does not run promotion itself, it mediates between clients and provider panels
- 02Three surfaces: marketing landing, user cabinet, and RBAC admin panel
- 03Prepaid balance: users top up → orders are charged from balance
- 04Two catalog layers: raw provider services and Store Services with markup, rename and publish
- 05Clients never see the provider, service_id or purchase cost
03 /🏗️ Architecture (monorepo)
- 01apps/web — Next.js 16 App Router: landing, cabinet, admin in one frontend
- 02services/api — FastAPI backend: auth, catalog, orders, payments, tickets, RBAC
- 03packages/shared-types — shared TypeScript types
- 04Backend layers: Router → Service → Model/DB; Provider Client is HTTP-only to external panels
- 05Workers (ARQ/Redis): order status polling, catalog sync, ticket/log cleanup
- 06Docker Compose: PostgreSQL + Redis for local development
04 /🖥️ Landing & public pages
- 01Hero, features, services, FAQ, CTA; GSAP animations
- 02Legal pages: Terms, Privacy, Refund
- 03Public API page for integrators
- 04SEO meta/OG; Manrope; light/dark theme
- 05i18n ru/en via next-intl with auto locale detection
05 /👤 User cabinet
- 01Dashboard: balance, activity, quick actions
- 02Catalog and new order: platforms/categories, tariffs, price calc, order types
- 03Order history with status and progress; cancel when provider supports it
- 04Balance deposit and transaction history
- 05Profile: username, email, password, preferences, device sessions
- 062FA (TOTP), user API keys (create / rotate / revoke)
- 07Support tickets with attachments; platform news feed
06 /🛠️ Admin panel
- 01Dashboard and statistics: orders, revenue, provider balances
- 02Providers: enable, API keys, balance check, catalog sync
- 03Store: categories, publish services, markups, descriptions, icons, order flags
- 04Orders: view, status sync, cancel, refund
- 05Users: profile, balance, per-user prices and global discount, block
- 06Finance, platform settings (markup, min deposit, maintenance, SMTP, notifications)
- 07Tickets with internal notes and assignment; news; activity/error logs
- 08RBAC: granular permissions, roles, role assignment
07 /🔌 Providers & orders
- 01Universal SMM Panel API v2: services, add, status, balance, cancel
- 02Client price = provider rate × (1 + markup%) + optional fixed fee
- 03Background poll of pending/in_progress orders; auto-sync of active catalogs
- 04Order progress fields and refunds per platform policy
08 /🔐 Auth & security
- 01Email/password registration and login, email verify, password reset
- 02JWT access + refresh, HttpOnly cookies, device sessions
- 032FA (pyotp), security email notifications
- 04Encrypted provider API keys, bcrypt passwords
- 05Security headers, rate limiting, user-facing error mapping
- 06Orders authenticated via session or user API key
09 /💰 Payments & finance
- 01Prepaid model: deposit → charge on order create
- 02Transactions: deposits, charges, refunds, admin adjustments
- 03Per-user service prices and global user discount
- 04Admin finance section and CSV export for users/logs
10 /🧩 Technical
- 01npm workspaces monorepo + Python backend
- 0230+ Alembic migrations (auth, catalog, orders, payments, tickets, RBAC, sessions, api keys)
- 03Async SQLAlchemy + asyncpg, Pydantic v2 schemas
- 04Localized emails (verify, reset, 2FA, security alerts)
- 05Platform notifications and in-app news
- 06Playwright e2e/smoke on frontend; pytest on API
- 07Responsive cabinet and admin UI
11 /Gallery
