savinmi.ru

Резюме Михаила Савина (Lead SRE) в виде статического сайта: опыт, навыки, проекты, образование, награды, интересы. Собирается Astro, деплоится на GitHub Pages, живёт на своём домене.

Стек

• Astro 7 — статический сайтогенератор
• Markdown — контент страниц (src/pages/*.md)
• mishka-ds — дизайн-система «Мишка на сервере»: цвет, шрифты, шкала, печать
• Чистый CSS, без JS-фреймворков; единственный inline-скрипт — переключатель темы
• bun — зависимости, запуск и сборка
• make — раннер локальных команд, они же используются в CI
• markdownlint-cli2 — линт контента
• GitHub Actions + GitHub Pages — сборка и деплой

Структура

• src/pages/ — страницы резюме (index, experience, skills, projects, education, awards, interests, privacy) и кастомная 404.astro
• src/layouts/Page.astro — общий layout: head/meta, шрифты, переключатель темы (light/system/dark), Яндекс.Метрика
• src/components/ — Header.astro, Footer.astro, Seo.astro
• src/data/person.ts — единый источник профилей и данных о сущности (футер + JSON-LD)
• src/styles/global.css — локальный слой поверх дизайн-системы: профиль, шапка, подвал, контентные страницы
• vendor/mishka-ds/ — сабмодуль дизайн-системы, из него приезжают токены, шрифты и печатный слой
• public/ — статика: img/, pdf/, robots.txt, CNAME, ключ IndexNow
• astro.config.mjs — конфиг Astro (site, trailingSlash: always, sitemap, remark-deflist)
• Makefile — локальные команды
• scripts/bun-dependency-snapshot.mjs — снапшот дерева зависимостей для GitHub
• .github/workflows/ci.yml — весь пайплайн
• .markdownlint.yaml — правила линтера

Дизайн-система

Цвет, шрифты, типографическая шкала, ритм, reset и печатный слой приходят из mishka-ds — сабмодуль в vendor/mishka-ds. Своих значений сайт не объявляет: в src/styles/global.css любой цвет и размер — это var() на токен. Правка палитры делается в пакете, а не здесь.

Пакета нет в npm, а собранный CSS в его репозитории не коммитится, поэтому он собирается своим npm перед сборкой сайта — это делает make ds, от которого зависят make dev и make build. Импортное имя @jtprogru/mishka-ds/styles.css держится алиасом в astro.config.mjs: зависимость file: bun копирует в node_modules, и копия протухала бы при каждой пересборке пакета.

Сборка пакета гоняет проверку контрастов. Если правка токенов уронила пару ниже WCAG AA, сайт не соберётся — так и задумано.

Старые имена токенов (--rule, --link, --primary, --font-text) продолжают работать через compat.css пакета. Переезд на канонические (--border, --accent, --font-sans) — отдельный шаг.

Локальная разработка

Требуется bun 1.3+, Node.js 24+ (для сборки дизайн-системы) и make.

git clone --recurse-submodules https://github.com/jtprogru/savinmi.ru.git

Если репозиторий уже склонирован без сабмодулей — git submodule update --init --recursive; make сделает это сам, когда vendor/mishka-ds пуст.

make                     # список целей
make install             # зависимости
make ds                  # собрать дизайн-систему из сабмодуля
make dev                 # dev-сервер на :4321
make build               # сборка в ./dist
make preview             # предпросмотр прод-сборки
make lint                # markdownlint
make check               # линт и сборка
make dependency-snapshot # дерево зависимостей в dependency-snapshot.json
make clean               # удалить ./dist, ./.astro, снапшот и dist дизайн-системы
make distclean           # то же плюс оба ./node_modules

Порт переопределяется переменной: make dev PORT=3000.

Зависимости переустанавливаются только когда package.json или bun.lock новее node_modules. В CI (CI=true) установка идёт с --frozen-lockfile.

Обновить дизайн-систему до свежего коммита: git -C vendor/mishka-ds pull origin main и закоммитить сдвинувшийся указатель сабмодуля.

SEO и индексация

• src/components/Seo.astro собирает связный JSON-LD-граф (Person, WebSite, ProfilePage/WebPage, Organization, BreadcrumbList) — данные берутся из src/data/person.ts, чтобы футер и разметка не расходились.
• @astrojs/sitemap генерирует sitemap-index.xml с lastmod, changefreq и приоритетами; PDF-резюме добавлено отдельной customPages.
• public/robots.txt явно разрешает AI-краулеры (OAI-SearchBot, PerplexityBot, ClaudeBot и другие).
• После каждого деплоя CI пингует IndexNow — Яндекс и Bing переобходят быстрее, чем по расписанию sitemap. Ключ по протоколу публичный и лежит в public/<key>.txt.
• Страница 404 закрыта от индексации через noindex.

CI/CD

Push в main (или workflow_dispatch) запускает .github/workflows/ci.yml:

job	что делает
lint	make lint — markdownlint по src/pages/*.md и README.md
dependency-graph	make dependency-snapshot и отправка дерева через Dependency Submission API
build	checkout с сабмодулями, make build (собирает дизайн-систему и сайт) и загрузка ./dist как Pages-артефакта
deploy	публикация на GitHub Pages
indexnow	пинг IndexNow после успешного деплоя
notify	итог пайплайна в Telegram (if: always())

Граф зависимостей GitHub не читает bun.lock, поэтому дерево отдаётся ему явно. Без этого в графе видны только прямые зависимости и не приходят алерты по транзитивным CVE.

Уведомлениям нужны секреты репозитория TELEGRAM_BOT_TOKEN и TELEGRAM_USER_ID. Если их нет, job не падает — недоставка попадает в лог warning'ом.

История

Сайт изначально собирался на MkDocs Material; в июне 2026 мигрирован на Astro (PR #194). Позже раннер переехал с Task на make, а пакетный менеджер с npm на bun. В августе 2026 собственные токены и шрифты заменены на дизайн-систему mishka-ds: PT Sans и JetBrains Mono ушли, вместо них IBM Plex Sans и Iosevka из пакета.

License

MIT