Перейти до основного вмісту

Локальна розробка

Посібник зі встановлення Sentry Analytics локально.

📋 Передумови​

  • Python 3.11+
  • Node.js 18+
  • PostgreSQL 14+
  • Google Cloud SDK

🚀 Швидкий старт​

Backend​

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Start server
uvicorn main:app --reload --port 8000

Frontend​

cd dashboard_app
npm install
npm run dev

Scraping Service​

cd backend
source venv/bin/activate
python scraping_service.py

🔧 Налаштування середовища​

Створіть файл .env у /backend:

# Database
DATABASE_URL=postgresql://user:pass@localhost:5432/vartovii

# Google Cloud
GOOGLE_CLOUD_PROJECT=sentry-analytics-prod
GOOGLE_APPLICATION_CREDENTIALS=./keys/service-account.json

# AI
AI_LOCATION=europe-west4
AGENT_API_KEY=your-api-key

🔐 Авторизація Google Cloud​

Для локальної розробки:

gcloud auth application-default login

📊 База даних​

Первинне налаштування​

cd backend
alembic upgrade head

Заповнення даними​

python scripts/seed_data.py

🌐 URL-адреси​

СервісURL
Backend APIhttp://localhost:8000
Документація APIhttp://localhost:8000/docs
Frontendhttp://localhost:5173
База знаньhttp://localhost:3000

🛠️ Корисні команди​

# Run tests
pytest tests/

# Format code
black .

# Lint
flake8 .

# Type check
mypy .

Використовуйте scripts/startup.sh для автоматичного запуску.