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

Ассоциаций развития финансовых технологий открывает новую вакансию в Центре компетенций по открытым API. База Знаний АФТ- wiki.opendatarussia.ru

Ценность роли:
Построение, развитие и автоматизация Базы Знаний и 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).
• Полная предрелизная проверка спецификаций и технических стандартов (структура, орфография, пунктуация, верстка, единообразие, консистентность полей и реестров).
• Финализация и подготовка эталонных комплектов: вычистка, верстка и сборка итоговых нормативных пакетов материалов перед передачей руководителю, Экспертному совету, Банку России и внешним участникам рынка. (сведение правок, таблицы соответствий и версий, релиз-ноутсы).
• Автоматизированный аудит консистентности и качества артефактов (структура, бизнес- и технические слои, реестры).
• Настройка аналитики и метрик Базы знаний (полнота, актуальность, частота обращений, узкие места).

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

• Метамодель и Каталог (e-Catalog): Поддержка структурированной метамодели (сущности, атрибуты, descriptor-файлы) и единого каталога всех проектов, API и компонентов.
• Трассируемость и Граф связей: Настройка и поддержка сквозного графа зависимостей (Нормативное требование → OpenAPI-операция → Правило валидации → Архитектурный компонент → Тест-кейс).
• Quality Gates & CI/CD: Автоматизация проверок в пайплайнах (линтер OpenAPI, валидация JSON Schema, проверка уникальности ID, поиск битых ссылок и незакрытых требований).
• Управление версионированием : Сборка, валидация и управление версионными срезами платформы (Baseline), проведение анализа влияния изменений (Impact Analysis).

Hard Skills

1. Docs-as-Code & CI/CD:
   1. Уверенное владение Git (стратегии ветвления, PR/MR, тэгирование релизов).
   2. Отличное владение: Markdown, YAML, HTML/CSS, опыт работы с Pandoc / AsciiDoc для генерации точных PDF/Word документов.
   3. Опыт настройки CI/CD процессов (GitLab CI, GitHub Actions или аналоги) для валидации и автопубликации контента.
   4. Понимание работы генераторов статических сайтов (MkDocs / Docusaurus / Hugo / Antora/ Backstage) и инструментами Swagger/Redoc.
2. API & Форматы данных:
   1. Глубокое понимание спецификаций OpenAPI (Swagger), AsyncAPI, JSON Schema, YAML/JSON.
   2. Понимание базовых принципов REST, event-driven архитектуры и интеграционных стандартов.
   3. Опыт работы с линтерами спецификаций (Redocly CLI, Spectral или аналоги).
   4. Опыт разработки и ведения регламентов, методологии и Style Guides по документированию API.
3. Инженерия знаний и работа с контентом:
   1. Навыки архитектуры информации (Information Architecture) — умение логически структурировать сложнейшие технические домены.
   2. Базовые навыки программирования (Python, TypeScript/Node.js или Go) для написания кастомных скриптов сборки, парсеров и валидаторов.
   3. Желателен опыт работы с инструментом визуализации (PlantUML, Mermaid, Structurizr, C4 model).

Soft Skills

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

Условия:

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

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

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

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

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

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