Как я без навыков fullstack-разработчика сделал свой SaaS

API_HOST   = "127.0.0.1"
API_PORT   = 8080
API_SECRET = "sixseven"
USERS = {
    "s"   : "ss",
    "user": "password",
    "test": "12345",
}
ALLOWED = {
    "s"   : False,
    "user": True,
    "test": False,
}
def get_online_users():
    url = f"http://{API_HOST}:{API_PORT}/online"
    headers = {"Authorization": API_SECRET}
    try:
        r = requests.get(url, headers=headers, timeout=5)
        r.raise_for_status()           # выбросит ошибку, если не 200
        return r.json()                # {"username": connection_count, ...}
    except requests.exceptions.HTTPError as e:
        print(f"API вернул ошибку {r.status_code}: {r.text}")
        return {}
    except requests.exceptions.RequestException as e:
        print(f"Ошибка подключения к API: {e}")
        return {}

src/styles/
├── tokens.ts        — атомарные токены (typography, surface, radius, …)
├── animations.ts    — transition, hover, press, enter, loading
├── variants.ts      — colorScheme + тип ColorScheme
├── index.ts         — единая точка входа, реэкспортирует всё
└── cStyles/         — стили компонентов, разбитые по папкам src/components/
    ├── uiStls.ts        компоненты из components/ui/
    ├── commonStls.ts    компоненты из components/common/
    ├── layoutStls.ts    компоненты из components/layout/
    ├── dashboardStls.ts → компоненты из components/dashboard/
    ├── usersStls.ts     → компоненты из components/users/
    ├── serversStls.ts   → компоненты из components/servers/
    └── pagesStls.ts     → компоненты из pages/

#!/usr/bin/env bash
#
# Скрипт pack — упаковка частей проекта htrBox в .tar архивы
# Все архивы сохраняются на уровень выше проекта (/Users/stas/projects/)
#
# Использование:
#   pack          -> весь проект (кроме исключений)
#   pack back     -> backend + docker-compose.yaml + .env
#   pack front    -> frontend + docker-compose.yaml + .env
#   pack --dry-run [all|back|front]  -> только показать команду tar, не выполнять
#
set -euo pipefail
# ------------------------------------------------
#          ЖЁСТКО ЗАХАРДКОЖЕННЫЕ ПУТИ
# ------------------------------------------------
readonly PROJECT_ROOT="/Users/stas/projects/htrBox"
readonly OUTPUT_DIR="$(dirname "$PROJECT_ROOT")"   # -> /Users/stas/projects
readonly PROJECT_NAME="htrBox"
# ------------------------------------------------
#     Список исключений (при pack без аргументов)
# ------------------------------------------------
declare -a EXCLUDES=(
    ".git"
    ".env"
    "backend/venv"
    "backend/.DS_Store"
    "frontend/node_modules"
    "frontend/.DS_Store"
    "frontend/package-lock.json"
    ".DS_Store"
    "other"
    "exclude.txt"
)
и тд ...

• TanStack Query — для автоматического обновления данных на странице
  
• Zustand + localStorage — для кэширования состояния между сессиями
  
• wouter — лёгкий роутер для навигации, значительно проще React Router
  
• httpOnly cookie — для хранения refresh token; проставляется через заголовок в ответе бэкенда

# ----------------------------------------------------
# ДЕПЛОЙ Yandex Cloud (frontend + backend + postgres)
# ----------------------------------------------------
deploy_yc() {
  echo ""
  echo "-------------------------------------------"
  echo "  🚀 Деплой -> Yandex Cloud ($YC_HOST)"
  echo "-------------------------------------------"
  [ ! -f "$SCRIPT_DIR/certificates/yandex-cloud.ini" ] && fail "certificates/yandex-cloud.ini не найден"
  [ ! -f "$SCRIPT_DIR/infra/.env" ]                    && fail "infra/.env не найден"
  [ ! -f "$SCRIPT_DIR/infra/nginx.conf" ]              && fail "infra/nginx.conf не найден"
  log "Создаём директории на YC..."
  ssh -i "$YC_KEY" "$YC_USER@$YC_HOST" "mkdir -p $YC_DIR $YC_DATA_DIR/pgdata"
  log "Копируем backend/ на YC..."
  tar -czf /tmp/backend.tar.gz \
    --exclude="venv" \
    --exclude="__pycache__" \
    --exclude="*.pyc" \
    --exclude="pytest.ini" \
    --exclude=".pytest_cache" \
    --exclude="requirements-dev.txt" \
    --exclude="TODO" \
    -C "$PROJECT_ROOT" backend
  scp -i "$YC_KEY" /tmp/backend.tar.gz "$YC_USER@$YC_HOST:/tmp/"
  ssh -i "$YC_KEY" "$YC_USER@$YC_HOST" "tar --warning=no-unknown-keyword -xzf /tmp/backend.tar.gz -C $YC_DIR && rm /tmp/backend.tar.gz"
  rm /tmp/backend.tar.gz
  log "Копируем frontend/ на YC..."
  tar -czf /tmp/frontend.tar.gz \
    --exclude="node_modules" \
    --exclude="dist" \
    --exclude="TODO" \
    --exclude="nginx.conf" \
    -C "$PROJECT_ROOT" frontend
  scp -i "$YC_KEY" /tmp/frontend.tar.gz "$YC_USER@$YC_HOST:/tmp/"
  ssh -i "$YC_KEY" "$YC_USER@$YC_HOST" "tar --warning=no-unknown-keyword -xzf /tmp/frontend.tar.gz -C $YC_DIR && rm /tmp/frontend.tar.gz"
  rm /tmp/frontend.tar.gz
  # nginx.conf для prod передаётся отдельно, поверх распакованного frontend/
  # dev-файл (frontend/nginx.conf в репозитории) не затрагивается
  log "Копируем prod nginx.conf на YC (infra/nginx.conf -> frontend/nginx.conf)..."
  scp -i "$YC_KEY" "$SCRIPT_DIR/infra/nginx.conf" "$YC_USER@$YC_HOST:$YC_DIR/frontend/nginx.conf"
  log "Копируем docker-compose и .env..."
  scp -i "$YC_KEY" "$SCRIPT_DIR/infra/docker-compose.yaml" "$YC_USER@$YC_HOST:$YC_DIR/docker-compose.yaml"
  scp -i "$YC_KEY" "$SCRIPT_DIR/infra/.env"                "$YC_USER@$YC_HOST:$YC_DIR/.env"
  log "Копируем Cloudflare токен..."
  ssh -i "$YC_KEY" "$YC_USER@$YC_HOST" "mkdir -p ~/.secrets && chmod 700 ~/.secrets"
  scp -i "$YC_KEY" "$SCRIPT_DIR/certificates/yandex-cloud.ini" "$YC_USER@$YC_HOST:~/.secrets/cloudflare-yc.ini"
  ssh -i "$YC_KEY" "$YC_USER@$YC_HOST" "chmod 600 ~/.secrets/cloudflare-yc.ini"
  log "Проверяем сертификат для stdoq.ru..."
  ssh -i "$YC_KEY" "$YC_USER@$YC_HOST" '
    CERT_PATH="/etc/letsencrypt/live/stdoq.ru/fullchain.pem"
    RENEW_NEEDED=false
    if [ ! -f "$CERT_PATH" ]; then
      echo "  -> Сертификат не найден, получаем новый..."
      RENEW_NEEDED=true
    else
      EXPIRY=$(openssl x509 -enddate -noout -in "$CERT_PATH" | cut -d= -f2)
      EXPIRY_TS=$(date -d "$EXPIRY" +%s 2>/dev/null || date -j -f "%b %d %T %Y %Z" "$EXPIRY" +%s 2>/dev/null)
      NOW_TS=$(date +%s)
      DAYS_LEFT=$(( (EXPIRY_TS - NOW_TS) / 86400 ))
      echo "  -> Сертификат найден, осталось дней: $DAYS_LEFT"
      [ "$DAYS_LEFT" -lt 30 ] && RENEW_NEEDED=true
    fi
    if [ "$RENEW_NEEDED" = true ]; then
      if ! command -v certbot &>/dev/null; then
        echo "  -> Устанавливаем certbot..."
        sudo apt-get update -qq && sudo apt-get install -y -qq certbot python3-certbot-dns-cloudflare
      fi
      sudo certbot certonly \
        --dns-cloudflare \
        --dns-cloudflare-credentials ~/.secrets/cloudflare-yc.ini \
        -d stdoq.ru -d www.stdoq.ru \
        --email ТУТ БЫЛ МОЙ EMAIL@yandex.ru \
        --agree-tos --no-eff-email \
        --non-interactive
      echo "  -> Сертификат получен ✓"
    else
      echo "  -> Сертификат актуален, пропускаем ✓"
    fi
  '
  log "Запускаем контейнеры (--build)..."
  ssh -i "$YC_KEY" "$YC_USER@$YC_HOST" "
    cd $YC_DIR
    docker compose -f docker-compose.yaml up -d --build --force-recreate frontend backend postgres
    docker image prune -f
  "
  echo ""
  echo "---- Статус контейнеров ----"
  ssh -i "$YC_KEY" "$YC_USER@$YC_HOST" "docker ps --filter name=frontend --filter name=backend --filter name=postgres --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'"
  echo ""
  echo "---- Логи backend (последние 20 строк) ----"
  ssh -i "$YC_KEY" "$YC_USER@$YC_HOST" "docker logs backend --tail=20"
  log "Yandex Cloud задеплоен ✓"
}