Этот документ фиксирует рабочий контекст по мобильному приложению assrep-mobile-app и задает единые правила для любых Codex-агентов, которые продолжают разработку.
Цель:
- не терять контекст между сессиями;
- поддерживать единый технический стиль;
- не ломать уже стабилизированные роли/флоу;
- быстрее доводить новые фичи до рабочего состояния.
Проект: Expo + React Native + TypeScript + Zustand + i18n.
Ключевые принципы:
- feature-first структура (
src/features/*); - единый API-вход (
src/shared/api/client.ts); - строгая типизация маршрутов (
src/navigation/types.ts); - role-based UX (student / tutor / admin-tutor);
- приоритет: рабочий student journey в mock-режиме и стабильная проверка smoke-набором.
Сейчас уже реализовано/зафиксировано:
- mock-режим запуска через
make local-mock-upиpnpm start:mock; - role-based конфиг нижних табов в
src/navigation/mainTabsConfig.ts; - для student таба
Financeнет (и не должен появляться); - smoke-покрытие критичных флоу student/tutor/admin;
- quality gates в CI:
lint + typecheck + test:smoke; - подготовленная база чатов (UI + store + mock API), включая graceful fallback, если backend не готов;
- устранена часть техдолга с ролями и
DEMO_*хардкодами в student-критичных экранах.
- Student:
- не получает экран финансов;
- видит только логичный student-флоу: главная, предметы/репетиторы, календарь, чаты, профиль.
- Tutor:
- имеет доступ к услугам, календарю, чатам, студентам/заявкам, финансам.
- Admin-tutor:
- всё tutor + admin-поверхность в настройках.
- Любой новый экран/флоу должен сохранять role-aware поведение:
- скрытие нерелевантных действий;
- корректная навигация по ролям;
- отсутствие лишних сущностей для student.
- Экраны:
src/features/<feature>/screens/* - Хуки фичи:
src/features/<feature>/hooks/* - Переиспользуемые компоненты:
src/shared/components/*
- Zustand в
src/shared/state/* - Селекторы в
src/shared/state/selectors.ts - Нельзя тянуть сырые данные напрямую в UI без явной роли/фильтрации.
- Только через
src/shared/api/client.ts(или mock-подмену через env). - Нельзя писать
fetchнапрямую в фичах/экранах. - Для любых новых endpoint-ов: типы + контракт + client-метод + тест.
- Константы маршрутов:
src/shared/constants/routes.ts - Типы стеков/табов:
src/navigation/types.ts - Новые экраны должны быть добавлены типобезопасно.
- Все тексты через
t('...'), без хардкода строк в UI.
Основной smoke-набор закреплен в package.json -> test:smoke, включая:
- mock API критичные сценарии;
- role-based табы;
- Home / Subjects / Tutors / TutorProfile / Slots / BookingConfirm / Review;
- SignIn;
- Chats;
- Calendar / SlotDetails / SlotWizard;
- TutorStudentDetails.
Подробности покрытия: docs/stabilization-sprint-1.md.
Правило:
- если меняешь поведение в критичном флоу, обновляй соответствующий smoke-тест в этой цепочке.
Базовые:
pnpm installpnpm lintpnpm typecheckpnpm testpnpm test:smoke
Запуск приложения:
make local-mock-up(предпочтительно для UI-итераций без backend)pnpm start:mockpnpm start:local
Окружения через Makefile:
make up-localmake up-stagemake up-prod
Важно:
- перед mock-запуском останавливать старые Metro-процессы этого репо (частая причина "серого экрана").
Workflow: .github/workflows/android-debug-apk.yml.
Логика:
- для
push/pull_requestнаmain: обязательный jobquality-gates; quality-gatesвключает:pnpm lintpnpm typecheckpnpm test:smoke
- сборка debug APK выполняется только после успешных quality gates и не запускается на PR.
Правило для агента:
- локально прогонять минимум
lint + typecheck + test:smokeперед коммитом.
- Не ломать текущий UX:
- сначала сохранить поведение, потом улучшать структуру.
- Не плодить пасту:
- повторяющуюся логику выносить в hooks/utils.
- пример уже сделанного: общий
useTutorNamesMap.
- Не вшивать демо-идентификаторы в критичных пользовательских операциях:
- использовать
useAuth().user?.idс fallback только для mock-совместимости.
- Держать типобезопасность:
- не использовать
any, кроме крайних случаев с комментариями-пояснениями.
- Менять аккуратно при грязном дереве:
- в репозитории может одновременно работать другой агент;
- не откатывать чужие изменения;
- работать точечно по своим файлам.
- Комментарии в коде:
- только там, где реально сложная логика;
- избегать очевидных комментариев.
Текущее состояние:
- UI и локальная логика чатов подготовлены;
- mock API поддерживает thread/messages/send/read/ensure;
- есть fallback-сообщение для случаев, когда backend endpoint не готов.
При развитии:
- не завязывать UI на нестабильные backend-поля;
- все backend-допущения изолировать в API-layer/store;
- сохранять текущий UX при 404/
chat_not_found/частичной недоступности API; - при появлении реального backend сначала обновить контракт/типы, потом экраны.
- Дожать student journey до полностью логичного и связного UX:
- экраны, состояния, пустые/ошибочные сценарии, навигационные переходы.
- Развивать chat UX поверх уже заготовленной базы:
- предсказуемое поведение thread creation, загрузки истории, composer-state;
- расширение smoke-тестов при добавлении новых сценариев.
- Убирать техдолг по тестам:
- постепенно сокращать предупреждения
react-test-renderer/act(...).
- Проводить селективный рефакторинг:
- только с тестовой страховкой и без потери скорости разработки.
Задача считается завершенной, если:
- код компилируется (
typecheckзеленый); - линтер зеленый;
- smoke-набор зеленый;
- если изменен критичный флоу, тесты обновлены;
- документация (README/docs/AGENTS) обновлена при изменении процесса/команд/архитектуры;
- изменение не нарушает role-ограничения (особенно student без finance).
Рекомендуемый стиль коммитов:
feat(student): ...feat(chat): ...fix(calendar): ...test(smoke): ...refactor(auth): ...docs(agents): ...
Правила:
- коммиты атомарные и логически цельные;
- не смешивать в одном коммите рефакторинг и фичу без необходимости;
- перед пушем прогонять quality-команды локально;
- не использовать destructive git-команды без явного запроса пользователя.
Перед началом:
- понять роль/флоу, который меняется;
- проверить, есть ли уже smoke/юнит-тест на этот путь.
Во время:
- править минимально необходимый набор файлов;
- не трогать несвязанные участки;
- следить за role-aware логикой.
Перед завершением:
pnpm lintpnpm typecheckpnpm test:smoke- при значимых изменениях:
pnpm test - обновить документацию, если изменился процесс.
Сначала рабочий пользовательский сценарий и предсказуемая логика, затем косметический рефакторинг.
Для этого проекта важнее стабильная доставка и проверяемость, чем "идеальная архитектура в вакууме".
Ниже — фактический рабочий контекст, который появился в последних итерациях и критичен для продолжения работ без регрессий.
В src/shared/api/endpoints.ts добавлены endpoint-ы:
userAvatar,userAvatarUploadUrl,userAvatarMedia;tutorPhotoMedia;tutorServicePhotos,tutorServicePhotosUploadUrl,tutorServicePhotoById,tutorServicePhotoMedia.
В src/shared/api/types.ts добавлены/обновлены типы:
UserAvatar;TutorPhoto(включаяproxy_url, мета-поля);TutorServicePhoto;UploadUrlResponse.
В src/shared/api/client.ts добавлены методы:
- avatar:
getUserAvatarrequestUserAvatarUploadUrlupsertUserAvatardeleteUserAvatar
- tutor profile photos:
getTutorPhotosrequestTutorPhotoUploadUrlconfirmTutorPhotoUploadupdateTutorPhotodeleteTutorPhoto
- tutor service photos:
getTutorServicePhotosrequestTutorServicePhotoUploadUrlconfirmTutorServicePhotoUploadupdateTutorServicePhotodeleteTutorServicePhoto
Также в ApiClient.request добавлен более строгий парсинг ошибок backend:
- поддержка формата
{ error: { code, message, data } }; - проброс
status/codeвError(используется для UX-веток409,401и т.д.); - отдельная нормализация
user_not_found.
В src/shared/utils/media.ts реализован общий слой:
- определение
content_type(jpeg/png/webp); - генерация имени файла по MIME;
- сортировка фото по
position; resolveMediaUrlс правиломproxy_url->url;- автоматическое преобразование относительных
proxy_url(/api/media/...) в абсолютные черезAPI_BASE_URL; uploadBinaryToStorageс timeout (45s) и ошибкойupload_timeoutвместо бесконечного зависания.
Важно:
- в UI/экранах нельзя напрямую собирать URL для картинок; нужно использовать
resolveMediaUrl.
Новые/обновленные хуки:
src/features/profile/hooks/useUserAvatar.ts:- полный flow avatar upload (
upload-url -> PUT -> finalize -> sync); - состояние этапов загрузки (
uploadStep) и прогресс; - обработка
upload_timeout.
- полный flow avatar upload (
src/features/profile/hooks/useTutorPhotos.ts:- загрузка/замена/удаление фото профиля репетитора;
- лимит 10;
- обработка 409 + timeout.
src/features/services/hooks/useTutorServicePhotos.ts:- CRUD и reorder фото услуги;
- лимит 5;
- обработка 409 + timeout.
src/features/services/hooks/useServicePhotoPreviews.ts:- подгрузка первой миниатюры услуги (для спискового экрана услуг).
- Профиль (
src/features/profile/screens/ProfileScreen.tsx):
- аватар использует
useUserAvatar; - добавлен модальный индикатор этапов загрузки с прогресс-баром;
- есть понятные тексты статусов загрузки.
- Настройки (
src/features/settings/screens/SettingsScreen.tsx):
- аватар тоже через
useUserAvatar; - добавлен
useFocusEffectсloadAvatar()для синхронизации после возврата со screen редактирования профиля.
- Список услуг (
src/features/services/screens/ServicesScreen.tsx):
- миниатюра услуги берется из первой service-photo;
- формат миниатюры: горизонтальный
4/3; - название услуги отображается как
primary/secondary(черезgetServiceCompactParts); - переключатель видимости — SVG глаз/глаз-off;
- действие видимости подтверждается через
HoldToConfirmModal; - кнопка создания услуги — минималистичный SVG
+.
- Детали услуги (
src/features/services/screens/ServiceDetailsScreen.tsx):
- слайдер показывает реальные service photos (не заглушки);
- если фото нет, показывается placeholder;
- редактирование описания вынесено в отдельный modal-экран ввода;
- лимит длины описания:
500символов; - удаление услуги через
HoldToConfirmModal.
Добавлены ключи в src/shared/config/i18n.ts:
servicePhotosLimitavatarUploadTitleavatarUploadPreparingavatarUploadUploadingavatarUploadFinalizingavatarUploadSyncingphotoUploadTimeoutHint
Правило:
- при добавлении новых состояний загрузки/ошибок обязательно добавлять ключи в
enиru.
Сценарий:
- mobile успешно получает
upload_url(POST .../upload-url); - зависает на
PUT upload_url; finalize(PUT /avatarилиPOST /photos) не вызывается;- в backend логах видно только шаг 1.
Типичная причина:
- неверный
S3_PRESIGN_PUBLIC_ENDPOINTотносительно типа клиента, который выполняет PUT.
Нужно указывать адрес, доступный устройству/эмулятору, где крутится мобильный клиент:
- Android emulator (AOSP/Studio):
http://10.0.2.2:4566
- iOS simulator / curl с хоста:
http://localhost:4566
- Физический телефон в Wi-Fi:
http://<LAN-IP-хоста-с-Localstack>:4566- пример:
http://192.168.1.130:4566
Важно:
- это IP хоста с backend/localstack, не IP телефона.
- при смене сети/роутера LAN-IP хоста меняется -> env нужно обновить и перезапустить контейнеры.
Из ../core:
docker-compose up -d --force-recreate backend worker beat
Проверка внутри backend-контейнера:
docker-compose exec -T backend python -c "from app.settings import settings; print(settings.S3_PRESIGN_PUBLIC_ENDPOINT)"
Актуальная модель:
- периодическая верификация сессии включена в
src/app.tsxчерезAUTH_VERIFY_INTERVAL_MS; authStore.restore():- при invalid session (
401,user_not_found, invalid token и т.д.) делаетsignOut; - при transient-ошибках (
timeout/network) не деавторизует, оставляет локальную сессию.
- при invalid session (
ServerStatusBannerпоказывает недоступность backend поверх UI.
Это соответствует правилу:
- деавторизация только при реально невалидной сессии;
- при сетевых/временных ошибках показывать плашку, но не выбрасывать пользователя.
- Avatar flow:
- профиль: выбрать фото -> увидеть пошаговый статус загрузки;
- после завершения аватар виден и в
Profile, и вSettings.
- Tutor profile photos:
- добавить фото, удалить фото, reorder;
- обработка лимита 10 (409 + UX-сообщение).
- Tutor service photos:
- добавить фото услуги, удалить, reorder;
- лимит 5;
- превью в списке услуг обновляется после refresh.
- URL-режимы:
- проверить, что
proxy_urlи относительные media-path корректно рендерятся.
- Ошибки:
- принудительно воспроизвести timeout/недоступность storage и убедиться, что есть понятное сообщение пользователю.
Если трогается media/API/auth/session/UI профиля/услуг:
pnpm lintpnpm typecheckpnpm test:smoke- минимум дополнительно:
pnpm vitest run src/shared/api/client.test.ts src/shared/api/client.methods.test.ts src/shared/api/endpoints.test.tspnpm vitest run src/shared/utils/media.test.ts src/shared/utils/apiError.test.ts
Если трогается core-часть presign/storage:
- в
../core:poetry run pytest tests/clients/test_s3_client.py -q
- Нельзя полагаться только на успешный
upload-url:
- шаг 1 не гарантирует, что бинарник реально залился и запись финализировалась.
- Нельзя держать бесконечный upload без timeout:
- пользователь видит "зависло" и не понимает причину.
- Нельзя отображать изображения без
resolveMediaUrl:
- относительные
proxy_urlломают рендер в RN при прямом использовании.
- Нельзя забывать re-fetch после CRUD операций с фото:
- UI легко уходит в рассинхрон.
- Нельзя использовать deprecated
ImagePicker.MediaTypeOptions:
- использовать
mediaTypes: 'images'или новый API media type.
Этот блок фиксирует фактическое состояние экрана финансов и контрактов analytics, чтобы новые итерации не возвращались к устаревшему контексту.
- Источник правды по табам:
src/navigation/mainTabsConfig.ts. Financeтаб присутствует только уtutor.- Для
studentтабаFinanceнет, и это закреплено тестомsrc/navigation/mainTabsConfig.test.ts. - Даже при прямом открытии
FinanceScreenна уровне экрана есть guard: для не-tutor выводитсяsectionInProgressбез загрузки витрины.
В src/shared/api/endpoints.ts и src/shared/api/client.ts используются 4 endpoint-а:
GET /tutors/{tutor_id}/analytics/summaryGET /tutors/{tutor_id}/analytics/servicesGET /tutors/{tutor_id}/analytics/timeseriesGET /tutors/{tutor_id}/analytics/price-history
В src/shared/api/types.ts зафиксированы типы:
TutorAnalyticsSummaryTutorAnalyticsServiceBreakdownTutorAnalyticsTimeseries+TutorAnalyticsTimeseriesPointTutorAnalyticsPriceHistory(+ service/trial history item types)
Критично:
- поле
lessons_rescheduledуже добавлено в:TutorAnalyticsSummaryTutorAnalyticsTimeseriesPoint
- при любых будущих изменениях backend-схемы analytics нужно синхронно обновлять эти типы.
Файл: src/features/finance/hooks/useTutorFinance.ts.
Поведение:
- принимает
tutorId,periodDays,enabled; - строит период
dateFrom/dateToпо локальному времени устройства; - грузит витрины параллельно (
Promise.all) для 4 endpoint-ов; - выбирает
granularity:dayдля 7/30 дней,weekдля 90 дней (условиеperiodDays > 60);
- использует автообновление по
BACKGROUND_REFRESH_MSсsilent-режимом; - если backend вернул
user_not_found-> вызываетsignOut(черезauthStore); - защищен от race-condition через
requestIdRef(только последний запрос пишет в state).
Файл: src/features/finance/screens/FinanceScreen.tsx.
Текущее UI-содержимое:
- фильтры периода:
7 / 30 / 90дней; - KPI-карточки:
- planned revenue
- paid revenue
- paid lessons
- average check
- cancelled lessons
- rescheduled lessons
- payment rate
- блок динамики (timeseries):
- planned revenue
- paid revenue
- rescheduled lessons
- разбивка по услугам (planned/paid revenue + paid/total lessons);
- история изменения цен:
- service price history
- trial price history
- корректные состояния:
- initial loading
- pull-to-refresh
- error + retry
- empty state.
Локализация:
- ключи finance вынесены в
src/shared/config/i18n.ts(en+ru), включаяfinanceRescheduledLessons.
В src/shared/api/mockClient.ts реализованы mock-версии analytics endpoint-ов.
Текущее состояние mock:
summary.lessons_rescheduledвычисляется;- в
timeseriesполеlessons_rescheduledприсутствует в контракте, но сейчас не инкрементится в bucket-агрегации (по умолчанию остается0).
Практический вывод:
- если в mock-режиме переносы в timeseries выглядят нулями, это ожидаемо до доработки mock-агрегации.
- не считать это автоматически багом backend.
- Нет отдельного smoke-теста на
FinanceScreen.
- Сейчас контракт покрывается API-тестами (
endpoints/client.methods), но UI-поведение Finance не зафиксировано smoke-набором.
FinanceStackиспользует строковый route-name"Finance"вsrc/navigation/index.tsx.
- Это не критично в текущем состоянии, но при будущем рефакторинге лучше выровнять с
ROUTES, чтобы не терять типобезопасность.
- Форматирование денег зависит от
currencyиз summary.
- fallback в UI:
RUB, если поле не пришло. - для нестандартных кодов валюты
Intlможет fallback-нуть в plain number.
- История цен объединяет service и trial в одну ленту в UI.
- сортировка по
changed_atdesc; - источник и actor пока не выводятся.
Если backend меняет любые поля в analytics (summary/services/timeseries/price-history), изменения считаются завершенными только после синхронизации всех уровней:
- Swagger/схемы в core.
src/shared/api/types.ts.src/shared/api/client.ts(query/body/response).src/shared/api/mockClient.ts(чтобы mock-режим не расходился с контрактом).src/features/finance/hooks/useTutorFinance.ts(если меняется логика загрузки/фильтрации).src/features/finance/screens/FinanceScreen.tsx(UI + empty/error states).src/shared/config/i18n.ts(en+ruключи).- Тесты:
src/shared/api/endpoints.test.tssrc/shared/api/client.methods.test.ts- при необходимости smoke/UI тесты.
- Обновление контекста в
AGENTS.md.
Если хоть один пункт пропущен, задача считается частично завершенной.
Минимум:
pnpm lintpnpm typecheckpnpm test:smoke
Рекомендуемый прицельный прогон:
pnpm vitest run src/navigation/mainTabsConfig.test.tspnpm vitest run src/shared/api/endpoints.test.ts src/shared/api/client.methods.test.tspnpm vitest run src/shared/api/mockClient.smoke.test.ts
Если менялись форматирование/тексты finance:
- проверить
enиruлокали руками на экране.
Ручной sanity для finance:
- Tutor role:
- таб
Financeвиден; - данные грузятся;
- периоды 7/30/90 переключаются;
- pull-to-refresh работает.
- Student role:
- таба
Financeнет.
- Ошибки сети:
- отображается ошибка и доступен
Retry.
- Mock mode:
- экран открывается и не падает при частичной пустоте данных.
Ниже фиксируется именно текущий продуктовый договор по экрану профиля/настроек, который появился после серии UI-итераций.
Текущий SettingsStack:
SETTINGS_STACK(SettingsScreen) — корневой экран профиля;APP_SETTINGS(AppSettingsScreen) — системные настройки (тема, роль, переход к уведомлениям);NOTIFICATION_SETTINGS(NotificationSettingsScreen);BLACKLIST(BlacklistScreen);FEEDBACK(FeedbackScreen);RELEASE_NOTES(ReleaseNotesScreen);ADMIN(AdminScreen, только приuser.is_admin);PROFILE(ProfileScreen) — отдельный экран редактирования профиля.
Навигационный принцип:
- в шапке
SettingsScreenкнопка ведет вAppSettingsScreen; - в шапке
AppSettingsScreenесть явная кнопка "назад в профиль" (переход вSETTINGS_STACK); - редактирование персональных полей вынесено в
PROFILE.
На экране ProfileScreen пользователь редактирует только:
Имя(name);Фамилия(lastName);Телефон(phone);Email(email).
Важно:
- расширенные tutor-поля пока не показываются в UI;
- они остаются в
profileStoreкак задел на постепенное включение; - решение принято специально, чтобы не перегружать пользователя на первом экране профиля.
Актуальная модель:
- в профиле используется одна фотография профиля (avatar), а не галерея;
- фото услуги — отдельная сущность и редактируются только в флоу услуг;
- в
ProfileScreenсверху расположен центрированный avatar/placeholder + маленький badge с карандашом; - текстовые CTA вида "Фотографии / Добавить фото" в профиле не используются.
Поведение по тапу на аватар:
- если фото отсутствует: открыть системный picker и загрузить;
- если фото уже есть: показать confirm-диалог замены и при подтверждении загрузить новое фото;
- используется
useUserAvatar(upload-url -> PUT -> finalize -> sync) с индикацией этапов загрузки.
Зафиксированные UI-решения:
- разделение контента в первую очередь линиями-разделителями и секциями, а не "тяжелыми карточками";
- для шапок использовать нижнюю линию на всю ширину (как на
Services/Calendar); - визуальная иерархия ближе к популярным маркетплейс-паттернам (Avito-like), а не iOS-копии;
- в форме профиля поля расположены в линейном вертикальном списке с divider между строками;
- блок фото внизу профиля отсутствует.
SettingsScreenиспользуетeffectiveRoleизuseAuthдля подписи роли (Student/Tutor);- блок
Adminв настройках отображается только приuser.is_admin; - редактирование профиля (имя/фамилия/телефон/email/avatar) доступно одинаково для student и tutor;
- tutor-галерея профиля сейчас не экспонируется через UI (см. секцию 28).
src/features/auth/hooks/useAuth.ts- вычисляет
effectiveRole+ флагиisTutor/isStudent/isAdmin; - при login/register/restore синхронизирует профиль в store;
full_nameразбивается наname + lastNameчерезsplitFullName.
- вычисляет
src/shared/state/profileStore.ts- содержит
name,lastName,phone,email,role; - содержит расширенный
tutor-блок (пока скрыт из UI); - предоставляет set/update-методы для всех полей.
- содержит
src/features/profile/hooks/useProfile.ts- единая точка доступа UI к данным профиля;
- включает update-методы для
name/lastName/phone/emailи tutor-полей.
src/features/profile/hooks/useUserAvatar.ts- хранит
avatar,avatarUrl,uploadStep,uploadProgress; - обрабатывает timeout (
upload_timeout) и дружелюбный текст ошибки.
- хранит
src/features/settings/screens/SettingsScreen.tsx- профильный summary-блок (avatar + ФИО + телефон + роль);
useFocusEffectвызываетloadAvatar()при возврате на экран;- точки входа: edit profile, notification settings, feedback, release notes, blacklist, admin.
src/features/settings/screens/AppSettingsScreen.tsx- переключение темы (
system/light/dark); - переключение роли (
student/tutor); - back action в
SETTINGS_STACK.
- переключение темы (
src/features/profile/screens/ProfileScreen.tsx- центрированный avatar + badge-pencil;
- линейная форма из 4 полей;
- modal-индикатор этапов загрузки аватара.
src/features/settings/screens/NotificationSettingsScreen.tsx- хранит
retryIntervalMinutes/maxAttemptsвsettingsStore; - валидирует только числовой ввод.
- хранит
src/features/settings/screens/BlacklistScreen.tsx- отображение локального blacklist из
settingsStore+ remove action.
- отображение локального blacklist из
Для текущего профиля/медиа уже используются ключи:
lastNameLabel;changePhotoAction,changePhotoTitle,changePhotoPrompt;avatarUploadTitle,avatarUploadPreparing,avatarUploadUploading,avatarUploadFinalizing,avatarUploadSyncing;photoUploadTimeoutHint.
Правило:
- при добавлении нового upload-step или нового alert-сценария обновлять обе локали (
en+ru) синхронно.
Если задача затрагивает профиль, настройки, avatar/media utils, auth sync:
pnpm lintpnpm typecheckpnpm test:smoke
Рекомендуемый прицельный прогон:
pnpm vitest run src/shared/state/profileStore.test.ts src/shared/state/authStore.test.tspnpm vitest run src/shared/utils/media.test.ts src/shared/utils/apiError.test.tspnpm vitest run src/shared/api/client.test.ts src/shared/api/client.methods.test.ts src/shared/api/endpoints.test.ts
Ручной sanity после изменений:
- Открыть
ProfileScreenи проверить поляname/lastName/phone/email. - Тап по avatar без фото -> picker -> успешная загрузка и отрисовка.
- Тап по avatar с фото -> confirm -> замена фото.
- Проверить upload modal со step-текстами и прогресс-баром.
- Вернуться в
SettingsScreenи убедиться, что avatar синхронизировался. - Проверить
AppSettingsScreen: back в профиль, theme switch, role switch.
useTutorPhotosостается в кодовой базе как задел под tutor-gallery, но в текущем UX профиля не подключен.
- Это осознанно: в профиле 1 avatar, фото для контента уехали в услуги.
- В
profileStoreесть много tutor-полей, которые не отражаются в текущем UI.
- Это не баг, а staged rollout.
- При открытии новых полей включать их порционно и с UX-проверкой на перегрузку формы.
- Для
SettingsScreen/ProfileScreenнет выделенного smoke-теста вtest:smokeцепочке.
- Пока поведение косвенно защищено unit/API тестами и ручным sanity.
- При следующем цикле стабилизации желательно добавить отдельные smoke-тесты этих экранов.
- В навигации
FinanceStackвсе еще использует строковый route-name"Finance"внутриindex.tsx.
- Это известное ограничение из предыдущих секций и не должно быть случайно размножено в новых стеках.
Этот блок фиксирует текущее состояние tutor-календаря после серии UX-правок, чтобы следующие агенты не откатывали уже согласованное поведение.
Основные файлы:
src/features/calendar/screens/CalendarScreen.tsxsrc/features/calendar/screens/SlotWizardScreen.tsxsrc/features/calendar/screens/SlotDetailsScreen.tsxsrc/features/calendar/hooks/useTutorSlots.tssrc/shared/state/tutorSlotsStore.tssrc/shared/api/client.tssrc/shared/api/types.tssrc/shared/config/i18n.ts
Принцип:
- если поведение календаря обсуждается, смотреть в первую очередь эти файлы, а не старые обсуждения/скриншоты.
Текущее согласованное поведение CalendarScreen:
- в хедере экрана текст строго
Календарь; - справа в хедере компактная кнопка
+для создания слота; - большая кнопка
Создать окнов теле экрана не используется; - ниже хедера идет переключатель
Планер / Список слотов; - между
Планер/СписокиМесяц/Неделя/Деньвыводится период (увеличенный и более контрастный текст); - заголовок стека (
workWindowsTitle) локализован какCalendar / Календарь.
Для tutor planner закреплено:
- режимы:
month / week / day; - сохранен horizontal swipe влево/вправо через
PagerViewв day/week режимах; - сохранены анимации перехода week<->day (
react-native-reanimated); - в day/week только сетка часов вертикально скроллится;
- верхние элементы (дни недели, числа, контролы) остаются фиксированными;
- в month-виде под числом даты НЕ показывается дополнительный счетчик количеством;
- на day/week-grid есть красная линия текущего времени;
- при первом открытии planner day/week сетка автоматически прокручивается к зоне текущего времени;
- по кнопке
Сегодняпроисходит переход на текущую дату и докрутка к текущему времени; - tap по сетке часов открывает wizard создания слота на ближайший 15-мин интервал;
- рабочий визуальный диапазон сетки сейчас 07:00–22:00.
Счетчики над grid:
- в одну строку с горизонтальным скроллом;
- статусы:
all/free/booked_pending/scheduled/cancelled; - по тапу на счетчик включается focus этого статуса;
- в day/week выделяются только слоты выбранного статуса (остальные приглушаются);
- в month режиме дни без слотов выбранного статуса визуально приглушаются.
Список слотов должен оставаться структурно таким:
- фильтр по статусу;
- фильтр по услуге;
- фильтр по ученику;
- карточки слотов с переходом в детали.
Критично по фильтру услуг:
- список услуг в фильтре строится из
tutorServices(созданные у репетитора); - дополнительно включаются
service_idиз текущих слотов как fallback (чтобы не потерять фильтрацию исторических/нестандартных записей).
SlotWizardScreen сейчас сознательно переработан под более прикладной UX:
- услуга выбирается НЕ через дерево категорий;
- услуга выбирается из реально созданных услуг репетитора (
useTutorServices); - при выборе услуги цена/час автоподставляется из tutor-service и остается редактируемой;
- дата и время задаются отдельно через picker;
- длительность: пресеты + ручной ввод;
- есть блок сводки (
slotSummaryTitle) на экране; - валидации перед submit:
- выбранная услуга;
- валидная дата/время;
start_atстрого в будущем;duration > 0;price > 0.
Критичное изменение подтверждения:
- финальное подтверждение создания/сохранения слота больше НЕ через
Alert confirm; - используется базовый
HoldToConfirmModal(единый паттерн проекта); - hold-label-и:
holdToCreateWindowActionholdToSaveWindowAction.
SlotDetailsScreen поддерживает:
- загрузку актуального слота + истории статусов (
getSlot+getSlotHistory); - fallback на данные из store, если direct-load не удался;
- отображение
status/time/duration/price/total/paid; - показ
cancel_reason, если есть; - действия по статусам:
free: редактировать / отменить / удалить;booked_pending: подтвердить / отклонить / отменить;scheduled: отменить;
- cancel/delete выполняются с вводом причины в modal.
В src/shared/api/client.ts для слотов поддерживается:
listSlotsс фильтрамиserviceId,studentId,status,startFrom,startTo, пагинацией;getSlot(slotId);getSlotHistory(slotId);confirmSlot(slotId, tutorId)(tutorId передается в body);declineSlot(slotId, tutorId)(tutorId передается в body);cancelSlot({ slotId, actorId, reason? });deleteSlot(slotId, actorId, reason?).
В src/shared/api/types.ts расширения:
Slotсодержитcancel_reason,cancelled_byи служебные timestamps;- добавлен
SlotStatusHistory.
В tutorSlotsStore и useTutorSlots:
load/refresh/silent-refreshпринимаютserviceIdиstudentId.
Ключевые изменения i18n:
workWindowsTitle->Calendar / Календарь;- добавлены ключи для hold-подтверждения:
holdToCreateWindowActionholdToSaveWindowAction.
Правило:
- любые новые calendar/slot тексты обязательно дублировать в
enиru.
В последних calendar-итерациях прогонялись:
pnpm typecheck;- прицельно
pnpm vitest run src/shared/api/client.methods.test.ts src/shared/state/tutorSlotsStore.test.ts.
Важно:
- перед merge календарных изменений стандарт остается прежним:
lint + typecheck + test:smoke.
- Calendar UX сейчас сфокусирован на tutor use-cases.
- student use-cases (
избранные,мои уроки) требуют отдельной продуктовой доработки, чтобы не смешивать роли.
- Визуальные правки calendar легко ломают sticky-иерархию.
- любое изменение layout day/week сначала проверять руками на реальном скролле сетки.
- Любые изменения в SlotWizard подтверждении не должны уводить проект обратно к разным шаблонам confirm.
- приоритет: единый
HoldToConfirmModalдля финальных подтверждений критичных действий.
- При правках фильтров списка слотов нельзя возвращаться к источнику только из
slots.
- источник услуг в фильтре: сначала
tutorServices, затем fallback слотами.
Перед началом:
- определить, меняется planner, list, wizard или details;
- проверить role-impact (student/tutor/admin-tutor);
- проверить, не ломает ли изменение контракт section 29.
Во время:
- держать стабильным
PagerView + animated day/week; - не трогать лишние фичи за пределами calendar/slots;
- все API-вызовы делать через
client.ts, без прямогоfetch.
Перед завершением:
pnpm lintpnpm typecheckpnpm test:smoke- при правках slot API/store дополнительно:
pnpm vitest run src/shared/api/client.methods.test.ts src/shared/state/tutorSlotsStore.test.ts
Ручной sanity (минимум):
- Planner: month/week/day переключаются, swipe работает.
- В day/week шапка фиксирована, скроллится только сетка часов.
- Автопрокрутка при входе ведет к текущему времени (красная линия в зоне видимости).
- Статусные счетчики горизонтально скроллятся и подсвечивают соответствующие слоты.
- List filters: статус/услуга/ученик работают, услуги берутся из tutor-services.
- SlotWizard: выбор услуги только из услуг репетитора, hold-confirm работает.
- SlotDetails: confirm/decline/cancel/delete и история статусов работают без падений.