feat: Freelancer Match — полная продакшн версия с AI-матчингом и escrow

2026-07-03 12:12:43 +00:00
commit ec2e9bf508
37 changed files with 1564 additions and 0 deletions
@@ -0,0 +1,70 @@
+# 🤝 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-гарант) |
+
+## Быстрый старт
+
+```bash
+# Запуск инфраструктуры
+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-транзакцию |
+
+## Деплой
+
+```bash
+# Backend → Railway / AWS ECS
+# Frontend → Vercel
+# БД → Supabase / AWS RDS
+# Redis → Upstash
+```
+
+## Лицензия
+
+MIT © 2026 Freelancer Match