Ну что. Начнем проектировать интеграционный проект с мобильным приложением для сообществ (для старта - GetAnalyst).

Шаг 1. Определение компонентов системы

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

Так как мы проектируем задачу на интеграции, то нам необходимо выделять внутренние и внешние компоненты.

Внутренние - разрабатываются внутри ИТ-продукта, который является основным в нашей компании. То есть все, что связано с мобильным приложением для сообществ.
+ Мобильное приложение iOS
+ Мобильное приложение Android
+ Backend - сервер приложение (включает в себя БД)
+ Админка для модерации контента и управления системой

Внешние - те, которые мы подключаем к нашему ИТ-продукту, чтобы сделать его функциональность или набор данных шире.
+ Telegram (данные)
+ email-сервис (функциональность - подтверждение регистрации)
+ система сбора заявок
+ сервис push-уведомлений для Android
+ сервис push-уведомлений iOS
+ видеоплеер (библиотека внутрь мобильного приложения)

Что делать с этим списком? Первый подход к анализу требований 🙂

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

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

Telegram
1. Ввула в гугл запрос "telegram api документация", чтобы найти информацию по способу интеграции

2. По первой ссылке попала сюда https://core.telegram.org/ и начала разбираться с тем, что есть внутри.
Кажется "The Telegram API and TDLib allow you to build your own customized Telegram clients. You are welcome to use both APIs free of charge" как раз то, что мне нужно, потому что мне нужно получать и визуализировать информацию из телеграм-каналов.
Но когда начала смотреть внимательно, то оказалось, что я ошиблась. Мне нужна не библиотека для iOS и Android, а интеграция на мой сервер по API, через который будет загружаться весь контент, чтобы его могли модерировать и отправлять одно и то же на обе мобльные платформы.

3. Нашла API-документацию. И начала рабираться что внутри.

4. Для разработки мне нужен основной метод для получения всех сообщений из канала. После недолгих поисков по содержанию нашла Working with channels/supergroups/geogroups.

5. В нем оказался нужный мне метод channels.getMessages. И вопрос, который у меня сразу возник - а кто тестировтаь будет и как? 😉 Не очень на привычные SOAP, REST и GraphQL похоже.
Это библиотека. Так что для тестирования и проверок придется написать немного кода. Поэтому в зависимости от степени доверия поставщику API могу поставить задачу разработчику на тестирование API, и параллельно писать требования по документации. Не всегда надежно так делать, но программированием тоже не хочется заниматься.

6. Посмотрела инструкции по авторизации. Поняла, что надо будет зарегистрировать свое приложение и получить api-ключ.

На этом пока достаточно. Полезные ссылки собрала. Можно переходить к сервису email - Unisender. Собираем аналогичные вводные и пишем в комментарии 🙂

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

Когда я осознала, что понимание интеграций и API позволяет мне работать с любыми проектами и в любых командах, где иногда даже нет пользовательских экранов... Это был восторг! Понимание разработчиков перешло на новый уровень.

Есть различные подходы к проектированию интеграций. Их понимание позволяет легко отвечать на вопросы: интеграция в пользовательском приложении или на сервере и почему, по какому принципу можно делать backend на сервисы и микросервисы в зависимости от внешних систем, с которыми интегрируемся, как работают очереди сообщений... И много других деталей.

Узнать все это можно вместе со мной на практике за 10 прямых эфиров в течение 2-х месяцев 😉

👉 Программа "Проектирование интеграций"
🗓 До 15 МАЯ заполните анкету предзаписи, чтобы забронировать место на курсе по самым выгодным условиям.
Всего мест с практикой будет 10

Hard-skill по интеграциям - один из главных для системного аналитика. Моя цель - научть вас решать реальные практические задачи, и показать самые разные подходы к проектированию интеграций 🙌
🙌

Всем прекрасного старта выходных! И давайте я немного их разбавлю полезной информацией в видео-формате 😉

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

Цель любой системы - обеспечить информационный обмен. Хочется, чтобы он был надежным: данные не теряются, вовремя доставляются до соответствующих подсистем, и, в конечном счете, их получают пользователи.

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

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

Доставить и не потерять: синхронизация данных в распределенных системах

Презентация доступна по ссылке

Какие оригинальные имена в Zoom вы встречали? 🤔

За прекрасные картинку и настроение спасибо Анастасии (таланты в IT, Грузия) 🫶

Доброе утро!☀️

По вашим просьбам организуем повтор вебинара!

📹 Лайфхаки ChatGPT для аналитиков
⏰ 11:00-13:30 Мск

Подключайтесь по ➡️ ссылке

P.S. Воркшоп перенесен на 13 мая

❗️Начинаем через 15 минут❗️

📹 Лайфхаки ChatGPT для аналитиков
⏰ 11:00-13:30

Подключайтесь по ➡️ ссылке

Для меня новые задачи подобны приключениям. Я любитель глубоко погружаться в детали проектирования. Каждый раз при знакомстве с новой задачей я увлекаюсь и теряю счет времени.

Когда я получила свою первую в жизни API-документацию для создания интеграции, я поняла, что даже не представляю с чего начать. Внятных статей не было. Все, что находилось тогда в Интернете, было неструктурированно и непонятно - какие-то общие статьи, без конкретики и руководств к действию. Откладывала ее решение до последнего. Тот момент, когда погружаться вообще не хотелось. А зря. Эта задача могла на многое повлиять в архитектуре системы.

Я пыталась разобраться и состыковать всю информацию, что у меня была, но все равно не могла понять, как реализовать задачу. Интуитивно начала с того, что посмотрела на функции пользователей в нашей системе и начала их сравнивать с тем, что было в этой страшной и непонятной "азбуке". Умение читать код спасало при виде JSON. Структура примерно сразу стала понятна. Суть - нет.

Затем я просто состыковала методы из API-документации и нашу функциональность для пользователей и сформулировала задачи для разработчиков примерно так: "Cейчас пользователи получают данные только из нашей БД. А надо, чтобы данные подгружались и из внешней системы XXX. Смотри API-документацию. Метод GET /...".

Мои первые постановки задач на интеграции не были четкими и конкретными. Я просто скопировала методы из API-документации и все. Не было подхода, как правильно читать эту документацию.

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

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

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

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

Продолжим проектирование мобильного приложения сообщества. Нам там регистрация по email нужна, чтобы присылать подтвержления регистрации на почту и другие уведомления.

Как и в предыдущем случае с документацией телеграма мне нужно просто найти информацию по авторизации и метод отправки письма. Желательно со всякими картинками и ссылками. Явно какая-то HTML/CSS история будет 😀

1. Пошла в Google и с запросом API Unisender получила первой же ссылкой страницу с API-документацией Email-сервиса.

2. По ссылке начала последовательно знакомиться с заголовками разделов: В чем польза Unisender API, Быстрый старт, Принцип использования API,... И потом наконец дошла до "Список доступных методов". Содержание в левой стороне страницы меня немного напугало. Так как там еще и СМС. А мне только почта сейчас нужна. Листала осторожно.

3. Когда я перешла в раздел "Создание и отправка сообщений", то была немного в шоке. Минимум 10 методов на выбор! Но ничего. Тут тоже все легко. Ищу нужный мне createEmailMessage — создать email для рассылки и перехожу к документации на него.

Продолжение...👇

4. Внутри вижу красивый запрос:
https://api.unisender.com/ru/api/createEmailMessage?format=json&api_key=KEY&sender_name=FROMNAME&sender_email=
FROMMAIL&subject=SUBJECT&body=HTMLBODY &list_id=X&tag=
TAG&attachements=FILESARRAY&lang=LANG&wrap_type=STRING&text_body=
TEXTBODY&generate_text=GENERATETEXT &categories=CATEGORIES
Ответ в JSON:
{"result":{"message_id":357088}}
{"error":"unchecked sender email","code":"invalid_arg","result":""}
Ну и тело письма оказалось в формате HTML 😉
Обращение к методам API для email-рассылок — это HTTPS-запросы к URL.

5. Потом вернулась к началу документа и посмотрела информацию по авторизации. Она как правило в самом начале. Так и оказалось - она была в общем описании.
Пользоваться API можно бесплатно на любом аккаунте. Чтобы получить доступ к API для email-рассылок нужен ключ, который можно скопировать в личном кабинете.
Уже стандартная для меня тема.

6. На всякий случай посмотрела еще раз все методы на рассылку и, зная наши бизнес-процессы, взяла на заметку:
+ getLists — получить списки для рассылок с их кодами;
+ createList — создать новый список контактов;
+ createCampaign — запланировать массовую отправку email или SMS сообщения;
+ cancelCampaign — отменить запланированную ранее массовую рассылку;
+ deleteMessage — удалить сообщение;
+ updateEmailMessage — редактировать email для массовой рассылки.

Все ссылки сохранила. Нужные методы есть. Первичное исследование unisender - done ✅

Проектируем приложение для сообществ 🤝
Добрались до Push-уведомлений

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

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

2. Затем наш Backend, путем интеграции с серверами Google или Apple, отправляет уведомления на это устройство, используя этот идентификатор.

3. Когда устройство получает Push-уведомление, оно отображается на экране в виде уведомления. На него можно нажать для открытия приложения и просмотра подробной информации о событии. А можно удалить.


Получается, что надо интегрироваться с серверами Google и Apple, чтобы реализовать механизм push-уведомлений. Сразу две интеграции для одной фнкциональности. Но.. Нет! Я знаю классные инструменты.

На нескольких проектах мы успешно внедряли Firebase для отправки Push-уведомлений 💫

Firebase - это платформа от Google, которая предоставляет инструменты для разработки мобильных и веб-приложений.

Firebase имеет функцию Cloud Messaging, которая позволяет разработчикам отправлять push-уведомления на разные устройства, в том числе iOS и Android. Интеграционное решение для тех, кто не хочет иметь мгого головной боли с реализацией Push-уведомлений.

Для использования Firebase нужно зарегистрироваться на платформе, создать проект и добавить Firebase SDK в своё приложение.

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

Еще одним примером SDK, кроме Firebase, может быть Facebook SDK, который позволяет разработчикам взаимодействовать с социальной сетью Facebook в своих приложениях. Facebook SDK включает в себя инструменты для аутентификации пользователей, отправки уведомлений, получения данных профиля и т.д.

Использование SDK позволяет разработчикам сократить время и затраты на разработку приложений, так как они могут использовать уже готовые инструменты, а не писать все с нуля 🪄

Разбираюсь с документацией SDK на Firebase 👀

Firebase Cloud Messaging предоставляет API-интерфейс для отправки уведомлений. Для отправки уведомлений через API необходимо использовать HTTP-запросы.

Документация по API Firebase Cloud Messaging:
По отправке сообщений:
https://firebase.google.com/docs/cloud-messaging/send-message
По токенам устройства:
https://firebase.google.com/docs/cloud-messaging/android/client#access-the-registration-token

Для отправки уведомления нужно использовать метод POST и отправить запрос на адрес "https://fcm.googleapis.com/fcm/send". В теле запроса необходимо указать JSON-объект с параметрами уведомления, такими как заголовок, текст и т.д. Также нужно указать идентификатор устройства, на которое отправляется уведомление.

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

Это все документация для программистов сервера. Но и для своих iOS и Android разработчиков я тоже нужные разделы зацепила.

В проектировании для push-уведомлений есть много нюансов. Но первичная информация по аналитике собрана. Уведомления сможем доставить по классному Firebase. Я рада. Можно двигаться дальше 🚀

В завершение - про систему заявок

Для старта нам будет достаточно интеграции с Telegram-ботом и с email-сервисом - метод для поплнения списка контактов.

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

Так что считаем, что первый подход к сбору данных по документации мы завершили.

✅ Найти API-документацию для каждого из внешних сервисов, а если необходимо, то и для внутренних

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

Сегодня одним из трендовых направлений является искусственный интеллект, в частности ChatGPT. Он может помочь при проектировании интеграций, предоставляя доступ к большому количеству знаний и опыта. Но чтобы правильно его применить и не допустить ошибки, важно знать правильные команды и на какие нюансы стоит обращать внимание.

Чтобы использовать ChatGPT в проектировании интеграций есть команды на естественном языке. Например: "Как произвести интеграцию между системами X и Y?", "Какие методы автоматизации интеграций существуют?" и т.д.
ChatGPT будет анализировать эти вопросы и давать ответы, основанные на доступных ему знаниях.
Важно! Уточнять когда важно получать актуальные данных на 2023 год.

Кстати, ChatGPT может использоваться и для обучения системных аналитиков. Он может помочь в изучении новых технологий, понимании принципов работы различных систем и инструментов, а также в решении сложных технических проблем. Попробуйте самостоятельно вместе с ним поизучать важные для нас Postman и Swagger.

Использование ChatGPT в проектировании интеграций позволяет системным аналитикам быстро получать необходимую информацию и повышать свой профессиональный уровень. Это помогает оставаться конкурентоспособными и успешными в быстро меняющемся мире 🙌

Upd для тех, кто связан с РФ:
Блокируют учетки! Если вы случайно попробуете открыть ChatGPT без VPN, то с учеткой можно прощаться. Чтобы восстановить - создайте новую гугл-почту (не нужно подтверждать телефоном) и заново пройдите регистрацию в ChatGPT, чтобы создать новую. Все делать под VPN.

Бизнес-процессы AS IS. Как подойти к задаче?

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

Поэтому я собираюсь пройтись еще раз по списку процессов, которые должно покрывать приложение в MVP. Я всегда стараюсь следовать логической последовательности. Сразу делаю пометки по альтернативным сценариям (они будут отмечены *).


Общие инструкции по описанию бизнес-процессов AS IS:

1. Выделите логические модули в системе: вебинары, контент и т.д.

2. Для каждого логического модуля опишите последовательность задач, которые должен выполнить пользователь. Если последовательности нет, то просто перечислите их. Например, для модуля вебинары: регистрация, отправка письма с подтверждением о регистрации, отправка письма с напоминанием, отправка письма со ссылкой на вебинарную комнату и далее.

3. Проверьте каждую выписанную задачу (процесс) - можно ли ее разделить на еще более мелкие процессы с четким началом и результатом. Если нет, то переходите к следующему шагу.

4. Для каждого выписанного процесса задайте себе вопросы: "Что может пойти не так? Что еще может захотеть сделать пользователь будущей системы?". Запишите идеи. Тут, кстати, может помочь ChatGPT 😉

5. Список процессов готов. Теперь можно детально описывать каждый процесс в формате AS IS. Если AS IS не существует, то отметьте это. Для нас аналитиков важно не навредить процессам AS IS, а только сделать их лучше! С интеграционными задачами это особенно важно.


Сохраняйте себе этот пост в избранное и делитесь с коллегами, которые только начинают путь в аналитике 🚀

Коллеги, сегодня в 17:00 Мск проведем последний повтор бесплатного онлайн-практикума

📹 Лайфхаки ChatGPT для аналитиков
Нефункциональные требования
и проектирование архитектуры
🗓 11 мая в 17:00 (Мск)
👉 Регистрация здесь

В программе:
01 Возможности применения ChatGPT в работе аналитиков
02 Команды для разработки нефункциональных требований
03 Поиск и анализ решений при проектировании архитектуры систем
Обзор возможностей и подсказки по "подводным камням"!

А также напоминаю, что с майских праздников перенесли воркшоп
🤖 Проектирование архитектуры и постановка задач на Интерации с помощью chatGPT
🗓 на эту субботу, 18:00 Мск
‼️ Маленькая группа на 10 человек, следующий воркшоп в июле

Собирайте лайфхаки и внедряйте в свою работу, чтобы быть на шаг впереди и начать использовать искусственный интеллект в своей работе!

До встречи 😉

Бизнес-процессы AS IS для мобильного приложения сообщества GetAnalyst

Получение контента
1. Через Telegram-канал GetAnalyst для опытных аналитиков
2. Через Telegram-канал GetAnalyst для начинающих аналитиков
3. Чтение блога GetAnalyst на сайте
4. Через другие Telegram-каналы для аналитиков
5. Habr-статьи по определенным темам для аналитиков (РУ)
6. Reddit.com статьи по определенным темам для аналитиков (ENG)
7. YouTube GetAnalyst (и другие каналы)
8. Instagram GetAnalyst

Ведение списка контактов
1. Сбор контактов при регистрациях на вебинары. Информация попадает в Битрикс24, Telegram-бот сайта, Email-лист контактов.
2. Участники Telegram-каналов GetAnalyst
3. Участники YouTube-каналов GetAnalyst
4. Сбор контактов при обращении по вопросам обучения

Вебинары
1. Публикация анонса в Telegram-каналах
2. Рассылка анонса через Email
3. Передача ссылок на вебинарные комнаты
4. Выдача подарков на вебинарах

Уведомления о событиях по Email / в Telegram GetAnalyst
1. Приглашения на бесплатные вебинары
2. Напоминания о бесплатных вебинарах
3. Передача ссылок на вебинарные комнаты

Вакансии (пока не уверена, что будем добавлять в MVP, но очень полезное)
1. Через Telegram-каналы
2. HH.ru (Россия и СНГ)
3. LinkedIn.com (Мир)

Администрирование ведется через приложения соответствующих систем вручную.

Многое автоматизировано, но многое также требует доработки, над чем мы сейчас постепенно работаем. Мобильное приложение - один из путей развития сообщества GetAnalyst 🙌

А вот этот объем бизнес-процессов AS IS предстоит описать 😃

❗️Начинаем через 15 минут❗️

📹 Лайфхаки ChatGPT для аналитиков
⏰ 17:00-19:30

Подключайтесь по ➡️ ссылке