Freelancer Match — Умная площадка для фрилансеров
Площадка для фрилансеров и заказчиков с AI-подбором, escrow-гарантом сделок и рейтинговой системой.
🚀 Быстрый старт
Требования
- Docker + Docker Compose
- Python 3.12+ (для локальной разработки)
- Node.js 20+ (для фронтенда)
- PostgreSQL 16+
- Redis 7+
Запуск через Docker Compose
# 1. Скопируйте .env.example в .env и заполните переменные
cp backend/.env.example backend/.env
# 2. Запустите стек
docker compose up -d --build
# 3. Примените миграции БД
docker compose exec backend alembic upgrade head
# 4. Проверьте что всё работает
curl http://localhost:8000/api/health
Локальная разработка
Backend
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000
Frontend
cd frontend
npm ci
npm run dev
🔑 Настройка переменных окружения
Скопируйте backend/.env.example в backend/.env и заполните значения.
Обязательные (без них не запустится)
| Переменная | Описание | Где взять |
|---|---|---|
DATABASE_URL |
Подключение к PostgreSQL | Создайте БД: createdb freelancer_match |
REDIS_URL |
Подключение к Redis | По умолчанию: redis://localhost:6379/0 |
SECRET_KEY |
Ключ для JWT токенов | Сгенерируйте: openssl rand -hex 32 |
Опциональные (но нужны для полноценной работы)
| Переменная | Описание | Где взять |
|---|---|---|
OPENAI_API_KEY |
API ключ OpenAI для AI-матчинга | platform.openai.com/api-keys |
STRIPE_SECRET_KEY |
Ключ Stripe для escrow | dashboard.stripe.com/test/keys (Test mode) |
STRIPE_WEBHOOK_SECRET |
Секрет для webhook Stripe | Настройте в Stripe Dashboard → Webhooks |
Email (опционально)
| Переменная | Описание | Где взять |
|---|---|---|
SMTP_USER |
Email для отправки писем | Ваш email (Gmail, Mail.ru и т.д.) |
SMTP_PASSWORD |
Пароль SMTP | Для Gmail — используйте App Passwords (не обычный пароль) |
OAuth (опционально, если хотите вход через Google/GitHub)
| Переменная | Описание | Где взять |
|---|---|---|
GOOGLE_CLIENT_ID |
OAuth client ID для входа через Google | Google Cloud Console |
GITHUB_CLIENT_ID + GITHUB_CLIENT_SECRET |
OAuth для GitHub | GitHub Developer Settings → OAuth Apps |
📁 Структура проекта
freelancer-match/
├── backend/ # FastAPI бэкенд
│ ├── app/
│ │ ├── api/ # API endpoints
│ │ ├── models/ # SQLAlchemy модели
│ │ ├── schemas/ # Pydantic схемы
│ │ ├── services/ # Бизнес-логика
│ │ └── core/ # Базовые модули (БД, безопасность)
│ ├── alembic/ # Миграции БД
│ ├── tests/ # Тесты pytest
│ ├── Dockerfile
│ └── requirements.txt
├── frontend/ # Next.js фронтенд
│ ├── app/ # App Router (pages)
│ ├── components/ui/ # UI компоненты
│ ├── lib/ # Утилиты и провайдеры
│ ├── Dockerfile
│ └── package.json
├── docker-compose.yml # Стек сервисов
└── .drone.yml # CI/CD для Drone CI
🧪 Тесты
# Backend (pytest)
cd backend && pytest tests/ -v
# Frontend (linting)
cd frontend && npx next lint
🔒 Безопасность
- JWT аутентификация с refresh токенами
- Хеширование паролей через bcrypt
- CORS middleware
- Escrow-гарант сделок (Stripe интеграция)
- AI-матчинг с pgvector эмбеддингами
📊 API Endpoints
| Метод | Endpoint | Описание |
|---|---|---|
| POST | /api/auth/register |
Регистрация пользователя |
| POST | /api/auth/login |
Вход (JWT) |
| GET | /api/projects |
Список проектов |
| POST | /api/projects |
Создать проект |
| POST | /api/ai/match-project |
AI-подбор фрилансеров |
| POST | /api/escrow/create |
Создать escrow-транзакцию |
🚀 Деплой на сервер
# 1. Настройте .env.production
cp backend/.env.example backend/.env.production
# 2. Обновите docker-compose.yml для продакшена (уберите порты, добавьте healthcheck)
# 3. Запустите через Docker Compose
docker compose -f docker-compose.prod.yml up -d --build
# 4. Примените миграции
docker compose exec backend alembic upgrade head
🤖 CI/CD (Drone CI)
Проект настроен для автоматического деплоя через Drone CI:
.drone.yml— пайплайн с тестами, сборкой и деплоем- Настроен на Gitea (
ms.webhop.me) - Автоматический запуск при push в main
📝 Лицензия
MIT © 2026 Freelancer Match