Update 2.3.2

AGENTS.md

@@ -1,32 +1,48 @@
 # AGENTS.md
 
 ## Цель
+
 Единые подробные инструкции для любых ИИ-агентов, которые вносят изменения в репозиторий MyKHSU.
 
 ## Область применения
-- Любые правки в components/, hooks/, utils/, assets/.
+
+- Любые правки в `components/`, `hooks/`, `utils/`, `assets/`.
 - Любые изменения, которые затрагивают расписание, новости, карту, настройки, уведомления.
 - Любые исправления багов, рефакторинг и задачи по улучшению UX в рамках текущей архитектуры.
+- Любые изменения кода, требующие синхронизации документации в `docs/`.
 
 ## Роли
+
 - Исполнитель: делает изменения в коде.
 - Ревьюер: проверяет риски, регрессии, edge-cases.
 - Верификатор: проверяет запуск и базовую работоспособность.
 
 ## Принципы принятия решений
+
 1. Сначала безопасность и корректность.
 2. Затем обратная совместимость и стабильность пользовательских сценариев.
 3. Затем читаемость и поддерживаемость.
 4. Затем минимальность диффа и скорость.
 
 ## Протокол работы агента
-1. Прочитать запрос и определить затрагиваемые зоны (components, hooks, utils, assets).
+
+1. Прочитать запрос и определить затрагиваемые зоны (`components`, `hooks`, `utils`, `assets`).
 2. Проверить связанные файлы перед правкой, чтобы не сломать зависимости.
 3. Внести минимальные атомарные изменения.
-4. Выполнить базовую локальную проверку.
-5. Описать результат, риски и шаги ручной проверки.
+4. Обновить релевантные файлы в `docs/` в рамках той же задачи.
+5. Выполнить базовую локальную проверку.
+6. Описать результат, риски и шаги ручной проверки.
+
+## Обязательная синхронизация docs/
+
+- При любом изменении кода агент обязан обновить документацию в `docs/`.
+- Обновляется минимум один релевантный файл в `docs/` по затронутому поведению.
+- Обновляются только затронутые разделы, без лишнего переписывания.
+- Если изменение не влияет на поведение, архитектуру или данные, это явно фиксируется в отчете.
+- Нельзя завершать задачу с код-правкой без проверки актуальности `docs/`.
 
 ## Детализированный workflow
+
 1. Уточнить пользовательский эффект: что изменится на экране и в поведении.
 2. Найти точку входа изменения и соседние зависимости.
 3. Проверить, нет ли уже реализованной похожей логики.
@@ -37,60 +53,70 @@
 8. Подготовить отчет: что сделано, почему, риски, ручные шаги.
 
 ## Инварианты проекта
+
 - Экран расписания должен оставаться рабочим и отзывчивым.
 - Навигация между ключевыми экранами не должна ломаться.
 - Настройки пользователя и локальное хранилище должны сохраняться корректно.
 - Ошибки сети должны обрабатываться с понятным fallback-состоянием.
 
 ## Дополнительные инварианты
-- Приложение должно запускаться без явных ошибок импорта/синтаксиса.
+
+- Приложение должно запускаться без явных ошибок импорта и синтаксиса.
 - Пустые, частичные и отсутствующие данные не должны приводить к падению UI.
 - Основные пользовательские действия должны быть воспроизводимы после правки.
 
 ## Ограничения на изменения
-- Не переименовывай файлы и экспортируемые сущности без необходимости.
-- Не добавляй тяжелые зависимости без явного запроса.
-- Не изменяй формат существующих данных в storage без миграционного плана.
-- Не удаляй legacy-ветки логики, пока не проверено, что они не используются.
+
+- Не переименовывать файлы и экспортируемые сущности без необходимости.
+- Не добавлять тяжелые зависимости без явного запроса.
+- Не изменять формат существующих данных в storage без миграционного плана.
+- Не удалять legacy-ветки логики, пока не проверено, что они не используются.
 
 ## Обязательные требования к качеству
+
 - Любая новая асинхронная логика должна иметь блок обработки ошибок.
-- Любая ветка с внешними данными должна обрабатывать null/undefined/пустые коллекции.
+- Любая ветка с внешними данными должна обрабатывать `null`, `undefined` и пустые коллекции.
 - Любая правка UI должна учитывать корректное состояние загрузки и ошибки.
 - Любая вынесенная утилита должна иметь понятный интерфейс и предсказуемый возврат.
 
 ## Стандарты качества
+
 - Код должен быть читаемым и предсказуемым.
 - Любая новая ветка логики должна иметь обработку ошибок.
-- Избегай глубокой вложенности условий, упрощай через ранние возвраты.
-- Для повторяющейся логики используй утилиты и переиспользуемые функции.
+- Избегать глубокой вложенности условий, упрощать через ранние возвраты.
+- Для повторяющейся логики использовать утилиты и переиспользуемые функции.
 
 ## Примеры безопасной стратегии изменений
+
 - Если меняется формат данных для экрана, сначала добавить адаптер совместимости, затем использовать его в одном месте.
 - Если изменяется сетевой ответ, обеспечить fallback на кеш или информативное состояние ошибки.
 - Если правится логика фильтра, проверять поведение при пустом списке и при единственном элементе.
 
 ## Минимальная валидация
-- Запуск приложения: npm run start.
+
+- Запуск приложения: `npm run start`.
 - Проверка ключевых сценариев вручную:
   - открытие расписания;
-  - переключение форматов/фильтров (если затронуто);
+  - переключение форматов и фильтров, если затронуто;
   - открытие настроек;
-  - загрузка новостей/данных при сети и без сети.
+  - загрузка новостей и данных при сети и без сети.
 
 ## Рекомендованная расширенная валидация
+
 - Если затронуты уведомления: проверить отсутствие дублирования и корректный тайминг.
 - Если затронуты фоновые задачи: убедиться, что нет частых лишних запусков.
 - Если затронуты настройки: проверить чтение ранее сохраненных значений.
 - Если затронуты ассеты: убедиться, что не нарушены пути и отображение на основных экранах.
 
 ## Красные флаги
+
 - Изменение прошло, но причины потенциальной регрессии не проанализированы.
 - Логика изменилась сразу в нескольких файлах без четкой необходимости.
 - Появились неиспользуемые импорты, временные костыли и отладочные вставки.
 - Нет явного описания, как вручную проверить изменение.
 
 ## Шаблон отчета агента
+
 - Что сделано.
 - Какие файлы изменены.
 - Почему решение выбрано.

App.js

@@ -24,6 +24,7 @@ import { getBlurConfig } from './utils/liquidGlass';
 import * as Sentry from '@sentry/react-native';
 import notificationService from './utils/notificationService';
 import backgroundService from './utils/backgroundService';
+import { hasUnlockedAllAchievements } from './utils/achievements';
 
 Sentry.init({
   dsn: 'https://9954c52fe80999a51a6905e3ee180d11@sentry.sculkmetrics.com/5',
@@ -146,6 +147,7 @@ export default Sentry.wrap(function App() {
   const [systemTheme, setSystemTheme] = useState(Appearance.getColorScheme() || 'light');
   const [refresh, setRefresh] = useState(0);
   const [refreshKey, setRefreshKey] = useState(0);
+  const [legendUnlocked, setLegendUnlocked] = useState(false);
   const insets = useSafeAreaInsets();
 
   // Refs для дочерних экранов (для управления из хедера)
@@ -158,6 +160,8 @@ export default Sentry.wrap(function App() {
   const scheduleExportHandler = useRef(null);
   const [scheduleExportAvailable, setScheduleExportAvailable] = useState(false);
   const [scheduleExporting, setScheduleExporting] = useState(false);
+  const scheduleFavoritesHandler = useRef(null);
+  const [scheduleFavoritesAvailable, setScheduleFavoritesAvailable] = useState(false);
   const [mapSubScreen, setMapSubScreen] = useState(null);
   const [freshmanSubScreen, setFreshmanSubScreen] = useState(null);
   const [settingsSubScreen, setSettingsSubScreen] = useState(null);
@@ -460,9 +464,22 @@ const handleNewYearModeChange = async (enabled) => {
     try {
       const savedTheme = await SecureStore.getItemAsync('theme');
       const savedAccentColor = await SecureStore.getItemAsync('accentColor');
+      const allUnlocked = await hasUnlockedAllAchievements().catch(() => false);
+
+      setLegendUnlocked(allUnlocked);
 
-      if (savedTheme) setTheme(savedTheme);
-      if (savedAccentColor) setAccentColor(savedAccentColor);
+      if (savedTheme === 'legend' && !allUnlocked) {
+        setTheme('dark');
+        await SecureStore.setItemAsync('theme', 'dark');
+      } else if (savedTheme) {
+        setTheme(savedTheme);
+      }
+      if (savedAccentColor === 'legend' && !allUnlocked) {
+        setAccentColor('green');
+        await SecureStore.setItemAsync('accentColor', 'green');
+      } else if (savedAccentColor) {
+        setAccentColor(savedAccentColor);
+      }
     } catch (error) {
       console.error('Error loading settings:', error);
     }
@@ -504,6 +521,7 @@ const handleNewYearModeChange = async (enabled) => {
       accentColor={accentColor} 
       theme={getEffectiveTheme()} 
       holidayInfo={holidayInfo}
+      legendUnlocked={legendUnlocked}
     />;
   }
 
@@ -687,6 +705,20 @@ const handleNewYearModeChange = async (enabled) => {
                   </Text>
                 </TouchableOpacity>
               )}
+              {activeScreen === SCREENS.SCHEDULE && scheduleFavoritesAvailable && (
+                <TouchableOpacity
+                  onPress={() => scheduleFavoritesHandler.current?.()}
+                  activeOpacity={0.7}
+                  style={{
+                    marginLeft: 8,
+                    padding: 6,
+                    borderRadius: 10,
+                    backgroundColor: colors.glass,
+                  }}
+                >
+                  <Icon name="star-outline" size={18} color={colors.primary} />
+                </TouchableOpacity>
+              )}
               {activeScreen === SCREENS.SCHEDULE && scheduleExportAvailable && (
                 <TouchableOpacity
                   onPress={() => scheduleExportHandler.current?.()}
@@ -783,6 +815,20 @@ const handleNewYearModeChange = async (enabled) => {
             </Text>
           </TouchableOpacity>
         )}
+        {activeScreen === SCREENS.SCHEDULE && scheduleFavoritesAvailable && (
+          <TouchableOpacity
+            onPress={() => scheduleFavoritesHandler.current?.()}
+            activeOpacity={0.7}
+            style={{
+              marginLeft: 8,
+              padding: 6,
+              borderRadius: 10,
+              backgroundColor: colors.glass,
+            }}
+          >
+            <Icon name="star-outline" size={18} color={colors.primary} />
+          </TouchableOpacity>
+        )}
         {activeScreen === SCREENS.SCHEDULE && scheduleExportAvailable && (
           <TouchableOpacity
             onPress={() => scheduleExportHandler.current?.()}
@@ -919,6 +965,10 @@ const handleNewYearModeChange = async (enabled) => {
               setScheduleExportAvailable(!!handler);
               setScheduleExporting(isExporting);
             }}
+            onFavoritesReady={(handler) => {
+              scheduleFavoritesHandler.current = handler;
+              setScheduleFavoritesAvailable(!!handler);
+            }}
           />
         )}
         {activeScreen === SCREENS.MAP && (
@@ -959,6 +1009,7 @@ const handleNewYearModeChange = async (enabled) => {
             ref={settingsScreenRef}
             theme={effectiveTheme} 
             accentColor={accentColor} 
+            legendUnlocked={legendUnlocked}
             setTheme={setTheme} 
             setAccentColor={setAccentColor} 
             key={`settings-${refreshKey}`}