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

Необходимо:

• Выявить процессы, которые происходят, 

• На основе этих процессов отобразить схему (sequence diagram) взаимодействия, 

• Предложить 2 способа оптимизации, чтобы избавиться от текущих проблем.

Решение

Выделим процессы, которые есть из описания задачи и разделим их на:

• бизнес-процессы,

• системные взаимодействия.

Начнём с бизнес-процессов

1. Добавление товара в корзину

• проверка наличия товара на складе. 

2. Оформление заказа 

• отправка полного списка товаров, которые выбрал клиент, 

• резервирование товаров для дальнейшего списания после оплаты. 

Выделять больше процессов не вижу смысла - пока достаточно.

Теперь «как это выглядит под капотом»

Выделим компоненты системы:

• Веб-приложение, 

• Бэкенд, 

• Брокер сообщений, 

• Сервис склада. 

Добавление товара:

1. Клиент добавляет товар в корзину, 

2. Веб-приложение отправляет запрос на добавление товара в корзину на бэкенд, 

3. Бэкенд отправляет запрос на проверку наличия товара на складе через брокер, 

4. Сервис склада вычитывает сообщение и сообщает, есть товар или нет, 

5. Бэкенд возвращает ответ веб-приложению - можно добавить товар или нет. 

Оформление заказа:

1. У клиента собрана корзина, 

2. Он нажимает «Оформить», 

3. Веб-приложение отправляет запрос на бэкенд со списком товаров и количеством, 

4. Бэкенд отправляет сообщение на резервирование товара через брокер, 

5. Сервис склада вычитывает сообщение и резервирует товар или отклоняет запрос, 

6. Бэкенд возвращает результат в веб-приложение, 

7. При успешном резервировании - переходим к оплате, при неуспехе - отклоняем заказ. 

Получилась ситуация AS IS

Теперь на основе этой диаграммы можем предложить изменения, которые помогут решить исходную проблему.

Напомню условия задачи: 

> Клиенты могут добавлять несколько товаров в корзину одновременно и отправлять несколько заказов → резервируется больше товара, чем есть на складе → товар отображается как доступный, но при оформлении оказывается уже зарезервирован.

Первая неэффективность

Несколько клиентов добавили товар в корзину, но никто не зарезервировал его за собой.

Пример: 

• У нас 1 кг бананов на складе, 

• Три клиента добавили этот килограмм в корзину, 

• Для каждого товар отображается как доступный, 

• Но при оформлении заказа - только один сможет его купить. 

Как можно обойти?

Переносим резервирование товара на этап добавления в корзину. 

Когда клиент добавляет товар - мы сразу его резервируем.

Возможный кейс: 

Клиент добавил товар, но не оформил заказ — например, ушёл от компьютера. 

Товар остаётся заблокированным.

Решение: 

Устанавливаем временное ограничение на резервирование (например, 15 минут). 

Если клиент не оформляет заказ - товар возвращается на склад.

На этапе оформления заказа

Поскольку товар уже зарезервирован, на этом этапе мы просто подтверждаем заказ.

Можно пойти двумя путями:

1. Сразу списать товар при отправке заказа, чтобы он не разблокировался, 

2. Обнулить резерв и списать товар после оплаты. 

Личный выбор: 

Я склоняюсь к первому варианту. Если заказ не оплатят - просто вернём значения на склад.

На этом все

И помните, что эта задача из реального собеседования. 

Когда вы её решаете, то на это есть всего 15-20 минут времени и интервьюер хочет понять:

• какую теоретическую базу вы знаете,

• как вы мыслите,

• как умеете применять знания на практике.

Изучить теоретическую базу по интеграция и понять, как это использовать на практике ➡️ приглашаю сюда ⬅️

Что нам понадобится:
Gemini-CLI
OutConsoleGridView

Дисклеймер. В пикабу нет редактора кода - поэтому такое форматирование и картинки. В конце поста я дам ссылку на github. Почитайте, и если вам интересно, смотрите код на гитхабе.

Инженеры, разработчики и другие специалисты сталкиваются с тем, что нужно узнать точные параметры, например материнской платы, автомата в электрощитке или сетевого коммутатора. Наш справочник всегда будет под рукой и по запросу соберет информацию, уточнит параметры в интернете и вернет искомую таблицу. В таблице можно выбрать необходимый параметр/ы и по необходимости продолжить углубленный поиск. В дальнейшем мы научимся передавать результат по конвейеру для дальнейшей обработки: экспорта в таблицу Excel, Google таблицу, хранения в базе данных или передачи в другую программу В случае неудачи модель посоветует, какие параметры надо уточнить. Впрочем, смотрите сами:

Шаг 1: Настройка

Назначение строк:

• $env:GEMINI_API_KEY = "..." — устанавливает API ключ для доступа к Gemini AI

• if (-not $env:GEMINI_API_KEY) — проверяет наличие ключа, завершает работу если его нет

• $scriptRoot = Get-Location — получает текущую рабочую директорию

• $HistoryDir = Join-Path... — формирует путь к папке для хранения истории диалогов (.gemini/.chat_history)

• $timestamp = Get-Date... — создает временную метку в формате 2025-08-26_14-30-15

• $historyFileName = "ai_session_$timestamp.jsonl" — генерирует уникальное имя файла сессии

• $historyFilePath = Join-Path... — создает полный путь к файлу истории текущей сессии

Проверка окружения — что должно быть установлено.

Что проверяется:

• Наличие Gemini CLI в системе — без него скрипт не работает

• Файл GEMINI.md — содержит системный промпт (инструкции для AI)

• Файл ShowHelp.md — справка для пользователя (команда ?)

Основная функция взаимодействия с AI.

Задачи функции:

• Вызывает Gemini CLI с указанной моделью и промптом

• Захватывает все выводы (включая ошибки)

• Очищает результат от служебных сообщений CLI

• Возвращает чистый ответ AI или $null при ошибке

Функции управления историей.

Назначение:

• Add-History — сохраняет пары «вопрос-ответ» в JSONL формате

• Show-History — показывает содержимое файла истории

• Clear-History — удаляет файл истории текущей сессии

Функция отображения выбранных данных

Задача функции: После выбора элементов в Out-ConsoleGridView показывает их в консоли в виде аккуратной таблицы, чтобы пользователь видел, что именно выбрал.

Основной рабочий цикл.

Ключевые особенности:

• Индикатор [Выборка активна] показывает, что есть данные для анализа

• Каждый запрос включает всю историю диалога для поддержания контекста

• AI получает и историю, и выбранные пользователем данные

• Результат пытается отобразиться как интерактивная таблица

• При неудаче парсинга JSON показывается обычный текст

Структура рабочей директории.

Проследим весь жизненный цикл нашего скрипта - что происходит с момента запуска и до получения результатов.

Инициализация: подготовка к работе

При запуске скрипт первым делом настраивает рабочее окружение. Он устанавливает API ключ для доступа к Gemini AI, определяет текущую папку как базовую директорию и создает структуру для хранения файлов. Особое внимание уделяется истории диалогов - для каждой сессии создается уникальный файл с временной меткой, например ai_session_2025-08-26_14-30-15.jsonl.

Затем система проверяет, что все необходимые инструменты установлены. Она ищет Gemini CLI в системе, проверяет наличие файлов конфигурации (системный промпт и справка). Если что-то критично важное отсутствует, скрипт предупреждает пользователя или завершает работу.

Запуск интерактивного режима

После успешной инициализации скрипт переходит в интерактивный режим - показывает приветственное сообщение и ждет ввода от пользователя. Приглашение выглядит как 🤖AI :) > и меняется на 🤖AI [Выборка активна] :) > когда у системы есть данные для анализа.

Обработка пользовательского ввода

Каждый ввод пользователя сначала проверяется на служебные команды через функцию Command-Handler. Эта функция распознает команды ? (справка из файла ShowHelp.md), history (показать историю сессии), clear и clear-history (очистить файл истории), gemini help (справка по CLI), exit и quit (выход). Если это служебная команда, она выполняется немедленно без обращения к AI, и цикл продолжается.

Если это обычный запрос, система начинает формировать контекст для отправки в Gemini. Она читает всю историю текущей сессии из JSONL файла (если он существует), добавляет блок с данными из предыдущей выборки (если есть активная выборка), и объединяет все это с новым запросом пользователя в структурированный промпт с разделами "ИСТОРИЯ ДИАЛОГА", "ДАННЫЕ ИЗ ВЫБОРКИ" и "НОВАЯ ЗАДАЧА". После использования данные выборки обнуляются.

Взаимодействие с искусственным интеллектом

Сформированный промпт отправляется в Gemini через командную строку. Система вызывает gemini -m модель -p промпт, захватывает весь вывод и очищает его от служебных сообщений CLI. Если происходит ошибка на этом этапе, пользователь получает предупреждение, но скрипт продолжает работать.

Обработка ответа AI

Полученный от AI ответ система пытается интерпретировать как JSON. Сначала она ищет блок кода в формате json..., извлекает содержимое и пытается его распарсить. Если такого блока нет, парсит весь ответ целиком. При успешном парсинге данные отображаются в интерактивной таблице Out-ConsoleGridView с заголовком "Выберите строки для следующего запроса (OK) или закройте (Cancel)" и множественным выбором. Если JSON не распознается (ошибка парсинга), ответ показывается как обычный текст в голубом цвете.

Работа с выборкой данных

Когда пользователь выбирает строки в таблице и нажимает OK, система выполняет несколько действий. Сначала вызывается функция Show-SelectionTable, которая анализирует структуру выбранных данных: если это объекты с свойствами, она определяет все уникальные поля и показывает данные через Format-Table с автоподбором размера и переносом. Если это простые значения, отображает их как нумерованный список. Затем выводит счетчик выбранных элементов и сообщение "Выборка сохранена. Добавьте ваш следующий запрос (например, 'сравни их')".

Выбранные данные преобразуются в сжатый JSON с глубиной вложенности 10 уровней и сохраняются в переменной $selectionContextJson для использования в следующих запросах к AI.

Ведение истории

Каждая пара "запрос пользователя - ответ AI" сохраняется в файл истории в формате JSONL. Это обеспечивает непрерывность диалога - AI "помнит" весь предыдущий разговор и может ссылаться на ранее обсуждавшиеся темы.

Цикл продолжается

После обработки запроса система возвращается к ожиданию нового ввода. Если у пользователя есть активная выборка, это отражается в приглашении командной строки. Цикл продолжается до тех пор, пока пользователь не введет команду выхода.

Практический пример работы

Представим, что пользователь запускает скрипт и вводит "RTX 4070 Ti Super":

1. Подготовка контекста: Система берет системный промпт из файла, добавляет историю (пока пустую) и новый запрос

2. Обращение к AI: Полный промпт отправляется в Gemini с просьбой найти характеристики видеокарт

3. Получение данных: AI возвращает JSON с массивом объектов, содержащих информацию о различных моделях RTX 4070 Ti Super

4. Интерактивная таблица: Пользователь видит таблицу с производителями, характеристиками, ценами и выбирает 2-3 интересующие модели

5. Отображение выборки: В консоли появляется таблица с выбранными моделями, приглашение меняется на [Выборка активна]

6. Уточняющий запрос: Пользователь пишет "сравни производительность в играх"

7. Контекстный анализ: AI получает и исходный запрос, и выбранные модели, и новый вопрос - дает детальное сравнение именно этих карт

Завершение работы

При вводе exit или quit скрипт корректно завершается, сохранив всю историю сессии в файл. Пользователь может в любой момент вернуться к этому диалогу, просмотрев содержимое соответствующего файла в папке .chat_history.

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

Серия «Философия PowerShell»
Серия «gemini-cli»

Полезно? Подпишись.
Понравилось — ставь «+»
Задавай вопросы в комментариях 👇👇👇
Удачи! 🚀

Что делают AND и OR

• AND — «и». Все условия должны быть выполнены одновременно.
  Пример: выбрать из холодильника молоко и яйца, чтобы приготовить омлет:

SELECT *

FROM fridge

WHERE product = 'milk' AND product = 'eggs';

(Да, в реальности одной строки с молоком и яйцом не будет, но идея ясна: оба условия должны выполняться вместе.)

OR — «или». Достаточно, чтобы выполнено было хотя бы одно условие.
Пример: выбрать продукты, которые нужно купить или молоко, или яйца:

SELECT *

FROM shopping_list

WHERE product = 'milk' OR product = 'eggs';

Где могут использоваться

Эти операторы обычно используют в блоке WHERE, чтобы фильтровать данные.
Также можно применять их в:

• HAVING — фильтрация агрегатов после GROUP BY

• JOIN ON — комбинирование условий соединения таблиц

Пример с HAVING:

SELECT category, COUNT(*)

FROM fridge

GROUP BY category

HAVING COUNT(*) > 5 AND AVG(expiry_date) < '2025-08-01';

Особенности и нюансы:

• Порядок выполнения важен

  AND имеет более высокий приоритет, чем OR.

  Если смешиваете их, всегда используйте скобки для точного порядка:

  SELECT *

  FROM fridge

  WHERE (product = 'milk' OR product = 'eggs') AND expiry_date < '2025-08-01';

• AND «сжимает» результат, OR «расширяет» результат

  AND оставляет меньше строк, OR — больше

Частые ошибки

• Забыли скобки и получили слишком большой или слишком маленький результат

• Использовали AND там, где нужен OR (или наоборот)

• Смешали NULL значения: NULL AND TRUE и NULL OR TRUE могут вести себя неожиданно

Представим, что мама проверяет холодильник:

• У неё есть список продуктов, которые могут испортиться: молоко, яйца, йогурт

• Она хочет приготовить что-то, если и молоко, и яйца в наличии → AND

• Она хочет перекусить, если есть молоко или йогурт → OR

В SQL это выглядит так:

-- Для приготовления омлета

SELECT *

FROM fridge

WHERE product = 'milk' AND product = 'eggs';

-- Для перекуса

SELECT *

FROM fridge

WHERE product = 'milk' OR product = 'yogurt';

AND и OR — это простые, но мощные инструменты фильтрации. Правильное использование скобок и понимание приоритета операторов помогает избежать ошибок и выбирать точно те данные, которые нужны.