WellShe/docs/auth_emergency_system_requirements.md

Техническое задание для ИИ агента по реализации системы авторизации, регистрации и экстренных оповещений

Промпт для ИИ

Ты — ИИ агент-разработчик, специализирующийся на интеграции клиентской части приложения для женской безопасности с бэкендом на микросервисной архитектуре. Твоя задача — реализовать систему авторизации, регистрации и экстренных оповещений на основе предоставленных API-эндпоинтов.

Общие требования

1. Создай модули для работы с авторизацией и регистрацией пользователей
2. Реализуй механизм хранения и обновления токенов доступа
3. Разработай интерфейс для экстренных оповещений
4. Обеспечь надежную обработку ошибок и восстановление соединения
5. Следуй современным практикам безопасности при работе с API

Часть 1: Система авторизации и регистрации

Эндпоинты для работы

Регистрация

• URL: /api/v1/auth/register
• Метод: POST
• Требуемые поля:
  • email (string)
  • username (string)
  • password (string)
  • first_name (string)
  • last_name (string)
  • phone (string)
• Обработка ответа: Создать локальный профиль пользователя и перенаправить на экран авторизации

Авторизация

• URL: /api/v1/auth/login
• Метод: POST
• Требуемые поля:
  • username (string) или email (string)
  • password (string)
• Обработка ответа: Сохранить полученный токен доступа и refresh token

Обновление токена

• URL: /api/v1/auth/refresh
• Метод: POST
• Требуемые поля:
  • refresh_token (string)
• Обработка ответа: Обновить сохраненный токен доступа

Выход из системы

• URL: /api/v1/auth/logout
• Метод: POST
• Заголовки: Authorization: Bearer {token}
• Обработка ответа: Удалить все локальные данные аутентификации

Функциональные требования

1. Валидация данных:

   • Проверка корректности формата email
   • Проверка надежности пароля (минимум 8 символов, одна заглавная буква, одна цифра, один специальный символ)
   • Валидация номера телефона (международный формат)

2. Хранение данных:

   • Безопасное хранение токенов доступа (использовать Secure Storage)
   • Автоматическое обновление токенов при истечении срока действия

3. Обработка ошибок:

   • Четкие сообщения об ошибках для пользователя
   • Автоматические повторные попытки при проблемах с сетью
   • Логирование ошибок для отладки

Часть 2: Экстренные оповещения

Эндпоинты для работы

Создание экстренного оповещения

• URL: /api/v1/emergency/alert
• Метод: POST
• Заголовки: Authorization: Bearer {token}
• Требуемые поля:
  • location (object): { latitude: float, longitude: float }
  • message (string, optional): Дополнительная информация
• Обработка ответа: Отобразить статус отправки и ID оповещения

Получение статуса экстренного оповещения

• URL: /api/v1/emergency/alert/{alert_id}
• Метод: GET
• Заголовки: Authorization: Bearer {token}
• Обработка ответа: Обновить интерфейс с информацией о статусе оповещения

Отмена экстренного оповещения

• URL: /api/v1/emergency/alert/{alert_id}/cancel
• Метод: POST
• Заголовки: Authorization: Bearer {token}
• Требуемые поля:
  • reason (string, optional): Причина отмены
• Обработка ответа: Обновить статус оповещения в интерфейсе

Функциональные требования

1. Интерфейс экстренных оповещений:

   • Кнопка SOS, заметная и легко доступная
   • Подтверждение перед отправкой для предотвращения случайных активаций
   • Индикатор статуса активного оповещения
   • Возможность отмены оповещения

2. Геолокация:

   • Автоматическое получение местоположения пользователя
   • Периодическое обновление координат при активном оповещении
   • Отправка обновлений локации на сервер

3. Уведомления:

   • Push-уведомления о статусе экстренного оповещения
   • Звуковые сигналы при изменении статуса
   • Вибрация для незаметного активирования

4. Отказоустойчивость:

   • Кэширование данных для работы офлайн
   • Повторная отправка при восстановлении соединения
   • Локальное хранение истории экстренных вызовов

Технические требования

1. Архитектура:

   • Использовать паттерн MVVM или Redux для управления состоянием
   • Разделить код на модули по функциональности
   • Инкапсулировать работу с API в отдельный сервис

2. Безопасность:

   • Шифрование хранимых данных
   • Проверка SSL-сертификатов
   • Защита от CSRF и других уязвимостей

3. Производительность:

   • Минимизировать использование ресурсов
   • Оптимизировать сетевые запросы
   • Эффективное управление жизненным циклом приложения

4. Тестирование:

   • Модульные тесты для каждого компонента
   • Интеграционные тесты для проверки взаимодействия с API
   • UI-тесты для проверки пользовательского интерфейса

Ожидаемые результаты

1. Полностью функциональная система авторизации и регистрации
2. Интерфейс для экстренных оповещений с полной интеграцией API
3. Документация по архитектуре и интеграции
4. Покрытие кода тестами не менее 80%

Ограничения и особые требования

1. Приложение должно работать на устройствах с API 21 и выше (Android) или iOS 12 и выше
2. Учитывать различные размеры экрана и ориентации
3. Обеспечить доступность для людей с ограниченными возможностями
4. Минимальное потребление батареи даже при использовании геолокации

Примечания

1. Все взаимодействия с API должны учитывать возможные задержки и проблемы с сетью
2. Система должна быть протестирована на восстановление при потере соединения
3. Пользовательский интерфейс должен быть интуитивно понятным и легким в использовании
4. Все действия, связанные с безопасностью, должны логироваться для аудита