SSPS - Единый стандарт для структуры проекта

Определения

Стандарт SSPS определяет требования к структуре и наименованию файлов и папок в проекте.

Структура и Семантика

Использование нижнего регистра и дефиса является обязательным для всех папок и файлов проекта, это обеспечивает согласованность и гарантирует отсутствие проблем, а также предотвращает конфликты в разных операционных системах и системах контроля версий (Git), где чувствительность к регистру может отличаться, вызывая ошибки.

Использование kebab-case исключает хаос вида getPrice.ts, Price.tsx и Name.test.ts в одной директории, сложные названия вроде CuteIDKOKReader преобразуются в читаемый cute-id-kok-reader.ts и зищает от багов Case Sensitive FS.

Почему не snake_case? Он требует избыточного использования клавиши Shift, плохо читается в вебе (например, если файл отображается как ссылка с подчеркиванием, _ сливается с линией) и Google официально не рекомендует использовать нижнее подчеркивание.

Единственное допустимое отступление это системные файлы в корне репозитория, такие как README или CONTRIBUTING, поскольку их верхний регистр продиктован общепринятыми стандартами документации.

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

Контекст определяется местоположением, то-есть если файл находится в features/auth, то именование auth-login-form.tsx избыточно, правильно: login-form.tsx.

Переход от названий вроде HeaderUserMenuAvatar к структуре widgets/header/ui/user-menu/avatar позволит сохранить имена файлов краткими и точными.

Проект выстраивается по слоям с четкой зоной ответственности по FSD.

Глобальные группы (entities, features, widgets) всегда именуются во множественном числе, конкретные модули (слайсы) внутри них, в единственном, внутренние сегменты (ui, model, api) остаются стандартными.

Это создает предсказуемую архитектуру, задача по изменению корзины всегда приведет в features/add-to-cart, где интерфейс и логика четко разделены.

Использование единого регистра (kebab-case) делает проекты однообразными, что поможет быстрее ориентироваться и решать задачи.