[2026-11-18] eagle: personal/projects/personal-os/README.md personal/projects/personal-os/github-work-situations-2026-10-14.md personal/projects/personal-os/personal-os-action-plan-2026-10-05.md personal/projects/personal-os/personal-os-architecture.md personal/projects/personal-os/personal-os-asana-coverage.md personal/projects/personal-os/personal-os-asana-worker.md personal/projects/personal-os/personal-os-db-browser.md personal/projects/personal-os/personal-os-evidence/2026-11-18/windmill-six-workflows.json personal/projects/personal-os/personal-os-first-day.md personal/projects/personal-os/personal-os-fixes-2026-11-13.md

This commit is contained in:
Alexey Martemyanov committed 2026-11-18 19:00:24 +06:00
1 parent a9bae8a39e
commit 80af10ff9d
22 files changed
+949 -6623

No files matched your search

@@ -1,43 +1,23 @@
---
tags:
- personal-os
- database
- runbook
updated: '2026-10-14'
---
# Браузер БД Personal OS
# Портал 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).
Начальный маршрут — [Сегодня](http://127.0.0.1:4317/#/today). Портал читает сохранённые результаты и показывает основания действий; сам факт открытия страницы не пересчитывает все источники.
**Work items**: ручная связь с Asana, объединение контекста related repos, локальный учёт, исключение с причиной, отдельный вызов локального агента. **Tech designs**: задачи Asana и заметки Obsidian с версиями/hash; смысловой `draft_of` требует принятия. Новая Asana-задача сначала сохраняется локальным черновиком, затем создаётся отдельным действием из проверенного черновика. Сам агент внешних записей не делает. Содержимое внешних дизайн-документов пока не загружается.
## Основные разделы
Локальный интерфейс для просмотра данных Personal OS на `http://127.0.0.1:4317`.
- **Сегодня** — действия, причины выбора, рабочие ссылки, ожидания и доступное время.
- **Мои задачи** — очереди, уточнения, локальные сигналы и сверка дня. `#/my-tasks?clarification=ID` открывает точную карточку.
- **Weekly Review** — неделя, цели, распределение и переносы.
- **Work History** — датированные результаты, проекты, источники и интервалы с неизвестной связью.
- **Состояние системы** — свежесть, удержания, пересчёт и квитанции.
- **Ситуации**, **Work items**, **Ворктри**, **Tech designs** — связи и кандидатные интерпретации работы.
- **Inbox** — рабочие события подписок; **Asana Inbox** — отдельная сохранённая выгрузка с датой. Неполная выгрузка не подменяет полный источник.
## Источник данных
В карточке работы доступен анализ Claims, его версии, цитаты и решения. SQL-просмотр read-only; действие принятия выполняется отдельным обработчиком с проверкой ревизии. Кандидат модели не принимается при открытии карточки.
По умолчанию браузер использует PostgreSQL из корневого `config.json`: база `personal_os` на `localhost:5432`. Таблицы E1 находятся в этой же базе. Переменная `E1_COVERAGE_DATABASE_URL` подключает отдельную базу только для тестирования; для обычного просмотра её не задавать.
## Разработка
Все подключения браузера используют PostgreSQL `default_transaction_read_only=on`. Сам интерфейс слушает только loopback-адрес `127.0.0.1`.
Клиент — `app.js`, стили — `style.css`, сервер — `../../scripts/db-browser.js`. Разрешённые статические файлы заданы сервером. После изменения серверного обработчика требуется безопасное обновление процесса; изменение файла не доказывает загрузку.
## Запуск
`npm run test:db-browser` — целевые тесты. `npm run test:db-browser:integration` требует изолированной БД. Проверка страницы включает фактический DOM, ссылки, данные, узкий экран, изменение источника и ошибки JavaScript.
Из корня репозитория:
```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.
[Инструкция пользователя](personal-os-first-day.md) · [Готовность](personal-os-production-acceptance.md) · [Эксплуатация](personal-os-operations.md)