freelancer-match/README.md

🤝 Freelancer Match — Умная площадка для фрилансеров

Площадка с AI-матчингом и escrow-гарантом сделок.

Архитектура

┌───────────────┐    ┌───────────────┐    ┌───────────────┐
│   Next.js     │    │  FastAPI      │    │   Redis       │
│   (Frontend)  │◄──►│  (Backend)    │◄──►│  (Cache/Queue)│
└───────────────┘    └───────┬───────┘    └───────────────┘
                            │
                    ┌───────▼───────┐
                    │ PostgreSQL +  │
                    │ pgvector      │
                    └───────────────┘

Стек

Компонент	Технология
Backend	Python 3.12, FastAPI, SQLAlchemy 2.0
Frontend	Next.js 14+, Tailwind CSS, shadcn/ui
БД	PostgreSQL 16 + pgvector (AI-эмбеддинги)
Кэш/Очереди	Redis 7+
AI	OpenAI embeddings + LLM для матчинга
Платежи	Stripe Connect (escrow-гарант)

Быстрый старт

# Запуск инфраструктуры
docker compose up -d postgres redis

# Backend
cd backend
cp .env.example .env  # настройте переменные
pip install -r requirements.txt
uvicorn app.main:app --reload

# Frontend
cd frontend
npm install
npm run dev

API Endpoints

Метод	Endpoint	Описание
POST	/api/auth/register	Регистрация
POST	/api/auth/login	Логин (JWT)
GET	/api/projects?status=open	Список проектов
POST	/api/projects	Создать проект
POST	/api/ai/match-project	AI-подбор фрилансеров
POST	/api/escrow/create	Создать escrow-транзакцию

Деплой

# Backend → Railway / AWS ECS
# Frontend → Vercel
# БД → Supabase / AWS RDS
# Redis → Upstash

Лицензия

MIT © 2026 Freelancer Match