Accounts API (без GraphQL)

1. Архітектура apps.accounts

2. Моделі

UserProfile

• Розширює AbstractUser, але використовує email як USERNAME_FIELD.
• Зберігає персональні дані (телефон, tg_username, адреса), стан працевлаштування, посилання на компанію, керівників, реквізити.
• Поля first_sale, paid дозволяють позначити бізнес-статуси.
• leader (ManyToMany self) для побудови ієрархії.
• Метод save() автогенерує username та slug через generate_unique_value.

StatusOnWork

Проста довідникова таблиця зі статусами (Active, On Leave...). Використовується для UserProfile.status.

Invite

• Зв'язує UserProfile з company.Company, roles.CompanyRole, roles.PositionInRole.
• Використовується для керування запрошеннями до компанії.

3. Серіалізатори

• UserProfileSerializer — створює користувача, виконує валідацію пароля через validate_password і виставляє write_only.
• LoginSerializer — email+password.
• RequestPasswordResetSerializer / ResetPasswordSerializer — для ініціації та підтвердження відновлення доступу.

4. Auth utils

accounts/utils/CustomAuthJWT.py містить SessionJWTAuthentication:

• Читає access_token і refresh_token із request.session.
• Перевіряє access через rest_framework_simplejwt. Якщо протермінувався, генерує новий access із refresh, зберігає його в сесії.
• Повертає користувача як SimpleLazyObject, тож інші APIView можуть працювати як зі стандартним DRF auth.

Цей механізм дозволяє підтримувати веб-сесії з JWT, не передаючи токен у кожному запиті.

5. REST Views

RegisterView

• POST /accounts/register/.
• Приймає ім'я, email, пароль. Повертає створений профіль.

CheckRegistrationDataView

• POST /accounts/check-password/.
• Перевіряє email/пароль на валідність без створення акаунту.

LoginView

• POST /accounts/login/.
• Аутентифікація через authenticate(email, password).
• При успіху: генерує пару токенів RefreshToken.for_user, зберігає їх у сесії request.session, повертає sessionid + профіль.

LogoutView

• POST /accounts/logout/ (вимагає IsAuthenticated).
• Прибирає токени з сесії, викликає logout(request).

Password reset

• RequestPasswordResetView — POST /accounts/request-reset/: зберігає {email, token} у кеші (1 година) під ключем password_reset:email.
• ResetPasswordView — POST /accounts/reset-password/: перевіряє токен у кеші, змінює пароль, видаляє ключ.

6. URL-конфігурація

GraphQL endpoint /accounts/graphql/ тут не розглядається.

7. Приклади запитів

// Реєстрація
POST /accounts/register/
{"email": "demo@example.com", "password": "StrongPass1!", "first_name": "Demo", "last_name": "User"}

// Логін
POST /accounts/login/
{"email": "demo@example.com", "password": "StrongPass1!"}

// Перевірка перед реєстрацією
POST /accounts/check-password/
{"email": "demo@example.com", "password": "StrongPass1!"}

// Запит на відновлення
POST /accounts/request-reset/
{"email": "demo@example.com", "token": "123456"}

// Підтвердження відновлення
POST /accounts/reset-password/
{"email": "demo@example.com", "token": "123456", "new_password": "NewStrong1!"}

8. Типові сценарії