Системный аналитик

🔼 Workflow-движок Workflow-движок — система, которая управляет выполнением последовательности шагов (задач) по описанной логике процесса: 🔹 какие действия выполняются, в каком порядке, кто за них отвечает и какие условия переходов между шагами Нужен, когда в системе есть повторяющиеся, формализованные процессы: состоящие из нескольких этапов с предсказуемыми переходами и условиями ▶️Реализует паттерн оркестрации Как работает Компоненты: *️⃣ модель процесса: описание шагов, условий, участников и маршрутов форматы: BPMN, JSON, YAML, собственные DSL *️⃣ движок исполнения: интерпретирует модель, управляет выполнением шагов *️⃣ хранилище состояния процессов (активные задачи, контекст данных) *️⃣ интерфейс взаимодействия: API или UI для запуска, мониторинга и управления процессами *️⃣ исполнители (workers): внешние сервисы / люди, выполняющие задачи Принцип: 🔸описывается процесс 🔸движок интерпретирует модель, создаёт экземпляр процесса 🔸каждый шаг выполняется человеком / системой 🔸движок отслеживает статус и двигает процесс дальше по маршруту Типовой цикл: 1. запуск — процесс стартует по событию или API-запросу 2. исполнение — движок выполняет шаги, проверяет условия переходов 3. ожидание — если требуется ввод данных пользователем или внешним сервисом 4. завершение — финальный статус, логирование результатов Примеры ➡️ согласование документов (HR, закупки, договоры) ➡️ автоматизация CI/CD (деплой по цепочке шагов) ➡️ маршрутизация заказов между системами ➡️ оркестрация микросервисов — последовательный вызов нескольких API В архитектуре 🔹 клиент / внешняя система инициирует процесс через API 🔹 workflow-движок получает запрос, создаёт экземпляр процесса 🔹 для каждого шага движок вызывает нужный сервис (REST, gRPC, очередь сообщений) 🔹 после завершения шага обновляет состояние и двигается к следующему 🔹 все статусы сохраняются в базе состояний, откуда можно извлечь историю / отчётность Когда использовать ➡️процесс состоит из нескольких акторов или систем ➡️нужно контролировать последовательность шагов и статусы ➡️процесс должен быть управляемым и наблюдаемым (SLA, ретраи) ➡️логику нужно менять без перекомпиляции кода (например, через модели BPMN или YAML) Не стоит использовать: ➖ процесс слишком простой (один-два шага) ➖ бизнес-логика часто меняется и неформализуема Workflow vs. BPM 🟢 Workflow-движок исполняет процессы 🟡 BPM-платформа управляет ими в широком смысле — моделирует, оптимизирует, анализирует 📌Часто BPM-платформы включают внутри себя workflow-движок как исполнительный слой Примеры ПО ➖ Temporal ➖ n8n ➖ Camunda ➖ OpenBPM Engine 📎 Материалы 1. Workflow Core — движок бизнес-процессов для .Net Core 2. Как мы делали свой движок Workflow 3. Интеграция с «Госуслугами». Применение Workflow Core (часть II) 4. Интеграционная платформа в The Platform: что умеет, как работает и зачем ей Workflow Engine #интеграции ➿➿➿➿➿➿➿➿ 🧑‍🎓 Больше полезного в базе знаний по системному анализу

NocoBase — платформа, которая ломает шаблон low/no-code 💻 Присоединяйтесь к сообществу @nocobase_ru и забудьте о конструкторах, где всё ограничено таблицами и формами. 💡 NocoBase работает на основе модели данных, а значит вы можете: • подключать свои базы или API, объединяя данные в одной системе • настраивать страницы как в Notion, но с реальной бизнес-логикой • решать 80% задач без кода, а остальные — через плагины и кастомные сценарии • масштабировать от стартапа до корпоративного уровня • open source — всё прозрачно и безопасно Скоро: AI-сотрудники в NocoBase. Встраивайте ИИ прямо в интерфейсы и процессы, создавайте переводчиков, аналитиков и помощников под свои задачи. 🔗 Попробуйте NocoBase и соберите свою систему за вечер Подписывайтесь на телеграм-канал, чтобы быть в курсе всех обновлений и получать быстрые ответы от официальной команды @nocobase_ru #nocobase #lowcode #nocode #opensource #ai #it

Изучаем DDD — предметно-ориентированное проектирование ✍️ Автор: Влад Хононов 🗓 Год издания: 2024 🔤 Язык: русский 📚 Объём: 320 стр. Книга посвящена методологии DDD (предметно-ориентированному проектированию), что особенно актуально в условиях дробления предметных областей и усложнения бизнес-взаимодействий. Рассказано 🔹как оценить масштаб и сложность предметной области (с примерами анализа предметной обалсти) 🔹измерить темпы ее развития, учесть необходимые зависимост 🔹про архитектурные паттерны и паттерны взаимодействия, EventStorming, SOA, Data Mesh 🔹применять DDD и структурировать создаваемое ПО эффективно вписывая его в сеть данных (Data Mesh) 🔹о порядке развития проекта синхронно с изменениями в его бизнес-контексте Знание принципов и шаблонов предметно-ориентированного проектирования будет полезно инженерам-программистам всех уровней: младшего, старшего, штатного и руководящего. 🔹 Пост про DDD 📺 Интервью с автором Learning Domain-Driven Design • Влад Хононов #архитектура #проектирование

Траты, которые окупили себя в моей IT-жизни Твоему вниманию — честная, местами поучительная история Алексея, который: ▪️перешел на новую работу системным аналитиком с 30% ростом по зарплате; ▪️начинал смотреть курс с фразой «ну эта фингя и так в интернете есть»; ▪️а сейчас кайфует от работы, зарплаты и чувствует уверенность в своих hard-знаниях. ⠀ Что было между этими точками? API. Курс про архитектуру и интеграции. Смирение. Мотивация и два часа времени в выходной. ⠀ Читай историю Алексея на карточках — возможно, узнаешь в ней себя. Или смотри запись огненного и мотивирующего интервью с Алексеем, рекомендую. ⠀ А, если охота менять карьеру к лучшему, — лови возможности. Бесплатные уроки по архитектуре и интеграциям в чат-боте курса. Доступ не забирают. Переходите и знакомьтесь. @studyit_help_bot 👈 🚀 Скидка на полный курс от канала — 1 500₽ на Stepik по промокоду EFIR3 до конца ноября.

✔️ Советы по проектированию REST API 1. Использовать множественное число для коллекций ✅

    
        GET /products
GET /products/{product_id}{}
    

❌

    
        GET /product/{product_id}{}
    

2. Не добавлять лишние сегменты в путь ✅

    
        GET /v3/application/listings/{listing_id}{}
    

❌

    
        PATCH /v3/application/shops/{shop_id}/listings/{listing_id}{}
    

Не пытаться отразить всю модель данных в URL Если listing_id уникален — shop_id не нужен 💙 Исключение: если ключ действительно составной

    
        GET /listings/{listing_id}/options/{option_id}{}
    

3. Не добавлять расширения в URL ❌ GET /users.json Формат передачи должен определяться через HTTP-заголовки (например, Accept) , не через URL ✅ GET /users и HTTP-заголовки настройка заголовков:

    
        Accept: application/json{}
    

4. Не возвращать массивы верхнего уровня Объект позволяет легко добавить пагинацию и дополнительные поля без поломки обратной совместимости ❌

    
        [{"id":1}, {"id":2}]{}
    

✅

    
        { "data": [{"id":1}, {"id":2}] }{}
    

5. Не возвращать структуры-словари (map) Словари ломают совместимость и неудобны для типизированных языков. 💙 Исключение: простые пары ключ: значение (например, metadata) ✅

    
        { "data": [{ "id":"KEY1" }, { "id":"KEY2" }] }{}
    

❌

    
        { "KEY1": {...}, "KEY2": {...} }{}
    

6. Добавлять префиксы к ID Помогает отличать типы сущностей и уменьшает путаницу при поддержке Примеры:

    
        Stripe: in_1MVpWEJVZPfyS2HyRgVDkwiZ
Shopify: gid://shopify/FulfillmentOrder/1469358604360{}
    

7. Не использовать 404 для “не найдено” ❌ 404 Not Found может означать сетевую ошибку или неверный URL 🟣может быть возвращен прокси, балансировщиком нагрузки и т.д. 🟣не позволяет клиенту отличить "ресурс не существует" от "ошибка конфигурации" ✅ Использовать, например, 410 Gone — сервер понял запрос, но объекта нет 8. Ошибки в структурированном формате Позволяет передавать цепочку ошибок и упрощает отладку ✅

    
        {
  "message": "Access denied",
  "type": "Unauthorized",
  "types": ["Unauthorized", "Security"],
  "cause": { ... }
}{}
    

9. Идемпотентность операций Идемпотентность = повтор вызова не меняет результат ✅ 🔹 GET, PUT, DELETE — по определению идемпотентны 🔹 Для POST добавлять идемпотентный ключ: клиент отправляет уникальный ключ в заголовке или теле, а сервер проверяет его уникальность

    
        POST /orders
Idempotency-Key: abc123{}
    

Если запрос повторится — сервер вернёт 409 CONFLICT и ID уже созданного ресурса:

    
        { "message": "Duplicate", "old_id": "ORD123" }{}
    

Клиент уверен, что заказ не задублировался 10. ISO8601 для даты и времени А также использовать ISO8601 для интервалов и длительностей ✅ "2023-12-21T11:17:12.34Z" ❌ "1703157432340" 🔹ISO8601 человеко-читаем 🔹поддерживается всеми библиотеками 🔹работает в UTC #api ➿➿➿➿➿➿➿➿ 🧑‍🎓 Больше полезного в базе знаний по системному анализу

Сборник знаний по бизнес/системной аналитике 📚 В нем ведущий бизнес-аналитик из Wildberries раскрыл: — Кто такой аналитик, чем он занимается на проектах, какими инструментами пользуется — Как правильно собирать и оформлять требования, чтобы тебе не приходилось это гуглить на первой работе — Как использовать SQL, BPMN и REST API без технического бэкграунда — Что такое базы данных, как их проектировать в работе Все с готовыми конспектами, видеоуроками и статьями. Мастхэв для начинающих и действующих аналитиков. 👉 забрать сборник по аналитике