[CI SKIP] Initial commit

2026-02-07 12:36:13 +03:00
commit 52073bf2f9
17 changed files with 486 additions and 0 deletions
--- a/docs/DEVELOPER.md
+++ b/docs/DEVELOPER.md
@@ -0,0 +1,20 @@
+# Разработчику
+
+## Окружение
+
+Перейдите в каталог репозитория и настройте переменные окружения (см. `README.md`).
+
+Пример `.env`:
+
+```
+DEV_DB_URL=postgresql://user:pass@localhost:5432/project-dev?sslmode=disable
+DB_URL=postgresql://user:pass@localhost:5432/project?sslmode=disable
+```
+
+## Миграции
+
+- Первичная миграция: `make initial`.
+- Новая миграция после изменений схем: `make migration`.
+- Применить миграции: `make apply`.
+
+Все команды используют `DEV_DB_URL` и `DB_URL` из окружения.
--- a/docs/diagrams/mermaid.esm.min.mjs
+++ b/docs/diagrams/mermaid.esm.min.mjs
--- a/docs/diagrams/preview.html
+++ b/docs/diagrams/preview.html
@@ -0,0 +1,36 @@
+<!DOCTYPE html>
+<html lang="ru">
+  <head>
+    <meta charset="utf-8" />
+    <title>ORM Template — User ERD</title>
+    <style>
+      body { font-family: system-ui, -apple-system, Segoe UI, Roboto, Ubuntu, Cantarell, 'Helvetica Neue', Arial; padding: 16px; }
+      h2 { margin-bottom: 4px; }
+      h3 { margin-top: 28px; }
+      .hint { color: #666; font-size: 0.9em; }
+      pre.mermaid { border: 1px solid #ddd; border-radius: 8px; padding: 12px; }
+    </style>
+  </head>
+  <body>
+    <h2>ORM Template — ER-диаграмма</h2>
+    <div class="hint">Единственная модель: User и ее атрибуты.</div>
+
+<pre class="mermaid">
+erDiagram
+    USER {
+        uuid id PK "первичный ключ пользователя"
+        text login "уникальный логин"
+        text password "хэш пароля"
+        text role "роль пользователя"
+        bool is_active "активность"
+        bool is_temporal "пароль временный, хранится в открытом виде"
+        timestamptz created_at "дата создания"
+    }
+</pre>
+
+    <script type="module">
+      import mermaid from "https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs";
+      mermaid.initialize({ startOnLoad: true, theme: "neutral" });
+    </script>
+  </body>
+</html>