update state, api, arch

docs/state-managers/05-apollo-graphql.md

@@ -2,4 +2,43 @@
 sidebar_position: 5
 ---
 
-# Apollo graphql
+# Apollo graphql
+
+**Apollo Client** — это мощная библиотека для работы с GraphQL в React-приложениях. Она предоставляет инструменты для выполнения запросов, управления состоянием, кэширования данных и интеграции с UI. Apollo Client упрощает взаимодействие с GraphQL API, делая процесс разработки более эффективным и удобным.
+
+## Основные возможности Apollo Client:
+1. **Выполнение GraphQL-запросов:**
+   - Apollo Client позволяет легко выполнять запросы (**queries**), мутации (**mutations**) и подписки (**subscriptions**).
+2. **Кэширование:**
+   - Встроенный кэш нормализует данные и автоматически обновляет UI при изменении данных.
+3. **Интеграция с React:**
+   - Apollo Client предоставляет хуки (например, `useQuery`, `useMutation`) для удобной работы с GraphQL в функциональных компонентах.
+4. **Поддержка TypeScript:**
+   - Apollo Client полностью поддерживает TypeScript, что делает его удобным для типизированных проектов.
+5. **Инструменты разработчика:**
+   - Apollo DevTools позволяют отслеживать запросы, кэш и производительность.
+6. **Реактивность:**
+   - Apollo Client автоматически обновляет компоненты при изменении данных.
+
+## Преимущества Apollo Client:
+1. **Удобство:**
+   - Apollo Client предоставляет простой и интуитивно понятный API для работы с GraphQL.
+2. **Кэширование:**
+   - Встроенный кэш автоматически обновляет UI при изменении данных.
+3. **Интеграция с React:**
+   - Хуки (useQuery, useMutation, useSubscription) делают работу с GraphQL в React очень удобной.
+4. **Поддержка TypeScript:**
+   - Apollo Client полностью поддерживает TypeScript.
+5. **Инструменты разработчика:**
+   - Apollo DevTools позволяют отслеживать запросы, кэш и производительность.
+
+## Недостатки Apollo Client:
+1. **Размер бандла:**
+   - Apollo Client добавляет дополнительный вес в бандл приложения.
+2. **Сложность для простых сценариев:**
+   - Для небольших проектов Apollo Client может быть избыточным.
+
+## Когда использовать Apollo Client?
+- Если ваше приложение использует GraphQL API.
+- Если требуется кэширование данных и автоматическое обновление UI.
+- Для сложных приложений с множеством запросов и мутаций.