44 lines
4.0 KiB
Markdown
Executable File
44 lines
4.0 KiB
Markdown
Executable File
---
|
||
tags:
|
||
- personal-os
|
||
- database
|
||
- runbook
|
||
updated: '2026-10-14'
|
||
---
|
||
# Браузер БД Personal OS
|
||
|
||
**Проверено 14.10.2026:** GitHub, ситуации, work items и designs находятся в основной `personal_os` после подтверждённого переноса 17 таблиц с совпавшими хешами. 121 work item / 17 репозиториев, 105 в очереди; 79 проверенных PR, 215 точных Asana–PR связей; 16 сигналов и 39 явных gaps. Локальный агент вызывается отдельно, его результат остаётся кандидатом. [Приёмка в репозитории](/Users/admin/Developer/personal-os/planning/github-work-situations-2026-10-14.md).
|
||
|
||
**Work items**: ручная связь с Asana, объединение контекста related repos, локальный учёт, исключение с причиной, отдельный вызов локального агента. **Tech designs**: задачи Asana и заметки Obsidian с версиями/hash; смысловой `draft_of` требует принятия. Новая Asana-задача сначала сохраняется локальным черновиком, затем создаётся отдельным действием из проверенного черновика. Сам агент внешних записей не делает. Содержимое внешних дизайн-документов пока не загружается.
|
||
|
||
Локальный интерфейс для просмотра данных 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`. Для постоянной работы после входа установлен LaunchAgent `com.personalos.db-browser`: он запускается при входе, удаляет `E1_COVERAGE_DATABASE_URL` и перезапускает браузер после неуспешного завершения. Статус: `launchctl print gui/$(id -u)/com.personalos.db-browser`. Остановить и выгрузить: `launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.personalos.db-browser.plist`. Исходный plist находится в `scripts/com.personalos.db-browser.plist`.
|
||
|
||
Проверить доступность интерфейса и источников:
|
||
|
||
```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 после поставки 14.10 ожидаются `sources.e1=true`, `evidence_origin=primary`, `work_dashboard=true`, `local_resolution_enabled=true`, `read_only=false`. Последнее означает наличие действий через host runner; SQL-соединения браузера по-прежнему read-only. Если соединение не устанавливается, проверить PostgreSQL на `localhost:5432`, поле `database` в `config.json` и отсутствие старого `E1_COVERAGE_DATABASE_URL`.
|
||
|
||
## Ссылки
|
||
|
||
Исходники и подробности интерфейса: `web/db-browser/` и `web/db-browser/README.md` в репозитории personal-os.
|