chore: улучшен интерфейс работы с моделями

src/App/README.md

@@ -16,9 +16,18 @@ Django приложение связывающее все части сайта
 
 С маскировкой клиенты подключаются к серверу маскировки, он перенаправляет трафик на панель и скрывает ее адрес. Маскировка требует домен.
 
+Работа с записями идет через менеджеры и методы моделей, а не через `filter`/`create` напрямую:
+
+- создание: `Point.objects.create_point(owner, panel, mask=None, *, domain, cloudflare, outbound_proxy)` создает точку вместе с серверами, имя и доступ к панели генерирует сама. `Server.objects.create_server(point, role, credentials)`. `Credentials` - адрес и пароль root, которые прислал пользователь
+- поиск: `Point.objects.owned_by(owner)`, дальше `find_by_name`, `find_by_pk`, `find_last`. У серверов `find_by_address` и `is_address_taken`, в том числе в пределах точки через `point.servers`
+- изменение: `point.set_status(status, error)`, `server.reset_fingerprint()`
+- удаление: `point.delete()`, серверы удаляются вместе с точкой
+
+Соглашение для поиска: `get_*` и `point.server(role)` бросают `DoesNotExist`, если записи нет, а `find_*` возвращают `None`, и это видно по типу. `point.panel` всегда есть, потому что панель создается вместе с точкой, а `point.mask` может быть `None`.
+
 ## Модули
 
-- `services.py` - сценарии поверх serverus: `create_point`, `install_point`, `reinstall`, `release_point`.
+- `services.py` - сценарии поверх serverus: `install_point`, `reinstall`, `release_point`.
 - `tasks.py` - задачи dramatiq: запускают сценарий и присылают результат в чат. Воркер: `make dj_worker`.
 - `bot/interface.py` - интерфейс бота `MyPointInterface` (выбирается у бота в админке).
 - `bot/texts.py` - кнопки и тексты.