diff --git a/personal/projects/personal-os/personal-os-db-browser.md b/personal/projects/personal-os/personal-os-db-browser.md new file mode 100644 index 00000000..8da9b7af --- /dev/null +++ b/personal/projects/personal-os/personal-os-db-browser.md @@ -0,0 +1,38 @@ +--- +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. diff --git a/personal/projects/personal-os/personal-os-system-review-index.md b/personal/projects/personal-os/personal-os-system-review-index.md index 399dedcb..889d8bf7 100755 --- a/personal/projects/personal-os/personal-os-system-review-index.md +++ b/personal/projects/personal-os/personal-os-system-review-index.md @@ -13,6 +13,7 @@ updated: 2026-10-05 | Документ | Назначение | |---|---| +| [[personal-os-db-browser]] | Локальный браузер БД: запуск на `127.0.0.1:4317`, источник `personal_os` на `localhost:5432`, проверка режима read-only. | | [[personal-os-action-plan-2026-10-05]] | Текущая очередь E1–E5: ближайшие пакеты, поставки, проверки и зависимости. | | [[personal-os-system-review-2026-10-04]] | Полный план: роли, data flow, инструкции, расписания, SC1–SC8, AC01–AC16 и R0–R4. | | [[personal-os-evidence-graph-design-2026-10-04]] | Конкретные таблицы, ключи, typed relations, время, discovery, принятие claims, lineage и публикация. Заменяет ранний иллюстративный DDL. |