005
Archive 005Tool

Feedplace

A specialist/freelancer marketplace: profile cards with portfolios and services, reviews, real-time chat, orders, studios, and a Telegram bot

websites

Feedplace
01 /About

A specialist/freelancer marketplace: profile cards with portfolios and services, reviews, real-time chat, orders, studios, and a Telegram bot.

Developed for resale / as a future production project.

02 /🎯 Overview
  1. 01A discovery platform for specialists/freelancers: every user gets a profile card with a portfolio, services and reviews
  2. 02Positioning: "A platform for finding specialists. A profile, reviews and portfolio — all in one place"
  3. 03Three roles: specialist, client, administrator, chosen during onboarding after registration
  4. 04A separate sub-product, Webreview, is an independent directory of third-party websites with reviews
  5. 05Three UI locales (ru/uk/en) auto-detected via cookie, geo-IP and Accept-Language
03 /🏗️ Architecture
  1. 01Two-part monorepo: backend (FastAPI) and frontend (Next.js), no shared root config
  2. 02Backend: async SQLAlchemy 2.0 + asyncpg, PostgreSQL with UUID/JSONB, 35+ Alembic revisions
  3. 03Layers: routers → 24 *_services.py modules → models.py (32 tables) → database.py
  4. 04Redis is optional: rate limiting, JWT version revocation, settings/stats cache, WebSocket pub/sub across processes
04 /🧑‍💼 Specialist profiles
  1. 01Public page /{username} with tags, location, experience, languages; contacts gated behind login
  2. 02JSON resume (grade, skills, experience, education) plus a resume-tools catalog
  3. 03DiceBear avatars: ready-made styles, randomization, component-level builder
  4. 04Subscription-based styling (free/brand/studio): banner, background, theme, avatar frame, widget style
05 /🛒 Services and orders
  1. 01Services (Product entries) with price type, delivery time, deliverables, images
  2. 02Orders created from chat as proposals, with a counter-offer flow and manual payment confirmation
  3. 03Full lifecycle from proposed to completed, plus cancelled/disputed/refunded
  4. 04Guarantor payment mode is modeled (Payment, EscrowHold) but not yet wired to a payment provider
06 /🏢 Studios and teams
  1. 01Studio registration with admin moderation, public page at /studios/{slug}
  2. 02Team roles (owner/admin/manager/member), email-token invites
  3. 03Studio services from a shared catalog or custom entries, dedicated studio conversations
07 /⭐ Reviews, verification and trust
  1. 01Profile/website/studio reviews with rating + text and per-pair uniqueness
  2. 02Moderation and polymorphic complaint reports
  3. 03Specialist verification questionnaire with junior/middle/senior/expert badges
08 /💬 Messaging and notifications
  1. 01Real-time chat over REST + WebSocket with attachments, editing, read receipts, presence
  2. 0224 in-app notification kinds, auto-purged after a few days
  3. 03Configurable SMTP email notifications
09 /🤖 Telegram integration
  1. 01A dedicated aiogram 3 bot with menu, messages, notifications, services and support commands
  2. 02Account linking via deep link or Telegram Login/OIDC
  3. 03Platform notifications mirrored to Telegram
10 /🌐 Webreview and embeddable widget
  1. 01Directory of third-party websites with domain normalization and moderation
  2. 02Website reviews via upsert with an aggregate rating
  3. 03Embeddable rating widget (classic/premium) with open CORS
11 /🖥️ Dashboard and admin panel
  1. 01Specialist and client dashboards covering profile, services, messages, orders, support
  2. 02Admin panel: users, moderation, service catalog, tickets, site settings, SEO audit, analytics, logs
12 /🧩 Technical highlights
  1. 01Pydantic v2, JWT + bcrypt auth, Redis-backed rate limiting and JWT versioning
  2. 02Docker Compose (PostgreSQL 16 + Redis 7), managed Postgres support
  3. 03Unified 5xx error handling with a developer log
  4. 0418 FastAPI routers, 32 ORM models