feat(recommendations): collect demographics and advance age cohorts

packages/api-client/src/generated/schema.ts

@@ -1225,8 +1225,9 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Онбординг вкуса — исполнители и жанры библиотеки для выбора
-         * @description `required` — показать онбординг: пользователь его не проходил и не пропускал, а своей истории почти нет.
+         * Анкета рекомендаций — варианты, сохранённые ответы и необходимость заполнения
+         * @description `required` — пользователь не проходил и не пропускал анкету либо администратор сбросил рекомендации.
+         *     `choice` содержит ответы с текущей приблизительной возрастной группой; исходная группа и год хранятся на сервере.
          */
         get: operations["getOnboarding"];
         put?: never;
@@ -1472,6 +1473,7 @@ export interface components {
         };
         Onboarding: {
             required: boolean;
+            choice?: components["schemas"]["OnboardingChoice"];
             artists: {
                 /** Format: uuid */
                 id: string;
@@ -1487,6 +1489,15 @@ export interface components {
             }[];
         };
         OnboardingChoice: {
+            /** @enum {string|null} */
+            gender?: "male" | "female" | "other" | null;
+            /**
+             * @description Текущая приблизительная возрастная группа. Сервер хранит год выбора и учитывает прошедшие годы.
+             * @enum {string|null}
+             */
+            age_group?: "under_13" | "13_19" | "20_29" | "30_39" | "40_49" | "50_59" | "60_plus" | null;
+            /** @description Год последнего выбора возрастной группы. */
+            readonly age_group_year?: number;
             artist_ids: string[];
             genres: string[];
         };

packages/core/src/index.ts

@@ -27,3 +27,5 @@ export { checkServer, normalizeServerUrl, type ServerCheck } from './server';
 export { initialWaveState, mix, rgb, rgba, step, WAVE_COLORS, waveScale, type Rgb, type WaveState } from './wave-anim';
 
 export { WaveCoordinator, EARLY_SKIP_MS, WAVE_REFILL_AT, type WaveInfo, type WaveOutcome, type WaveFeedback, type WaveGateway } from './wave';
+
+export { AGE_GROUPS, GENDERS } from './onboarding';

packages/core/src/onboarding.ts

@@ -0,0 +1,2 @@
+export const AGE_GROUPS = ['under_13', '13_19', '20_29', '30_39', '40_49', '50_59', '60_plus'] as const;
+export const GENDERS = ['male', 'female', 'other'] as const;

packages/i18n/locales/en/common.json

@@ -318,7 +318,26 @@
     "pick_more_one": "Pick {{count}} more artist",
     "pick_more_few": "Pick {{count}} more artists",
     "pick_more_many": "Pick {{count}} more artists",
-    "pick_more_other": "Pick {{count}} more artists"
+    "pick_more_other": "Pick {{count}} more artists",
+    "gender": "Gender",
+    "age_group": "Age group",
+    "unspecified": "Prefer not to say",
+    "edit": "Recommendation preferences",
+    "age_hint": "Your group will advance approximately from the year selected. You can correct it in your profile.",
+    "genders": {
+      "male": "Male",
+      "female": "Female",
+      "other": "Other"
+    },
+    "ages": {
+      "under_13": "До 13",
+      "13_19": "13–19",
+      "20_29": "20–29",
+      "30_39": "30–39",
+      "40_49": "40–49",
+      "50_59": "50–59",
+      "60_plus": "60+"
+    }
   },
   "playlists": {
     "name": "Name",

packages/i18n/locales/ru/common.json

@@ -318,7 +318,26 @@
     "pick_more_one": "Выберите ещё {{count}} исполнителя",
     "pick_more_few": "Выберите ещё {{count}} исполнителя",
     "pick_more_many": "Выберите ещё {{count}} исполнителей",
-    "pick_more_other": "Выберите ещё {{count}} исполнителя"
+    "pick_more_other": "Выберите ещё {{count}} исполнителя",
+    "gender": "Пол",
+    "age_group": "Возрастная группа",
+    "unspecified": "Не указывать",
+    "edit": "Настроить рекомендации",
+    "age_hint": "Группа будет обновляться приблизительно с учётом года выбора. Её можно исправить в профиле.",
+    "genders": {
+      "male": "Мужской",
+      "female": "Женский",
+      "other": "Другой"
+    },
+    "ages": {
+      "under_13": "До 13",
+      "13_19": "13–19",
+      "20_29": "20–29",
+      "30_39": "30–39",
+      "40_49": "40–49",
+      "50_59": "50–59",
+      "60_plus": "60+"
+    }
   },
   "playlists": {
     "name": "Название",