chore: объединить docs и build в одну команду

- npm run build теперь включает генерацию docs (concat-md.js + vitepress build)
chore: обновить версию до 0.1.5
2026-04-19 02:10:04 +03:00 · 2026-04-19 02:04:35 +03:00 · 2026-04-19 02:04:22 +03:00 · 2026-04-19 02:04:07 +03:00 · 2026-04-19 02:04:07 +03:00 · 2026-04-18 22:38:10 +00:00
8 changed files with 149 additions and 37 deletions
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@@ -9,7 +9,7 @@ jobs:
    runs-on: ubuntu-latest
    if: "!contains(github.event.head_commit.message, '[skip ci]')"
    outputs:
-      new_tag: ${{ steps.tag.outputs.new_tag }}
+      version: ${{ steps.version.outputs.version }}
    steps:
      - name: Checkout
        uses: actions/checkout@v4
@@ -21,7 +21,14 @@ jobs:
        with:
          node-version: 24

-      - name: Генерация ARCHITECTURE.md
+      - name: Версия из package.json
+        id: version
+        run: |
+          VERSION="v$(node -p "require('./package.json').version")"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "Версия: $VERSION"
+
+      - name: Генерация docs
        run: |
          npm ci
          npm run docs
@@ -30,30 +37,24 @@ jobs:
        run: |
          git config user.name "CI Bot"
          git config user.email "ci@gromlab.ru"
-          git add generated/
+          git add generated/ README_RU.md
          if git diff --cached --quiet; then
-            echo "ARCHITECTURE.md не изменился, пропуск"
+            echo "Нет изменений, пропуск"
          else
-            git commit -m "docs: обновить ARCHITECTURE.md [skip ci]"
+            git commit -m "docs: обновить generated (${{ steps.version.outputs.version }}) [skip ci]"
            git push origin main
          fi

-      - name: Автоматический тег (semver patch)
-        id: tag
+      - name: Создать тег
        run: |
-          LAST_TAG=$(git tag -l 'v*' --sort=-v:refname | head -1)
-          if [ -z "$LAST_TAG" ]; then
-            NEW_TAG="v0.1.0"
+          VERSION=${{ steps.version.outputs.version }}
+          if git tag -l "$VERSION" | grep -q "$VERSION"; then
+            echo "Тег $VERSION уже существует, пропуск"
          else
-            MAJOR=$(echo "$LAST_TAG" | cut -d. -f1)
-            MINOR=$(echo "$LAST_TAG" | cut -d. -f2)
-            PATCH=$(echo "$LAST_TAG" | cut -d. -f3)
-            NEW_TAG="${MAJOR}.${MINOR}.$((PATCH + 1))"
+            git tag "$VERSION"
+            git push origin "$VERSION"
+            echo "Создан тег: $VERSION"
          fi
-          git tag "$NEW_TAG"
-          git push origin "$NEW_TAG"
-          echo "new_tag=$NEW_TAG" >> $GITHUB_OUTPUT
-          echo "Создан тег: $NEW_TAG"

  docker:
    runs-on: ubuntu-latest
@@ -91,7 +92,7 @@ jobs:
            type=ref,event=branch
            type=sha,prefix=
            type=raw,value=latest,enable={{is_default_branch}}
-            type=raw,value=${{ needs.docs.outputs.new_tag }}
+            type=raw,value=${{ needs.docs.outputs.version }}

      - name: Build and push
        uses: docker/build-push-action@v5
@@ -103,7 +104,7 @@ jobs:
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}
          build-args: |
-            VERSION_TAG=${{ needs.docs.outputs.new_tag }}
+            VERSION_TAG=${{ needs.docs.outputs.version }}
          provenance: false
          sbom: false

@@ -132,31 +133,23 @@ jobs:
            IMAGE="${{ env.REGISTRY_IMAGE }}:latest"
            CONTAINER="slm-design"

-            # Логин в реестр
            echo '${{ secrets.CR_TOKEN }}' | docker login ${{ env.DOCKER_REGISTRY }} -u '${{ secrets.CR_USER }}' --password-stdin

-            # Сохранить ID текущего образа до pull
            OLD_IMAGE_ID=$(docker images -q "$IMAGE" 2>/dev/null || true)
-
-            # Скачать новый образ
            docker pull "$IMAGE"

-            # Перезапустить контейнер
            docker stop "$CONTAINER" 2>/dev/null || true
            docker rm "$CONTAINER" 2>/dev/null || true
            docker run -d --name "$CONTAINER" --network web --restart unless-stopped "$IMAGE"

-            # Удалить старый образ если он отличается от нового
            NEW_IMAGE_ID=$(docker images -q "$IMAGE")
            if [ -n "$OLD_IMAGE_ID" ] && [ "$OLD_IMAGE_ID" != "$NEW_IMAGE_ID" ]; then
              docker rmi "$OLD_IMAGE_ID" 2>/dev/null || true
            fi

-            # Очистка
            docker image prune -af --filter "label=org.opencontainers.image.title=$CONTAINER"
            docker image prune -f
            docker builder prune -f 2>/dev/null || true

-            # Статус
            docker ps --filter "name=$CONTAINER"
          SCRIPT
--- a/.gitignore
+++ b/.gitignore
@@ -140,5 +140,3 @@ docs/.vitepress
 notes


-# Генерируемые файлы
-README_RU.md
--- a/2
+++ b/2
@@ -4,7 +4,7 @@ WORKDIR /app
 COPY package*.json ./
 RUN npm ci
 COPY . .
-RUN sed -i "s|raw/branch/main/generated|raw/tag/${VERSION_TAG}/generated|" docs/ru/index.md \
+RUN sed -i "s|raw/branch/main|raw/tag/${VERSION_TAG}|g" docs/ru/index.md \
    && npm run build

 FROM caddy:2-alpine
--- a/README_RU.md
+++ b/README_RU.md
@@ -0,0 +1,98 @@
+# SLM Design
+Scoped Layered Module Design — модульная архитектура фронтенд-приложений. Код организован по слоям ответственности, а модуль содержит всё, что ему нужно: компоненты, хуки, сторы, типы, стили.
+
+<!-- rules-link -->
+🤖 Для AI-ассистентов доступен единый файл правил:<br>[https://gromlab.ru/gromov/slm-design/raw/tag/v0.1.5/generated/ru/ARCHITECTURE.md](https://gromlab.ru/gromov/slm-design/raw/tag/v0.1.5/generated/ru/ARCHITECTURE.md)
+<!-- /rules-link -->
+
+## Преимущества
+
+### Вертикальная организация домена
+
+Бизнес-домен не разбивается по техническим слоям — сценарии, сущности, типы и UI живут в одном модуле. Это сокращает время навигации и упрощает сопровождение: все изменения домена локализованы.
+
+### Разделение ответственности без перегрузки слоёв
+
+Сервисы приложения (`infrastructure/`), UI-кит (`ui/`) и общие ресурсы (`shared/`) — три разных слоя с разной природой. Ни один слой не превращается в свалку разнородного кода.
+
+### Горизонтальная инкапсуляция
+
+Вложенные модули (`parts/`) и направление зависимостей позволяют нескольким разработчикам работать над одной областью приложения параллельно, не затрагивая код друг друга.
+
+### Колокация по умолчанию
+
+Код начинает жизнь рядом с местом использования и поднимается в общие слои только при реальной потребности. Глобальные слои не засоряются преждевременными абстракциями.
+
+### Явное разделение каркаса и контента
+
+Каркас группы маршрутов (`layouts/`) и контент конкретной страницы (`screens/`) — независимые слои с собственной ответственностью.
+
+### Масштабирование через группировку
+
+При росте проекта слои не теряют структуру — модули группируются по естественным признакам: бизнес-домены по субдоменам, страницы по разделам, UI-компоненты по уровню абстракции (примитивы и композиции).
+
+### Dependency Injection без фреймворков
+
+Cross-domain зависимости в бизнес-слое реализуются через фабрики — модуль декларирует что ему нужно, а точка использования предоставляет зависимости. Домены изолированы без DI-контейнеров, провайдеров и шин событий.
+
+## Происхождение
+
+SLM Design вырос на основе:
+
+- **Feature-Sliced Design** — слоистая структура, публичный API модуля, направление зависимостей
+- **Vertical Slice Architecture** — модуль как вертикальный срез, содержащий всё необходимое
+- **Screaming Architecture** — структура проекта «кричит» о назначении: открыл `business/auth` — видишь авторизацию
+- **Colocation Principle** — код живёт рядом с местом использования
+
+## Пример структуры проекта
+
+```text
+src/
+├── app/
+│
+├── layouts/
+│   ├── main/
+│   └── dashboard/
+│
+├── screens/
+│   ├── home/
+│   ├── products/
+│   ├── product-detail/
+│   └── about/
+│
+├── widgets/
+│   ├── page-heading/
+│   ├── hero-section/
+│   └── promo-banner/
+│
+├── business/
+│   ├── auth/
+│   ├── catalog/
+│   ├── orders/
+│   └── chat/
+│
+├── infrastructure/
+│   ├── theme/
+│   ├── i18n/
+│   ├── backend-api/
+│   └── logger/
+│
+├── ui/
+│   ├── button/
+│   ├── input/
+│   ├── modal/
+│   ├── toast/
+│   └── dropdown/
+│
+└── shared/
+    ├── lib/
+    ├── types/
+    └── styles/
+```
+
+## Принципы
+
+- **Домен — единое целое.** Всё, что относится к домену, живёт в одном модуле.
+- **Колокация.** Код рождается рядом с местом использования и поднимается только при необходимости.
+- **Зависимости однонаправлены.** Импорты только сверху вниз, только через публичный API.
+- **Архитектура — каркас, не клетка.** Правила фиксируют направление зависимостей и структуру модуля, остальное определяет команда.
--- a/concat-md.js
+++ b/concat-md.js
@@ -73,4 +73,28 @@ const buildRules = (lang) => {
 buildRules("ru");
 buildRules("en");

+// Версия из package.json
+const pkg = JSON.parse(fs.readFileSync("./package.json", "utf8"));
+const version = `v${pkg.version}`;
+
+// Подставить версию в ссылки
+const replaceVersion = (content) =>
+  content.replace(/raw\/branch\/main/g, `raw/tag/${version}`);
+
+// Генерируем README из index.md
+const buildReadme = (lang, outFile) => {
+  const indexPath = `./docs/${lang}/index.md`;
+
+  if (!fs.existsSync(indexPath)) {
+    console.log(`Пропуск README (${lang}): ${indexPath} не найден`);
+    return;
+  }
+
+  const content = replaceVersion(stripFrontmatter(fs.readFileSync(indexPath, "utf8")));
+  fs.writeFileSync(outFile, content, "utf8");
+  console.log(`${outFile} создан из ${indexPath} (${version})`);
+};
+
+buildReadme("ru", "./README_RU.md");
+

--- a/docs/ru/index.md
+++ b/docs/ru/index.md
@@ -6,7 +6,7 @@ title: SLM Design
 Scoped Layered Module Design — модульная архитектура фронтенд-приложений. Код организован по слоям ответственности, а модуль содержит всё, что ему нужно: компоненты, хуки, сторы, типы, стили.

 <!-- rules-link -->
-Для AI-ассистентов доступен [единый файл правил](https://gromlab.ru/gromov/slm-design/raw/branch/main/generated/ru/ARCHITECTURE.md).
+🤖 Для AI-ассистентов доступен единый файл правил:<br>[https://gromlab.ru/gromov/slm-design/raw/branch/main/generated/ru/ARCHITECTURE.md](https://gromlab.ru/gromov/slm-design/raw/branch/main/generated/ru/ARCHITECTURE.md)
 <!-- /rules-link -->

 ## Преимущества
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,11 +1,11 @@
 {
-  "name": "nextjs-style-guide",
+  "name": "slm-design",
  "version": "0.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
-      "name": "nextjs-style-guide",
+      "name": "slm-design",
      "version": "0.0.0",
      "devDependencies": {
        "vitepress": "^1.6.3"
--- a/package.json
+++ b/package.json
@@ -2,14 +2,13 @@
  "name": "slm-design",
  "private": true,
  "type": "module",
-  "version": "0.0.0",
+  "version": "0.1.5",
  "scripts": {
    "docs": "node ./concat-md.js",
    "dev": "vitepress dev .",
-    "build": "vitepress build .",
+    "build": "node ./concat-md.js && vitepress build .",
    "serve": "vitepress serve ."
  },
-  "dependencies": {},
  "devDependencies": {
    "vitepress": "^1.6.3"
  }
Author	SHA1	Message	Date
S.Gromov	dfc56f918a	chore: объединить docs и build в одну команду All checks were successful CI/CD Pipeline / docs (push) Successful in 12s Details CI/CD Pipeline / docker (push) Successful in 37s Details CI/CD Pipeline / deploy (push) Successful in 5s Details - npm run build теперь включает генерацию docs (concat-md.js + vitepress build)	2026-04-19 02:10:04 +03:00
S.Gromov	d3a152e177	chore: обновить версию до 0.1.5 All checks were successful CI/CD Pipeline / docs (push) Successful in 13s Details CI/CD Pipeline / docker (push) Successful in 36s Details CI/CD Pipeline / deploy (push) Successful in 6s Details	2026-04-19 02:04:35 +03:00
S.Gromov	515506e01e	chore: версия из package.json для тегов и ссылок - версия берётся из package.json (0.1.0) - concat-md.js подставляет версию в README_RU.md - CI берёт версию из package.json, создаёт тег, не повышает автоматически - убран husky	2026-04-19 02:04:22 +03:00
S.Gromov	35763617b5	chore: вернуть коммит generated/ из CI с подстановкой тега - CI: генерация → тегирование → подстановка тега в README_RU.md → коммит [skip ci] → пуш тега - убран husky	2026-04-19 02:04:07 +03:00
S.Gromov	979df1205a	chore: убрать коммит из CI, оставить только тегирование - CI больше не коммитит в main (убраны конфликты) - README_RU.md в git с ссылкой на branch/main (всегда актуально) - тег подставляется только на сайте через Dockerfile	2026-04-19 02:04:07 +03:00
CI Bot	d9b9748691	docs: обновить ARCHITECTURE.md и README (v0.1.4) [skip ci]	2026-04-18 22:38:10 +00:00
S.Gromov	32892fb799	docs: вернуть текст перед ссылкой на ARCHITECTURE.md All checks were successful CI/CD Pipeline / docs (push) Successful in 13s Details CI/CD Pipeline / docker (push) Successful in 36s Details CI/CD Pipeline / deploy (push) Successful in 5s Details	2026-04-19 01:37:56 +03:00
CI Bot	c6803710c6	docs: обновить ARCHITECTURE.md и README (v0.1.3) [skip ci]	2026-04-18 22:36:05 +00:00
S.Gromov	2dfdc78c79	docs: полная ссылка на ARCHITECTURE.md без сокращений All checks were successful CI/CD Pipeline / docs (push) Successful in 12s Details CI/CD Pipeline / docker (push) Successful in 36s Details CI/CD Pipeline / deploy (push) Successful in 6s Details	2026-04-19 01:35:50 +03:00
CI Bot	9d0ac66cdc	docs: обновить ARCHITECTURE.md и README (v0.1.2) [skip ci]	2026-04-18 22:32:17 +00:00
S.Gromov	42703b107b	docs: обновить формат ссылки на ARCHITECTURE.md All checks were successful CI/CD Pipeline / docs (push) Successful in 13s Details CI/CD Pipeline / docker (push) Successful in 37s Details CI/CD Pipeline / deploy (push) Successful in 6s Details - добавлен эмодзи робота для визуального выделения - текст ссылки показывает путь к файлу - sed в Dockerfile и CI обновлён для замены URL и текста ссылки	2026-04-19 01:31:57 +03:00
CI Bot	0e2380dc3f	docs: обновить ARCHITECTURE.md и README (v0.1.1) [skip ci]	2026-04-18 22:24:26 +00:00
S.Gromov	6c82d9d747	chore: генерация README_RU.md в CI с подстановкой URL тега All checks were successful CI/CD Pipeline / docs (push) Successful in 12s Details CI/CD Pipeline / docker (push) Successful in 37s Details CI/CD Pipeline / deploy (push) Successful in 6s Details - concat-md.js: восстановлена генерация README_RU.md из index.md - CI: подставляет URL с тегом в README_RU.md перед коммитом - README_RU.md убран из .gitignore	2026-04-19 01:24:13 +03:00