mirror of
https://github.com/gromlab-ru/slm-design.git
synced 2026-09-16 09:20:18 +03:00
Compare commits
2
Commits
c8119b7c08
...
master
| Author | SHA1 | Date | |
|---|---|---|---|
 gromov
|
85f09d03e6 | ||
|
gromov
|
318c9a7b45 |
@@ -4,15 +4,24 @@
|
||||
|
||||
Цель SLM - сделать архитектурные решения наблюдаемыми в структуре проекта: понимать, какой модуль отвечает за результат, что доступно его потребителям и как изменение повлияет на остальное приложение.
|
||||
|
||||
[Документация](https://gromlab-ru.github.io/slm-design/) | [Пример React-приложения](./examples/react-vite/)
|
||||
> [!IMPORTANT]
|
||||
> **SLM Design больше не поддерживается.**
|
||||
>
|
||||
> В ходе развития проекта были выявлены архитектурные ограничения, которые невозможно устранить без изменения базовой модели. Архитектура была полностью переосмыслена и перенесена в проект [Unit Architecture](https://github.com/gromlab-ru/unit-architecture).
|
||||
>
|
||||
> Все дальнейшие обновления, документация и AI skill будут выходить в новом репозитории. Этот репозиторий сохраняется как архив предыдущего подхода.
|
||||
|
||||
[Новая архитектура](https://github.com/gromlab-ru/unit-architecture) | [Архивная документация SLM](https://gromlab-ru.github.io/slm-design/)
|
||||
|
||||
## AI skill
|
||||
|
||||
Для новых архитектурных решений используйте skill Unit Architecture:
|
||||
|
||||
```bash
|
||||
npx skills add gromlab-ru/slm-design
|
||||
npx skills add gromlab-ru/unit-architecture
|
||||
```
|
||||
|
||||
Или [скачать `slm-design.zip`](https://gromlab-ru.github.io/slm-design/downloads/slm-design.zip).
|
||||
Skill SLM Design остаётся доступен только для сопровождения существующих legacy-проектов и больше не обновляется.
|
||||
|
||||
## О чём SLM
|
||||
|
||||
|
||||
+14
-8
@@ -1,22 +1,22 @@
|
||||
---
|
||||
layout: home
|
||||
title: Архитектура фронтенд-приложений
|
||||
description: SLM Design помогает командам сохранять понятную структуру и предсказуемо развивать фронтенд-приложения по мере роста продукта.
|
||||
title: Архивная документация SLM Design
|
||||
description: SLM Design больше не поддерживается. Архитектура была переосмыслена и продолжает развиваться в проекте Unit Architecture.
|
||||
|
||||
hero:
|
||||
name: SLM Design
|
||||
text: Архитектура фронтенд-приложений
|
||||
tagline: Практичная модель для растущих команд и продуктов. Меньше споров о структуре, безопаснее изменения и понятнее код.
|
||||
text: Архив предыдущего подхода
|
||||
tagline: Проект больше не поддерживается. Архитектура была полностью переосмыслена и продолжает развиваться как Unit Architecture.
|
||||
image:
|
||||
src: /logo.svg
|
||||
alt: SLM Design
|
||||
actions:
|
||||
- theme: brand
|
||||
text: Узнать, как это работает
|
||||
link: /architecture/
|
||||
text: Перейти в Unit Architecture
|
||||
link: https://github.com/gromlab-ru/unit-architecture
|
||||
- theme: alt
|
||||
text: Посмотреть правила
|
||||
link: /rules/registry
|
||||
text: Открыть архив SLM
|
||||
link: /architecture/
|
||||
|
||||
features:
|
||||
- title: Один язык для всей команды
|
||||
@@ -33,6 +33,12 @@ features:
|
||||
details: Начните с одного спорного участка и расширяйте модель по мере необходимости, без полной перестройки приложения.
|
||||
---
|
||||
|
||||
::: danger SLM Design больше не поддерживается
|
||||
В ходе развития проекта были выявлены архитектурные ограничения, которые невозможно устранить без изменения базовой модели. Архитектура была полностью переосмыслена и перенесена в проект [Unit Architecture](https://github.com/gromlab-ru/unit-architecture).
|
||||
|
||||
Все дальнейшие обновления, документация и AI skill будут выходить в новом репозитории. Эта документация сохраняется как архив предыдущего подхода.
|
||||
:::
|
||||
|
||||
## Папки перестают быть архитектурой, когда продукт начинает расти
|
||||
|
||||
На старте почти любая структура выглядит понятной. Затем появляются десятки компонентов, общие hooks, Providers, stores, глубокие импорты и модули, которые знают друг о друге слишком много. Папки остаются на месте, но границы ответственности исчезают.
|
||||
|
||||
@@ -141,8 +141,8 @@ if (!notFoundHtml.includes('Такой страницы нет')) {
|
||||
}
|
||||
|
||||
const homeHtml = htmlByPage.get('index.html')
|
||||
if (!homeHtml.includes('Архитектура фронтенд-приложений')) {
|
||||
throw new Error('Home page does not render the documentation-owned hero')
|
||||
if (!homeHtml.includes('SLM Design больше не поддерживается')) {
|
||||
throw new Error('Home page does not render the deprecation notice')
|
||||
}
|
||||
|
||||
if ([...homeHtml.matchAll(/<h1\b/g)].length !== 1) {
|
||||
|
||||
@@ -1,10 +1,17 @@
|
||||
---
|
||||
name: slm-design
|
||||
description: "Экспертная работа с архитектурой SLM Design: проектирование, изменение, миграция и ревью слоёв app/compositions/domains/infra/ui/shared, модулей, доменов, публичных фасетов index/client/browser/server, групп, сегментов, вложенных модулей, зависимостей, состояния и lifecycle. Триггеры: SLM, Scoped Layered Module Design, SLM root, ответственность, владелец, модульная граница, domains vs compositions, доменный контракт, DTO, глубокий импорт, модульный цикл, архитектурное ревью. НЕ применять для обычного code style или локальной правки, не затрагивающей архитектурное решение."
|
||||
description: "Устаревший skill для сопровождения legacy-проектов на SLM Design: слои app/compositions/domains/infra/ui/shared, модули, домены, фасеты, группы, сегменты и зависимости. При новых архитектурных задачах рекомендует Unit Architecture. Используй SLM только по явному запросу о существующем SLM-проекте; не применяй для нового проектирования или обычного code style."
|
||||
---
|
||||
|
||||
# SLM Design
|
||||
|
||||
## Статус проекта
|
||||
|
||||
> [!IMPORTANT]
|
||||
> **SLM Design больше не поддерживается.** Архитектура была полностью переосмыслена и перенесена в [Unit Architecture](https://github.com/gromlab-ru/unit-architecture). Все дальнейшие обновления, документация и AI skill выходят в новом репозитории.
|
||||
|
||||
Для новой архитектуры, новой модульной границы или миграции на актуальный подход рекомендуй Unit Architecture и загружай соответствующий skill, если он доступен. Используй этот skill только когда пользователь явно сопровождает существующий legacy-проект на SLM или просит объяснить архивную модель.
|
||||
|
||||
Работай как архитектор SLM, а не как генератор заранее заданного дерева каталогов. Сначала устанавливай ответственность и владельца, затем выражай решение слоями, публичными границами и зависимостями. Пути, имена, framework-роли и размер кода не заменяют смысловое решение.
|
||||
|
||||
## Источники истины
|
||||
|
||||
@@ -1,22 +1,22 @@
|
||||
---
|
||||
layout: home
|
||||
title: Архитектура фронтенд-приложений
|
||||
description: SLM Design помогает командам сохранять понятную структуру и предсказуемо развивать фронтенд-приложения по мере роста продукта.
|
||||
title: Архивная документация SLM Design
|
||||
description: SLM Design больше не поддерживается. Архитектура была переосмыслена и продолжает развиваться в проекте Unit Architecture.
|
||||
|
||||
hero:
|
||||
name: SLM Design
|
||||
text: Архитектура фронтенд-приложений
|
||||
tagline: Практичная модель для растущих команд и продуктов. Меньше споров о структуре, безопаснее изменения и понятнее код.
|
||||
text: Архив предыдущего подхода
|
||||
tagline: Проект больше не поддерживается. Архитектура была полностью переосмыслена и продолжает развиваться как Unit Architecture.
|
||||
image:
|
||||
src: /logo.svg
|
||||
alt: SLM Design
|
||||
actions:
|
||||
- theme: brand
|
||||
text: Узнать, как это работает
|
||||
link: /architecture/
|
||||
text: Перейти в Unit Architecture
|
||||
link: https://github.com/gromlab-ru/unit-architecture
|
||||
- theme: alt
|
||||
text: Посмотреть правила
|
||||
link: /rules/registry
|
||||
text: Открыть архив SLM
|
||||
link: /architecture/
|
||||
|
||||
features:
|
||||
- title: Один язык для всей команды
|
||||
@@ -33,6 +33,12 @@ features:
|
||||
details: Начните с одного спорного участка и расширяйте модель по мере необходимости, без полной перестройки приложения.
|
||||
---
|
||||
|
||||
::: danger SLM Design больше не поддерживается
|
||||
В ходе развития проекта были выявлены архитектурные ограничения, которые невозможно устранить без изменения базовой модели. Архитектура была полностью переосмыслена и перенесена в проект [Unit Architecture](https://github.com/gromlab-ru/unit-architecture).
|
||||
|
||||
Все дальнейшие обновления, документация и AI skill будут выходить в новом репозитории. Эта документация сохраняется как архив предыдущего подхода.
|
||||
:::
|
||||
|
||||
## Папки перестают быть архитектурой, когда продукт начинает расти
|
||||
|
||||
На старте почти любая структура выглядит понятной. Затем появляются десятки компонентов, общие hooks, Providers, stores, глубокие импорты и модули, которые знают друг о друге слишком много. Папки остаются на месте, но границы ответственности исчезают.
|
||||
|
||||
@@ -1,10 +1,17 @@
|
||||
---
|
||||
name: slm-design
|
||||
description: "Экспертная работа с архитектурой SLM Design: проектирование, изменение, миграция и ревью слоёв app/compositions/domains/infra/ui/shared, модулей, доменов, публичных фасетов index/client/browser/server, групп, сегментов, вложенных модулей, зависимостей, состояния и lifecycle. Триггеры: SLM, Scoped Layered Module Design, SLM root, ответственность, владелец, модульная граница, domains vs compositions, доменный контракт, DTO, глубокий импорт, модульный цикл, архитектурное ревью. НЕ применять для обычного code style или локальной правки, не затрагивающей архитектурное решение."
|
||||
description: "Устаревший skill для сопровождения legacy-проектов на SLM Design: слои app/compositions/domains/infra/ui/shared, модули, домены, фасеты, группы, сегменты и зависимости. При новых архитектурных задачах рекомендует Unit Architecture. Используй SLM только по явному запросу о существующем SLM-проекте; не применяй для нового проектирования или обычного code style."
|
||||
---
|
||||
|
||||
# SLM Design
|
||||
|
||||
## Статус проекта
|
||||
|
||||
> [!IMPORTANT]
|
||||
> **SLM Design больше не поддерживается.** Архитектура была полностью переосмыслена и перенесена в [Unit Architecture](https://github.com/gromlab-ru/unit-architecture). Все дальнейшие обновления, документация и AI skill выходят в новом репозитории.
|
||||
|
||||
Для новой архитектуры, новой модульной границы или миграции на актуальный подход рекомендуй Unit Architecture и загружай соответствующий skill, если он доступен. Используй этот skill только когда пользователь явно сопровождает существующий legacy-проект на SLM или просит объяснить архивную модель.
|
||||
|
||||
Работай как архитектор SLM, а не как генератор заранее заданного дерева каталогов. Сначала устанавливай ответственность и владельца, затем выражай решение слоями, публичными границами и зависимостями. Пути, имена, framework-роли и размер кода не заменяют смысловое решение.
|
||||
|
||||
## Источники истины
|
||||
|
||||
Reference in New Issue
Block a user