[2026-10-10] eagle: personal/projects/personal-os/personal-os-db-browser.md personal/projects/personal-os/personal-os-system-review-index.md

2026-10-10 21:30:11 +06:00
1 parent 1c4f4e925c
commit 513655b754
@@ -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.
@@ -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. |