Документирован этап авторизации

README.md

@@ -2,19 +2,28 @@
 
 Защищённая переработка `Proxmox-VPS-Panel`.
 
-## Реализовано в базовой версии
+## Текущий этап: авторизация
 
-- запуск запрещён с демонстрационным `SECRET_KEY`;
+Добавлены:
-- TLS-проверка Proxmox включена по умолчанию;
+
-- пароли обрабатываются через Argon2id;
+- SQLAlchemy-модель `User`;
-- access token имеет короткий срок жизни;
+- PostgreSQL-сессии;
-- CORS принимает только явно заданные origins;
+- регистрация пользователей;
-- backend работает от non-root пользователя;
+- автоматическое назначение роли `admin` первому пользовователю;
-- backend не публикуется наружу напрямую;
+- Argon2id-хеширование паролей;
-- добавлены healthcheck и readiness-проверка PostgreSQL;
+- OAuth2 password login;
-- добавлены security-заголовки Nginx;
+- короткоживущий Bearer JWT;
-- зависимости Python зафиксированы по версиям;
+- endpoint `/auth/me`;
-- конфигурация отделена от исходного кода.
+- проверка активного пользователя;
+- frontend-формы регистрации и входа.
+
+API-пути доступны через frontend-прокси:
+
+```text
+POST /api/auth/register
+POST /api/auth/login
+GET  /api/auth/me
+```
 
 ## Запуск
 
@@ -25,16 +34,32 @@ cp .env.example .env
 docker compose up -d --build
 ```
 
-Frontend будет доступен на `http://host:5173`. Для production следует использовать HTTPS на внешнем reverse-proxy.
+Frontend будет доступен на `http://IP-АДРЕС-VM:5173`.
 
-## Следующие этапы переноса функциональности
+## Проверка регистрации через curl
 
-1. Перенести модели пользователей, шаблонов и инстансов.
+```bash
-2. Добавить Alembic-миграции.
+curl -X POST http://127.0.0.1:5173/api/auth/register \
+  -H 'Content-Type: application/json' \
+  -d '{"email":"admin@example.local","password":"ChangeMe-Strong-123"}'
+```
+
+Проверка входа:
+
+```bash
+curl -X POST http://127.0.0.1:5173/api/auth/login \
+  -H 'Content-Type: application/x-www-form-urlencoded' \
+  -d 'username=admin@example.local&password=ChangeMe-Strong-123'
+```
+
+## Следующие этапы
+
+1. Перенести модели шаблонов и инстансов.
+2. Добавить Alembic-миграции вместо временного `create_all()`.
 3. Реализовать очередь провижининга и резервирование VMID.
-4. Перенести Proxmox client с ожиданием и повторными попытками задач.
+4. Добавить Proxmox client с ожиданием и повторными попытками задач.
-5. Передавать VM credentials через cloud-init, а LXC credentials — через API создания контейнера.
+5. Реализовать административную панель пользователей и шаблонов.
-6. Не хранить пароли гостевых систем после однократной выдачи.
+6. Добавить создание и управление VM/LXC.
 7. Добавить rate limiting, аудит и автоматические тесты.
 
 ## Безопасность