Инженер базы знаний по открытым API

• *Ценность роли:**

Построение, развитие и автоматизация Базы Знаний и MVP Портала Разработчика. Создание автоматизированной и масштабируемой платформы для внутренних и внешних участников. Полная ответственность за сопровождение жизненного цикла документации: от системной автоматизации (Docs-as-Code, Spec-as-Code) до финальной редакторской вычистки, верстки и сборки безупречных артефактов для передачи на Экспертный Совет, в Банк России.

Ключевое взаимодействие:

• *1) С Руководителем (Владельцем стандартов):** Оперативная синхронизация по приоритетам, превращение бизнес, нормативных требований в понятный технический бэклог развития Базы Знаний и платформы.

2) С Архитекторами: Совместное проектирование экосистемы для поддержки API-контрактов, моделей данных, структуры OpenAPI-спецификаций, правила валидации и тестов.
3)С системными и бизнес-аналитиками: Поддержка единых шаблонов, стандартизация описаний, автоматическая генерация документации в целевых форматах (HTML, MD, DOCX, PDF).
4) С руководителем проектов: размещение необходимых гайдов, инструкций, материалов по требованиям участников пилота.

• *Основные обязанности и зоны ответственности1. Автоматизация CI/CD и инфраструктура документации (Docs-as-Code)**

• Развитие и поддержка подходов Docs-as-Code& Spec-as-Code: проектирование и настройка автосборки, валидации и публикации документации/спецификаций через Git / CI/CD pipelines.

• Автоматизация контроля качества (автоматическая проверка синтаксиса OpenAPI/AsyncAPI, линтинг, проверка ссылок, структуры и верстки).

• Настройка и поддержка генераторов документации (Swagger/Redoc, Static Site Generators — MkDocs/Docusaurus/Hugo/Backstage, Pandoc/AsciiDoc). Поддержка инструментов OpenAPI CLI, Redocly, PlantUML/Mermaid.

• Интеграция Базы знаний с реестрами компонентов, API-шлюзами и внешними порталами.

• *2. Архитектура и управление Базой Знаний**

• Проектирование и развитие целевой структуры внутренней и внешней Базы Знаний (стандарты открытых API, навигация, онбординг, FAQ, гайды, архитектурные принципы, обучающие материалы, материалы для команды и прочее).

• Поддержание и развитие документации по OpenAPI на обзорном, функциональном, техническом и бизнес-уровнях.

• Создание и поддержание единого понятийного аппарата: глоссарии, справочники, единые профили спецификаций и шаблоны.

• Построение процессов управления жизненным циклом контента (актуализация, депрекация, версионирование, релиз-менеджмент).

• Автоматизация сбора обратной связи от пользователей экосистемы (разработчиков, аналитиков, участников рынка) для непрерывного улучшения Базы Знаний.

• *3. Системный контроль качества**

• Разработка и внедрение правил, регламентов и Style Guides (по неймингу, проектированию и документированию API).

• Полная предрелизная проверка спецификаций и технических стандартов (структура, орфография, пунктуация, верстка, единообразие, консистентность полей и реестров).

• Финализация и подготовка эталонных комплектов: вычистка, верстка и сборка итоговых нормативных пакетов материалов перед передачей руководителю, Экспертному совету, Банку России и внешним участникам рынка. (сведение правок, таблицы соответствий и версий, релиз-ноутсы).

• Автоматизированный аудит консистентности и качества артефактов (структура, бизнес- и технические слои, реестры).

• Настройка аналитики и метрик Базы знаний (полнота, актуальность, частота обращений, узкие места).

1. MVP Портала Разработчика

• Метамодель и Каталог (e-Catalog): Поддержка структурированной метамодели (сущности, атрибуты, descriptor-файлы) и единого каталога всех проектов, API и компонентов.

• Трассируемость и Граф связей: Настройка и поддержка сквозного графа зависимостей (Нормативное требование → OpenAPI-операция → Правило валидации → Архитектурный компонент → Тест-кейс).

• Quality Gates & CI/CD: Автоматизация проверок в пайплайнах (линтер OpenAPI, валидация JSON Schema, проверка уникальности ID, поиск битых ссылок и незакрытых требований).

• Управление версионированием : Сборка, валидация и управление версионными срезами платформы (Baseline), проведение анализа влияния изменений (Impact Analysis).

• *Hard Skills**

• Docs-as-Code & CI/CD: Уверенное владение Git (стратегии ветвления, PR/MR, тэгирование релизов).

• Отличное владение: Markdown, YAML, HTML/CSS, опыт работы с Pandoc / AsciiDoc для генерации точных PDF/Word документов.

• Опыт настройки CI/CD процессов (GitLab CI, GitHub Actions или аналоги) для валидации и автопубликации контента.

• Понимание работы генераторов статических сайтов (MkDocs / Docusaurus / Hugo / Antora/ Backstage) и инструментами Swagger/Redoc.

• API & Форматы данных: Глубокое понимание спецификаций OpenAPI (Swagger), AsyncAPI, JSON Schema, YAML/JSON.

• Понимание базовых принципов REST, event-driven архитектуры и интеграционных стандартов.

• Опыт работы с линтерами спецификаций (Redocly CLI, Spectral или аналоги).

• Опыт разработки и ведения регламентов, методологии и Style Guides по документированию API.

• Инженерия знаний и работа с контентом: Навыки архитектуры информации (Information Architecture) — умение логически структурировать сложнейшие технические домены.

• Базовые навыки программирования (Python, TypeScript/Node.js или Go) для написания кастомных скриптов сборки, парсеров и валидаторов.

• Желателен опыт работы с инструментом визуализации (PlantUML, Mermaid, Structurizr, C4 model).

• *Soft Skills**

• Инженерный подход и стремление к автоматизации: поиск способов автоматизировать проверки и рутинные сборки.

• Исключительная внимательность к деталям и аккуратность

• Системность и продуктовое мышление: Восприятие Базы Знаний и Стандартов как внутреннего продукта, оценка его удобства для инженеров и бизнеса (Developer Experience).

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

• Способность агрегировать требования и правки от директора, руководителя, архитекторов, аналитиков, руководителя проектов, участников пилотов, приводя их к единому стандарту

• *Условия:**

• заработная плата от 300 000 гросс

• годовой бонус

• ДМС после испытательного срока

• гибрид (один день в офисе)

• масштабный уникальный проект в финансовой отрасли

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