🔐 Teleport — Документация для QA

Полное руководство по работе с Teleport, PgWeb, Dev DB и Backend Admin

1. Обзор инфраструктуры

2. Подключение к Teleport

Шаг 1. Запуск VPN (Shadowsocks)

# Проверить, работает ли уже
ss -tlnp | grep 1080

# Если нет — запустить
/tmp/sslocal -c /tmp/ss-config.json &

# Конфиг: /tmp/ss-config.json
# Method: 2022-blake3-aes-256-gcm (только shadowsocks-rust!)
# Бинарник: /tmp/sslocal (с github.com/shadowsocks/shadowsocks-rust)

Шаг 2. Логин в Teleport (интерактивный)

export HTTPS_PROXY=socks5://127.0.0.1:1080
export ALL_PROXY=socks5://127.0.0.1:1080

tsh login --proxy=t.chatplace.io:443 --user=n-kazakova-qa --auth=local
# → Enter password → OTP код (30 сек жизни)

Шаг 3. Проверка

tsh status
# Должно показать: Logged in as: n-kazakova-qa, Valid for 8h

3. PgWeb — SQL-запросы к review веткам

3.1 Логин в PgWeb ветки

# Пример для api-1764
export HTTPS_PROXY=socks5://127.0.0.1:1080
tsh apps login backend-pgweb-chatplace-api-XXXX-review-main-cluster

# Сертификаты автоматически сохраняются в ~/.tsh/keys/

3.2 API-запросы

# Переменные (подставить нужный номер ветки)
BRANCH=1764
APP="backend-pgweb-chatplace-api-${BRANCH}-review-main-cluster"
CERT="$HOME/.tsh/keys/t.chatplace.io/n-kazakova-qa-app/main/${APP}.crt"
KEY="$HOME/.tsh/keys/t.chatplace.io/n-kazakova-qa-app/main/${APP}.key"
BASE="https://${APP}.t.chatplace.io"
export HTTPS_PROXY=socks5://127.0.0.1:1080

3.3 Доступные эндпоинты PgWeb

3.4 Примеры SQL-запросов через PgWeb

# Список таблиц
curl -s --cert "$CERT" --key "$KEY" \
  "$BASE/api/query" \
  --data-urlencode "query=SELECT tablename FROM pg_tables WHERE schemaname='public' ORDER BY tablename"

# Структура таблицы
curl -s --cert "$CERT" --key "$KEY" \
  "$BASE/api/query" \
  --data-urlencode "query=SELECT column_name, data_type FROM information_schema.columns WHERE table_name='companies' ORDER BY ordinal_position"

# Произвольный запрос
curl -s --cert "$CERT" --key "$KEY" \
  "$BASE/api/query" \
  --data-urlencode "query=SELECT id, email FROM users LIMIT 5"

4. Dev DB — прямой доступ к PostgreSQL

4.1 Подключение

# Через proxychains (VPN должен работать)
proxychains4 -q -f /tmp/proxychains-local.conf psql \
  "host=34.175.47.255 port=5432 user=natasha_qa \
   password=ftb76RV657BTIGBYUf687ugyt \
   dbname=chatplace sslmode=require"

# Одиночный запрос (без интерактивного режима)
proxychains4 -q -f /tmp/proxychains-local.conf psql \
  "host=34.175.47.255 ..." -t -c "SELECT count(*) FROM users"

4.2 Ключевые таблицы для QA

4.3 subscription_logs types

5. Backend Admin — панель управления

5.1 Логин в админку review ветки

export HTTPS_PROXY=socks5://127.0.0.1:1080
tsh apps login backend-admin-chatplace-api-XXXX-review-main-cluster

# Открыть в браузере (через tsh proxy)
# или curl с сертификатами:
CERT="$HOME/.tsh/keys/t.chatplace.io/n-kazakova-qa-app/main/backend-admin-chatplace-api-XXXX-review-main-cluster.crt"
KEY="$HOME/.tsh/keys/t.chatplace.io/n-kazakova-qa-app/main/backend-admin-chatplace-api-XXXX-review-main-cluster.key"
curl -s --cert "$CERT" --key "$KEY" https://backend-admin-chatplace-api-XXXX-review-main-cluster.t.chatplace.io/

6. Сервисы на каждой review ветке

7. Текущие review ветки

8. DS-828 — Воспроизведение бага

8.1 Скриншот из задачи

8.2 Воспроизведение через SQL (Dev DB)

# Пример: rustam.chatplace@gmail.com — пропуски в ежемесячных начислениях (type=3)
proxychains4 -q -f /tmp/proxychains-local.conf psql "..." -t -c "
SELECT sl.type, sl.payment_count, to_char(sl.created_at, 'YYYY-MM') as month
FROM subscription_logs sl
JOIN users u ON u.id = sl.user_id
WHERE u.email = 'rustam.chatplace@gmail.com' AND sl.type = 3
ORDER BY sl.created_at
"

8.3 Результат — видны пропуски

8.4 Дополнительные проверки

# Все компании с ai_action_next_payment_at = NULL (дата сброса не установлена)
proxychains4 -q -f /tmp/proxychains-local.conf psql "..." -t -c "
SELECT count(*) as total,
       count(ai_action_next_payment_at) as with_next_payment,
       count(ai_action_last_reset_at) as with_last_reset
FROM companies
"
# Результат: 1797 всего, 0 с next_payment, 299 с last_reset
# → ai_action_next_payment_at = NULL у ВСЕХ компаний на dev!

8.5 Как воспроизвести через админку

1. Открыть Backend Admin (dev)
2. Войти (npkazakova@gmail.com / hTulILr7zhX4Vd5Q)
3. Найти пользователя по email (например rustam.chatplace@gmail.com)
4. Перейти в раздел «Планы»
5. Увидеть строку «ИИ-запросы» с кнопкой «Дата сброса»
6. Если дата не установлена — это причина пропуска начислений

9. Для Confluence

# QA — Доступ к инфраструктуре ChatPlace

## Teleport (t.chatplace.io)
- **Proxy:** t.chatplace.io:443
- **Auth:** пароль + OTP (TOTP)
- **Сессия:** 8 часов
- **Требуется VPN** (Shadowsocks SOCKS5)

### Доступные сервисы на каждой review ветке
| Сервис | Порт | Назначение |
|--------|------|------------|
| backend | 80 | API |
| backend-admin | 80 | Админ-панель |
| backend-dashboard | 80 | Dashboard |
| backend-pgweb | 8081 | SQL-доступ к БД |
| backend-webhook | 80 | Вебхуки |
| backend-mcp | 80 | MCP (не на всех) |

### PgWeb — SQL-запросы
```
tsh apps login backend-pgweb-chatplace-api-{BRANCH}-review-main-cluster
curl --cert $CERT --key $KEY "$BASE/api/query" --data-urlencode "query=SELECT ..."
```

### Dev DB (прямой доступ)
- Host: 34.175.47.255:5432
- Database: chatplace
- Доступ: READ-ONLY через proxychains

### Ключевые таблицы
- `companies` — проекты, AI-лимиты
- `subscription_logs` — логи подписок (type 1-12)
- `user_plans` — привязка юзер↔план
- `ai_action_pending_payments` — ожидающие AI-платежи

10. Для Qase