Update documentation and code snippets

docs/root/quickstart.rst

@@ -23,6 +23,14 @@
    :language: python
    :linenos:
 
+**Запуск**
+
+Сохраните код в файл (например, ``main.py``) и запустите:
+
+.. code-block:: shell
+
+    python main.py
+
 **Результат**
 
 .. image:: https://i.ibb.co/35q24Bh8/image.png
@@ -30,10 +38,30 @@
    
 -----
 
-Более сложный пример: Менеджер задач
+Промежуточный пример: Калькулятор с флагами
+--------------------------------------------
+
+Прежде чем перейти к сложному примеру с ``di``, рассмотрим промежуточный вариант — калькулятор, который использует флаги для управления поведением.
+
+.. literalinclude:: ../code_snippets/quickstart/calculator_app.py
+   :language: python
+   :linenos:
+
+**Использование:**
+
+.. code-block:: shell
+
+   calc --a 10 --b 5 --operation add    # Result: 15.0
+   calc --a 10 --b 5 --operation mul    # Result: 50.0
+
+Этот пример показывает, как работать с флагами без использования ``di``. Теперь перейдём к более сложному примеру.
+
+-----
+
+Сложный пример: Менеджер задач с ``di``
 --------------------------------------
 
-В этом руководстве мы создадим простое, но полнофункциональное CLI-приложение «Менеджер задач», которое продемонстрирует ключевые возможности Argenta.
+В этом руководстве мы создадим полнофункциональное CLI-приложение «Менеджер задач», которое продемонстрирует работу с внедрением зависимостей.
 
 1. **Установка**