71 lines
2.3 KiB
Markdown
71 lines
2.3 KiB
Markdown
|
# 🤝 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
|