Настольная книга Asia Expeditions

Экран /sign-in. Система ищет пользователя по email и сверяет пароль.

• Пароль неверный или email неизвестен → «Неверный email или пароль». Формулировка одна на оба случая — чтобы нельзя было перебором выяснить, какие адреса заведены. Более того, при неизвестном email система намеренно тратит столько же времени на проверку, сколько и на настоящую, — чтобы нельзя было вычислить существование аккаунта по скорости ответа.
• Аккаунт деактивирован → отдельное сообщение «Ваш аккаунт деактивирован. Свяжитесь с поддержкой…». Здесь система сознательно раскрывает причину, чтобы человек не бился о «неверный пароль».
• 2FA выключена → вы сразу в системе.
• 2FA включена → выдаётся временный промежуточный токен на 5 минут и вас перебрасывает на экран ввода кода. Этим токеном нельзя открыть ничего, кроме проверки кода.

После успешного входа выдаются два токена: рабочий на 24 часа и токен продления на 7 дней. Пока вы пользуетесь системой, сессия продлевается незаметно. Если не заходить неделю — придётся логиниться заново.

Экран /two-factor. Принимается либо шестизначный TOTP-код, либо один из резервных кодов.

• Допуск по времени — одно окно в 30 секунд в обе стороны, то есть код, который только что сменился, ещё сработает.
• Резервный код сгорает при использовании — второй раз тот же код не примут.
• Если за 5 минут код не введён — промежуточный токен истёк, надо начинать вход заново.
• Если пока вы искали телефон, администратор деактивировал ваш аккаунт — вход не завершится.

Настройки → вкладка безопасности. Порядок жёсткий и его нельзя пропустить:

1. Система генерирует секрет и QR-код (подпись в приложении будет «Asia Expeditions (ваш email)») и сразу сохраняет секрет в вашем профиле — но 2FA пока выключена.
2. Вы сканируете QR и вводите текущий код. Код неверный — включения не происходит.
3. 2FA включается, и система единожды показывает 10 резервных кодов. Повторно их посмотреть невозможно.

Обе операции требуют ввести действующий TOTP-код. Перевыпуск аннулирует все старые 10 кодов и выдаёт новые 10. Выключение 2FA стирает и секрет, и все резервные коды.

Настройки → аккаунт. Нужен текущий пароль. Если у вас включена 2FA — дополнительно требуется TOTP-код. Новый пароль обязан отличаться от текущего и пройти проверку сложности:

• от 8 до 128 символов;
• минимум одна заглавная, одна строчная, одна цифра и один спецсимвол;
• не больше двух одинаковых символов подряд («aaa» — запрещено);
• не должен содержать имя из вашего email (для ivanov@… пароль с «ivanov» не примут).

Экран /forgot-password. Система всегда отвечает одинаково, независимо от того, есть такой email или нет. Письмо со ссылкой уходит только если аккаунт реально существует и уже активирован.

• Ссылка живёт 15 минут.
• Каждый новый запрос аннулирует предыдущую ссылку.
• Приглашённому пользователю, который ещё не принял приглашение, ссылка сброса не отправляется — такому человеку нужна ссылка-приглашение, а не сброс. Если он всё-таки где-то раздобудет токен сброса, система откажет: «Аккаунт ещё не активирован — воспользуйтесь ссылкой из приглашения».
• Новый пароль проходит ту же проверку сложности.

Заполняются пять полей:

Что происходит дальше, по шагам:

1. Создаётся аккаунт со статусом «Ожидает приглашение» (pending) и случайным временным паролем, который никому не показывается и которым нельзя войти.
2. Генерируется одноразовый токен со сроком жизни 7 дней.
3. На почту уходит письмо со ссылкой вида /accept-invitation?token=…&email=….
4. Администратору возвращается сама ссылка и флаг «письмо ушло / не ушло».

По ссылке из письма человек вводит пароль (та же проверка сложности, что в 2.5). Проверяется, что токен жив, что email в ссылке совпадает с email аккаунта и что приглашение ещё не принято. После успеха статус меняется на «Активен», а токен удаляется — ссылка одноразовая.

Меняются имя, фамилия, email, роль, идентификатор и инициалы. Инициалы — отдельное поле (до 16 символов): именно они подставляются в номер заявки как {INITIALS}. Если поле пустое, система соберёт инициалы из имени и фамилии автоматически.

Смена роли действует немедленно и меняет весь набор доступных разделов. Email и идентификатор проверяются на уникальность.

Доступно только для пользователей в статусе «Ожидает приглашение». Старый токен удаляется, выпускается новый на 7 дней. Для уже активного пользователя кнопка вернёт отказ.

Статус становится «Неактивен», предыдущий статус запоминается. Эффект мгновенный и жёсткий: даже если у человека на руках действующий токен сессии, каждый его запрос будет отклонён с сообщением «Ваш аккаунт деактивирован. У вас больше нет доступа к платформе». Разлогинивать принудительно не требуется.

Кнопка активации возвращает тот статус, который был до деактивации, а не просто «Активен»:

• был активен → снова активен, работает сразу;
• был «ожидает приглашение» → снова «ожидает приглашение», и система прямо об этом предупреждает: доступа не будет, пока не отправите приглашение повторно;
• уже активен → отказ «Пользователь уже активен»;
• «ожидает приглашение» напрямую активировать нельзя — человек обязан пройти по ссылке-приглашению.

Сценарий «сотрудник потерял телефон и резервные коды». Администратор отключает пользователю 2FA без ввода кода. Секрет и резервные коды стираются, человек входит по одному паролю и может настроить 2FA заново.

Список поддерживает поиск, сортировку и фильтры по роли, статусу и признаку «2FA включена / выключена». Последний фильтр — практичный способ проверить, кто из сотрудников ещё не защитил аккаунт.

Отдельно есть «пользователи для выбора» — облегчённый список активных сотрудников с поиском, который подставляется в поля «Ответственный» в заявках и турах. Он доступен всем ролям, кроме справочных.

По умолчанию {INITIALS}{YY}-{NNNN}. Доступные подстановки:

Маска обязана содержать порядковый номер — сохранить её без {N…} система не даст. Длина — до 64 символов.

Как работает счётчик: он свой у каждой организации и у каждого календарного года. С наступлением нового года нумерация начинается заново с единицы. Инкремент атомарный — два оператора, создающие заявку в одну секунду, гарантированно получат разные номера.

Комиссия разбита на три независимых поля, каждое от 0 до 100 % с двумя знаками после запятой:

• Налог, %
• Комиссия продавца, %
• Административные расходы, %

В расчёте применяется их сумма. Разбивка нужна, чтобы понимать, из чего сложился процент; ни одно из полей не работает отдельно.

• Порог FOC — с какого числа человек начисляется бесплатное место. По умолчанию 10. Значение 0 означает «FOC начисляется всегда». Как и комиссия, фиксируется в версии расчёта при её создании.
• Стандартные точки PAX — например [2, 4, 6, 8, 10]. Не больше 20 значений, каждое — целое ≥ 1. Система сама убирает дубли и сортирует по возрастанию. Эти точки подставляются в первую версию расчёта новой заявки и в каждую новую пустую версию.

Два свободных текстовых поля — «Включено в стоимость» и «Не включено». Они копируются в заявку в момент её создания и дальше редактируются в каждой заявке независимо. Изменение шаблона не подтягивается в уже созданные заявки.

По каждой валюте отдельно задаётся поправка к курсу Нацбанка — в процентах либо фиксированной суммой в сомах. Подробнее в разделе 06.

У каждого справочника один и тот же трёхшаговый маршрут:

1. Скачать шаблон. Система формирует .xlsx с готовыми заголовками, листом «Инструкция», примерами значений и выпадающими списками там, где значение должно быть из фиксированного набора. Заголовки в шаблоне совпадают с тем, что ждёт парсер, — переименовывать колонки нельзя.
2. Проверить файл. Кнопка предпросмотра прогоняет файл без сохранения и показывает, сколько строк пройдёт и какие сломаются, с номером строки и причиной.
3. Импортировать. Корректные строки сохраняются, ошибочные пропускаются. В ответе — сколько создано, сколько не прошло и список ошибок.

Отдельной кнопкой скачивается файл с ошибочными строками: исправляете в нём и загружаете повторно, не разбирая исходный файл целиком.

Удаление возможно, но связанные записи защищены ссылками в базе: гостиницу, на которую заведена расценка, или партнёра, привязанного к заявке, удалить не получится — операция вернёт ошибку. Порядок всегда обратный порядку создания: сначала расценка, потом объект.

Ежедневно в 06:00 система обращается к официальному файлу Нацбанка КР (nbkr.kg/XML/daily.xml), забирает котировки и пересчитывает расчётные курсы по вашим корректировкам. Таймаут запроса — 15 секунд. Валюта, которой в фиде нет, просто пропускается с пометкой в журнале.

Кнопка «Загрузить курсы». Делает то же самое, что ночной процесс, но по вашей команде. Если Нацбанк недоступен, вернётся понятная ошибка.

Для валюты, которой нет в фиде Нацбанка. Указываете курс ЦБ (обязательно положительный), расчётный система выведет сама по корректировке. Источник записи помечается как «ручной».

Выбираете режим (процент или фиксированная сумма) и значение — допускается отрицательное. Сохранение немедленно пересчитывает расчётные курсы по всем последним котировкам.

Обязательные поля: партнёр-клиент, одна или несколько стран маршрута, категория отеля (3★/4★/5★), источник обращения (WhatsApp, Telegram, email, личный кабинет, звонок, прямое обращение). Опционально: категория маршрута, ответственный, код тура партнёра, комментарий.

Даты задаются одним из двух способов, третьего нет:

• Год + сезон. Система выводит даты из сезона: начало = день/месяц начала сезона в указанном году. Если сезон переходит через Новый год (напр. 15.11 → 20.02), конец берётся в следующем году.
• Прямые даты начала и окончания.

Указать только год или только сезон нельзя — система потребует и то и другое либо обе даты.

Что происходит в момент создания — цепочка из шести шагов:

1. Проверяется, что партнёр — клиент (роль «client» или «both»). Поставщика в заявку выбрать нельзя.
2. Из профиля партнёра копируется его тип (B2B / B2C).
3. Считается длительность в днях (включая обе даты).
4. Генерируется номер по маске организации, с инициалами и идентификатором автора заявки.
5. Из настроек организации копируются тексты КП «включено» и «не включено».
6. Автоматически создаётся первая версия расчёта со стандартными точками PAX, снимком комиссии, снимком наценки категории партнёра и снимком всех курсов валют. Она сразу становится активной.

В журнал статусов пишется запись «создана → Расчёт» с автором и временем.

Правило простое, но с исключением:

• Ответственного можно менять в любом статусе, включая подтверждённую заявку.
• Всё остальное — партнёр, страны, даты, год/сезон, категория отеля, категория маршрута, источник, комментарий — только в статусах «Расчёт» и «Отправлена». После подтверждения коммерческая информация замораживается.

Смена года или сезона заново выводит даты и пересчитывает длительность. Смена стран корректно обновляет список: основной страной остаётся первая в списке.

Обе кнопки работают только из статуса «Отправлена партнёру». Из «Расчёта» подтвердить нельзя — сначала нужно отправить КП. Каждый переход пишется в журнал с автором и временем.

Клиент передумал. Кнопка реактивации делает три вещи разом:

1. Присваивает заявке новый номер (счётчик двигается вперёд).
2. Возвращает статус «Расчёт».
3. Клонирует активную версию расчёта в новую: копируются точки PAX, параметры, строки затрат и блоки программы, но курсы валют фиксируются заново, на текущий момент. Старая версия остаётся в истории.

Реактивация доступна только из статуса «Отклонена».

Администратор может выставить любой статус в обход матрицы переходов — например, вернуть подтверждённую заявку в «Расчёт». В журнале такая запись помечается каналом «manual».

Удаление необратимо и уносит с собой всё: журнал статусов, все версии расчёта со строками, точками PAX и курсами, программу тура и коммерческие предложения.

Единственная защита: заявку, из которой создан хотя бы один тур, удалить нельзя — система вернёт отказ.

Поиск идёт по номеру заявки, коду тура партнёра и названию партнёра одновременно. Фильтры: статус, партнёр, направление, ответственный, месяц начала тура, диапазон дат начала тура, диапазон дат создания заявки. Сортировка: по номеру, дате начала, дате создания, статусу.

Журнал статусов показывает каждый переход: откуда, куда, кто инициировал (ФИО или «система»), канал отправки и точное время в вашем часовом поясе.

Тот же трёхшаговый маршрут, что у справочников. Колонки: Партнёр, Код страны, Дата начала, Дата окончания, Категория отеля (3/4/5), Источник, Код тура партнёра, Комментарий. Даты принимаются в двух форматах: ГГГГ-ММ-ДД и ДД.ММ.ГГГГ. Источник понимает и английские коды, и русские слова («почта», «звонок», «прямой»).

Каждая импортированная строка проходит полный сценарий создания — с номером, копированием текстов КП и созданием первой версии расчёта.

Программа сохраняется целиком, одним действием: старые блоки удаляются, новые записываются. Порядок мероприятий внутри блока сохраняется как есть.

Побочный эффект сохранения: длительность заявки пересчитывается как сумма длительностей всех блоков — но только если редактируемая версия является активной у заявки.

Оператору при просмотре программы показываются подтянутые из справочников названия, актуальные цены на дату начала тура, звёзды и номерной фонд гостиницы, поставщик, категория услуги, город, адрес, телефон, ссылка на документы и комментарии. Всё это — справочная обвязка, помогающая собрать программу, не выходя из вкладки.

Для услуг с тарификацией «произвольная» можно указать собственную цену вместо справочной. В программе она задаётся в валюте расценки и конвертируется в валюту тура по курсу, зафиксированному в версии.

Список точек задаётся вручную; дубли убираются, порядок — по возрастанию. Матрица показывает по каждой точке: PAX, FOC, себестоимость транспорта, гостиниц, услуг, базу под комиссию, себестоимость без наценки, общую себестоимость, комиссию, итого по туру, цену на человека и доплату за одноместное.

По каждой цифре доступна расшифровка-подсказка с формулой: например, «Ала-Арча: 8 000 KGS / 2 × 6 + 8 000 KGS × 1) × 3». Это сделано специально, чтобы любую сумму можно было проверить руками, не выгружая расчёт.

Редактируются три вещи: число мест FOC, доплата за одноместное (ручное значение) и валюта тура. Смена валюты тура немедленно пересчитывает снимок курсов относительно новой базы.

Организационные расходы и прочее, что не привязано к конкретному дню. Указываются ссылка на «Расценки за услуги», количество и, при необходимости, своя цена в валюте тура. Для тарификации «фиксированная в день» количество здесь означает множитель за весь тур.

Экран делится на строки из программы (сгруппированы по блокам, редактируются в программе) и ручные дополнительные услуги. По каждой строке видны: наименование, поставщик, категория, тип тарификации, признак наценки, цена в валюте справочника и в валюте тура, количество, для гостиниц — цены одноместного и двухместного, для транспорта — состав подобранных машин по каждой точке PAX и полный перечень доступных типов направления.

КП у заявки одно. При первом открытии вкладки оно создаётся автоматически по активной версии расчёта; при повторных — возвращается существующее.

• Номер КП: номер заявки + -Q + порядковый, сквозной по всем версиям заявки: МК26-0028-Q1, -Q2…
• Язык документа берётся из карточки партнёра (язык общения). Если не задан — русский.
• «Действует до» подставляется как 31 декабря года тура, если год у заявки указан. Подставляется один раз: очистив поле вручную, вы не получите его обратно при следующем открытии.

Редактируются: «Включено в стоимость», «Не включено», условия оплаты, срок действия и язык документа. Эти поля хранятся на уровне заявки, а не версии расчёта, — то есть при переключении активной версии условия не сбрасываются.

Предпросмотр собирается на лету и всегда отражает активную версию расчёта — даже если КП формально привязано к другой версии. То есть переключили активную версию — предпросмотр и будущий документ поменялись.

В документ попадают: реквизиты заявки, партнёр, страны, даты, длительность, категория отеля, матрица цен, программа по блокам и состав тура. Комиссия и наценка в клиентский документ не выводятся — это внутренние блоки.

Генерация ставится в фоновую очередь — интерфейс не блокируется. Запись файла проходит через статусы: «в очереди» → «готов» / «ошибка». Файл рендерится и кладётся в объектное хранилище; скачивается по временной ссылке.

• Имя файла собирается по маске «дата_номер»: 2026-07-21_МК26-0028-Q1.pdf.
• Фиксируются автор генерации и номер версии расчёта, по которой сделан документ, — в списке файлов видно, какому сценарию соответствует каждый PDF.
• Файл живёт 14 дней (настраивается на сервере). После этого ежедневная очистка удаляет и объект в хранилище, и запись. Попытка скачать просроченный файл вернёт «Срок хранения файла истёк — сгенерируйте документ заново».
• Рендер, не завершившийся за 15 минут, автоматически помечается как неудачный.
• При сбое делается до двух попыток.

Кнопка «Отправить» фиксирует факт отправки: КП помечается как отправленное, записываются время и канал (по умолчанию email).

Главный побочный эффект: если заявка была в статусе «Расчёт», она автоматически переходит в «Отправлена партнёру», и в журнал пишется запись с каналом отправки. Именно этот переход открывает кнопки «Подтвердить» и «Отклонить».

Условия: заявка в статусе «Подтверждена» и у неё есть активная версия расчёта. Из одной заявки можно создать несколько резервирований — например, на разные заезды.

Вы указываете дату начала и раскладку номеров: сколько одноместных (SGL), двухместных (DBL), твинов (TWIN) и трёхместных (TRPL). Минимум один номер обязателен.

PAX должен быть не меньше единицы — иначе система откажет.

Что создаётся одной транзакцией:

1. Номер тура вида T2026-0001 — сквозной счётчик по организации и году даты начала тура.
2. Неизменяемый снимок цены с причиной «создан»: точный расчёт под этот PAX и эту дату, раскладка номеров, стоимость, доплата за одноместные, комиссия и полная разбивка.
3. Запись в журнал статусов.
4. Расписание, посеянное из программы тура.

Отдельная кнопка предпросмотра: указываете дату и раскладку и видите длительность, дату окончания, число номеров, всего человек, FOC, PAX, цену на человека, доплату и итог. Ни резервирование, ни версия расчёта при этом не меняются. То же доступно и для уже созданного тура — «что будет, если сдвинуть дату или переложить номера».

Три поля с разными последствиями:

Две защиты, которые остановят изменение:

• Нельзя уменьшить раскладку так, чтобы PAX стал меньше числа уже добавленных туристов.
• Если после сдвига какое-то событие расписания вылезет за пределы новых дат тура — изменение отклоняется с просьбой сначала поправить расписание.

Кнопка ручного пересчёта — когда изменились справочники и нужно зафиксировать актуальную стоимость при тех же дате и раскладке. Обязательно требуется текстовое пояснение, оно навсегда сохраняется в снимке. Создаётся новый снимок с причиной «ручной пересчёт».

Снимки цены неизменяемы и накапливаются. По каждому видно: дату, PAX, раскладку, причину изменения, пояснение оператора, валюту, FOC, себестоимость, комиссию, итог, цену на человека, доплату и полную внутреннюю разбивку. Это ваш аудиторский след «почему тур стоит столько».

Бронь может быть привязана к событию расписания или существовать сама по себе. Поля: обязательность, поставщик (из партнёров), контактное лицо (из контактов), канал связи, дедлайн, номер подтверждения, фактическая стоимость с валютой, условия оплаты, процент предоплаты, комментарий.

Имя, email и телефон контакта подставляются автоматически из справочника и дальше редактируются вручную — то есть в брони остаётся тот контакт, который был на момент бронирования, даже если справочник потом изменили.

Статусы брони — движение только вперёд:

«Подтверждено» и «Отменено» — тупики: изменить статус после них нельзя. Из «не забронировано» нельзя перепрыгнуть сразу в «подтверждено».

Фактическую стоимость и валюту можно указывать только вместе — одно без другого система не примет.

Расписание создаётся автоматически при создании резервирования: каждое мероприятие программы превращается в событие. Гостиница разворачивается в отдельное событие на каждую ночь, транспорт и услуги — в одно событие на блок.

Тип события определяется автоматически: гостиница → «Проживание», транспорт → «Трансфер», услуга → «Прочее». Дальше события правятся вручную: тип (проживание, трансфер, питание, экскурсия, активность, свободное время, прочее), название, описание, даты, время начала и окончания, место, порядок внутри дня, признак «требует бронирования».

Доступны: добавление события, перестановка внутри дня, атомарный перенос события на другую дату с заданием порядка, удаление.

По каждому туристу: ФИО (обязательно), гражданство, дата рождения, номер паспорта, срок действия паспорта, email, телефон, тип размещения (одноместное / двухместное / трёхместное), особые требования, порядок в списке.

Импорт из Excel: шаблон с колонками ФИО, Гражданство, Дата рождения, Паспорт, Действителен до, Email, Телефон, Размещение, Особые требования. Строки сверх PAX отклоняются с указанием номера строки и причины; корректные — сохраняются.

Печатная форма списка туристов формируется отдельной кнопкой.

Документ привязывается к туру и, опционально, к событию расписания или к брони. Типы: общий, подтверждение брони, ваучер, билет, страховка, прочее. Разрешены PDF, JPEG, PNG, WEBP. Файл грузится из браузера напрямую в хранилище по временной ссылке; скачивание — тоже по временной ссылке.

Итоговый операционный документ в PDF или XLSX. Собирает воедино: реквизиты тура и заявки, партнёра, ответственного, всё расписание по датам, все брони с поставщиками, контактами и статусами, полный список туристов.

Каждая генерация сохраняется отдельной версией — видно, кто и когда сформировал. Скачивание по временной ссылке. При сбое версия помечается как неудачная.

Поиск идёт одновременно по номеру тура, номеру заявки, коду тура партнёра и названию партнёра. Фильтры: статус, направление, ответственный, диапазон дат начала. Сортировка: номер, дата начала, дата окончания, PAX, статус, дата создания.

В списке у каждого тура виден прогресс бронирования — сколько обязательных броней подтверждено из скольких и процент готовности.

Количество заявок в каждом из четырёх статусов за период, общее число и число активных (в «Расчёте» и «Отправлена»).

Показатели за период:

• воронка «открыто → отправлено → подтверждено → отклонено» с процентами от числа открытых;
• конверсия = подтверждённые / открытые;
• закрываемость = подтверждённые / отправленные;
• средний срок от создания до отправки и от отправки до подтверждения, в днях;
• отказы с разбивкой по этапу, на котором заявка сорвалась;
• сравнение с предыдущим периодом такой же длины;
• временной ряд с настраиваемой детализацией.

Две таблицы — по ответственным и по партнёрам. В каждой: открыто, отправлено, подтверждено, отклонено, конверсия. Поддерживаются поиск, сортировка по любому столбцу и постраничный вывод. Дополнительно фильтруется по направлению, источнику обращения, категории отеля и типу партнёра (B2B / B2C).

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

Условия включения проверяются жёстко: системный промпт заполнен, ключ выбранной модели сохранён. Иначе включить не дадут.

Ключ хранится в зашифрованном виде и никогда не возвращается в интерфейс целиком. Есть отдельная операция «показать ключ» и кнопка «Проверить» — она делает тестовый запрос к модели с заглушечным блоком и показывает, отвечает ли провайдер. Очистка поля ключа удаляет сохранённые учётные данные.

Три операции, и система следит, чтобы вы выбрали правильную:

Модель получает контекст блока: длительность, точки маршрута, состав мероприятий с названиями из справочников. Язык результата берётся из языка общения партнёра — французскому клиенту описание сгенерируется по-французски.

Можно добавить свободный «контекст для модели» до 5000 символов — уточнение к конкретной генерации.

• Таймаут запроса — 30 секунд, длина ответа ограничена.
• Повторная отправка того же запроса не создаёт вторую генерацию: система распознаёт дубль и вернёт первый результат.
• Каждая генерация пишется в журнал: кто, когда, какая версия и заявка, какая модель, язык, статус, длительность, объём текста на входе и выходе, код ошибки при сбое.