Files
obsidian-vault/personal/projects/personal-os/personal-os-db-browser.md
T

39 lines
1.7 KiB
Markdown

---
tags:
- personal-os
- database
- runbook
---
# Браузер БД Personal OS
Локальный интерфейс для просмотра данных Personal OS на `http://127.0.0.1:4317`.
## Источник данных
По умолчанию браузер использует PostgreSQL из корневого `config.json`: база `personal_os` на `localhost:5432`. Таблицы E1 находятся в этой же базе. Переменная `E1_COVERAGE_DATABASE_URL` подключает отдельную базу только для тестирования; для обычного просмотра её не задавать.
Все подключения браузера используют PostgreSQL `default_transaction_read_only=on`. Сам интерфейс слушает только loopback-адрес `127.0.0.1`.
## Запуск
Из корня репозитория:
```sh
env -u E1_COVERAGE_DATABASE_URL npm run db:browser
```
Открыть `http://127.0.0.1:4317`. Остановка процесса — `Ctrl-C`.
Проверить доступность интерфейса и источников:
```sh
curl -fsS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:4317/
curl -fsS http://127.0.0.1:4317/api/bootstrap
```
В bootstrap ожидаются `sources.e1=true` и `read_only=true`. Если соединение не устанавливается, проверить PostgreSQL на `localhost:5432`, поле `database` в `config.json` и отсутствие старого `E1_COVERAGE_DATABASE_URL`.
## Ссылки
Исходники и подробности интерфейса: `web/db-browser/` и `web/db-browser/README.md` в репозитории personal-os.