# Как пользоваться NAOMI — памятка

## Запуск (после перезагрузки ПК или когда всё выключено)

```bash
cd ~/NAOMI\ CLOUDE
./start.sh
```

Поднимет Postgres + шлюз + интерфейс и откроет браузер на **http://127.0.0.1:8420**.
Повторный запуск безопасен: если всё уже работает, просто напишет «уже работает».

Остановить: `./stop.sh`

## Запуск вручную (когда хочется видеть логи)

Два терминала:

```bash
# Терминал 1 — шлюз (биллинг, ходит в GLМ/z.ai)
node packages/gateway/src/server.js

# Терминал 2 — интерфейс агента (откроет браузер сам)
node packages/app/bin/naomi.js ui
```

Postgres поднять заранее: `docker start naomi-postgres` (нужен после перезагрузки ПК).
Остановка каждого — `Ctrl+C` в его терминале.

## Где что лежит

| Что | Где |
|---|---|
| Ключ GLM, тарифы, порт шлюза | `packages/gateway/.env` |
| Твой ключ NAOMI (клиент) | `~/.naomi.json` |
| База (ключи, аккаунты, платежи) | Postgres, база `naomi` |
| Лог шлюза / интерфейса | `/tmp/naomi-gw.log`, `/tmp/naomi-ui.log` |

## Полезные команды

```bash
npm run smoke                              # тест всей системы (14 проверок)
npm run admin -- keys                      # список ключей клиентов
npm run admin -- create-key 500 "Иван"     # выдать ключ на 500 ₡
npm run admin -- topup <ключ> 300          # пополнить баланс
npm run admin -- topups                    # заявки на пополнение
npm run admin -- topup-approve <id>        # подтвердить оплату
npm run admin -- usage                     # заработок за 30 дней
```

## Что-то не работает

1. `./start.sh` — он сам пишет, какой компонент не поднялся и где лог.
2. Смотри `tail -20 /tmp/naomi-gw.log` и `tail -20 /tmp/naomi-ui.log`.
3. `curl http://127.0.0.1:9913/health` — если отвечает JSON, шлюз жив.

Полная документация (архитектура, пополнение, ЮKassa, соц-входы, масштабирование): **README.md** рядом с этим файлом.
