Skip to content

Add home infrastructure account registries - #48

Closed
krotname wants to merge 2 commits into
mainfrom
claude/personal-accounts-registry-19dqpf
Closed

krotname wants to merge 2 commits into
mainfrom
claude/personal-accounts-registry-19dqpf

Conversation

@krotname

@krotname krotname commented Aug 26, 2026

Copy link
Copy Markdown
Owner

Что добавлено

Каталог docs/home-infrastructure/ с двумя реестрами домашней инфраструктуры в виде выровненных Markdown-таблиц.

  • registry-web-accounts.md — всё, куда можно зайти браузером: провайдеры и домены, ЖКХ и госуслуги, сеть, серверы и self-hosted, умный дом и видеонаблюдение. 54 строки со стандартными локальными адресами админок (192.168.1.1, :8006 Proxmox, :8123 Home Assistant и т. д.).
  • registry-no-web-ui.md — всё, у чего веб-интерфейса нет: доступ только по SSH и локальной консоли, устройства с одним лишь мобильным приложением, управление по SMS и кнопкам на корпусе, и офлайн-секреты, которые не восстанавливаются письмом на почту.
  • README.md — легенда колонок, схема ID, порядок заполнения и правила гигиены доступа.

Это шаблон, а не заполненный реестр

Файлы остаются с плейсхолдерами. Заполнять их на месте и коммитить нельзя, и дело не только в паролях: логины, номера договоров и лицевых счетов, точные адреса и порты сервисов и сам перечень техники — роутеры, камеры, замки, банк, госуслуги — это карта дома, полезная и без единого пароля.

Порядок работы описан в README: шаблон копируется в файл с суффиксом .local.md, заполняется только копия. .gitignore дополнен масками *.local.md, *.secrets.md и home-infra-secrets*, чтобы такие копии не попали в индекс по случайному git add -A; в README отдельно оговорено, что это подстраховка, а не защита.

Обращение с секретами

В репозиторий не попадает ни одного пароля, ключа, PIN-кода или резервного кода 2FA. Вместо значения в колонке «Секрет» стоит указатель на запись в менеджере паролей вида pm://хранилище/запись.

Имя записи строится из ID строки в нижнем регистре и короткого читаемого имени: строка NET-01 → запись net-01-router, строка LK-01 → запись lk-01-isp. Префикс с ID связывает строку и запись однозначно, хвост нужен, чтобы список в менеджере паролей читался без реестра.

Строки KEY-01 (мастер-пароль хранилища) и KEY-02 (резервные коды 2FA) — единственные без указателя pm://: они открывают само хранилище и по определению не могут в нём лежать.

Адреса админок

Порты в колонке «Адрес входа» — заводские значения по умолчанию, у каждого продукта свой: строка «Бэкапы» несёт и :8200 Duplicati, и :8007 Proxmox Backup Server, строка NAS — :5001 DSM, :8080 QNAP и :443 TrueNAS, и так далее. Для Frigate указан :8971 — интерфейс с аутентификацией; под таблицей оговорено, что порт :5000 отдаёт UI, API и видео вообще без проверки пароля.

Формат

Таблицы выровнены по ширине колонок — ровно так, как их приводит команда Align Table самого плагина, поэтому файлы заодно служат живым примером его вывода на широких таблицах с кириллицей.

Проверка

Все табличные блоки проверены на прямоугольность: в каждом блоке строки имеют одинаковую длину и одинаковое число разделителей. Внутренние ссылки между файлами разрешаются, маска .local.md проверена через git check-ignore. Изменения затрагивают только документацию — код плагина, ресурсы и сборка не тронуты.

Adds two Markdown-table registries under docs/home-infrastructure:

- registry-web-accounts.md: services and devices reachable through a
  browser, grouped into providers, utilities, network, servers and
  smart home, prefilled with the standard local admin addresses.
- registry-no-web-ui.md: everything without a web interface — SSH-only
  hosts, app-only devices, SMS and panel control, and offline secrets
  that cannot be recovered by email.

No credentials are stored in the repository. The registries reference
password-manager entries through a pm://<vault>/<entry> pointer whose
entry name matches the row ID. README documents the column legend, the
fill-in order and the access hygiene rules; .gitignore now excludes the
local plaintext companion file.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JmyaT7avw51m44oq4yEboS
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for security reviews. Please try again later.

@codecov

codecov Bot commented Aug 26, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a6bfe35b0b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/home-infrastructure/README.md Outdated
Comment thread docs/home-infrastructure/README.md Outdated
Comment thread docs/home-infrastructure/registry-web-accounts.md Outdated
Comment thread docs/home-infrastructure/registry-web-accounts.md Outdated
- Require personalized copies to live under an ignored filename. The
  checked-in files are templates and say so in a banner; README spells
  out that filling them in place and committing would publish logins,
  account numbers, service endpoints and a device inventory, none of
  which is made safe by omitting passwords alone.
- Describe the password-manager entry naming as it is actually used:
  the entry name starts with the lowercased row ID and carries a short
  readable suffix, so NET-01 maps to net-01-router rather than net-01.
- Give each product in a multi-product row its own default endpoint
  instead of one port that only fits the first product: Proxmox Backup
  Server answers on 8007 while 8200 is Duplicati, and the same split
  applies to the NAS, Wi-Fi controller, DNS filter, media, photo,
  monitoring and download rows.
- Point Frigate at 8971, its authenticated interface. Port 5000 serves
  UI, API and video with no authentication at all, so listing it beside
  a login implied a protection that is not there.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JmyaT7avw51m44oq4yEboS
@krotname krotname closed this Aug 26, 2026
@krotname
krotname deleted the claude/personal-accounts-registry-19dqpf branch August 26, 2026 15:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants