Окей, Джон. Собрала всё в единый, строгий стиль рекомендаций для TypeScript (Node.js + Vue) под ваши правила: декларативность, циклы (forEach по умолчанию, for — по делу), reduce — только уместно, нейминг, ООП с максимум 2 уровнями наследования, и «return в конце» с исключением для валидации. Единый стиль кода (TypeScript) — Node.js + Vue Версия: 1.0 Статус: обязательный для нового кода и для правок в существующем коде (правило «boy scout»: трогаешь — улучшаешь). 0) Базовый принцип Код пишется так, чтобы его можно было: — прочитать линейно и понять намерение; — безопасно менять без каскада побочных эффектов; — дебажить без прыжков по десяти выходам и скрытым мутациям. Если выбор между «красиво» и «понятно» — выбираем понятно. 1) Декларативный стиль (что это значит у нас) 1.1. Мы описываем намерение, а не «как именно бежим по индексам». Предпочтение: map, filter, find, some, every, flatMap. 1.2. Запрещено превращать декларативность в «цепочку ради цепочки». Если цепочка методов длиннее 3–4 шагов и её тяжело читать — выносим части в именованные функции/переменные. 1.3. Побочные эффекты локализуем. — Функции, которые «считают», не должны внезапно писать в лог/менять внешнее состояние. — Если побочный эффект нужен (лог, метрика, запись) — он должен быть очевиден по имени функции и месту в коде. 2) Циклы и работа с коллекциями 2.1. Правило по умолчанию — Для массивов используем методы массивов. — forEach — базовый выбор для «сделать действие для каждого элемента». — for/for..of разрешён только по чётким причинам (см. ниже). 2.2. forEach — когда обязателен Используем forEach, когда: — результат не является новым массивом/структурой; — мы выполняем действие (логирование, накопление ошибок, вызов функции) для каждого элемента. Важно: forEach не должен маскировать трансформации данных. Если вы строите новый массив — это map/filter. 2.3. map/filter/find/some/every — когда обязателен — map: преобразование массива 1:1. — filter: отбор. — find: найти один элемент. — some/every: проверки. Запрещено писать ручной поиск/проверку через forEach с внешней переменной. 2.4. for / for..of — когда разрешён (и это не стыдно) Разрешено использовать for/for..of, если выполняется хотя бы одно: — нужен break/continue; — участок кода «горячий» (большие массивы, парсинг, tight loop) и есть ожидаемая выгода; — нужно избежать лишних аллокаций (цепочки map/filter создают промежуточные массивы); — требуется последовательный async-проход (см. async-раздел). 2.5. reduce — строгие правила (чтобы не было «вижу цикл — ставлю reduce») reduce разрешён только когда: — вы сворачиваете коллекцию в одно значение (число/строку/объект/Map/Record); — логика свёртки читается как «аккумулятор + элемент → новый аккумулятор»; — это действительно проще/понятнее, чем альтернативы. reduce запрещён когда: — вы используете его как замену filter + map ради «одного прохода», но код становится менее читаемым; — reduce используется ради побочных эффектов (логирование, вызовы функций) — для этого есть forEach; — аккумулятор — это массив, в который вы пушите, и при этом логика по сути «фильтруем/мапим». Норма: — сумма/агрегация: reduce — построение словаря: reduce или Object.fromEntries (если уместно) — фильтрация/проекция: filter + map 2.6. Мутации и иммутабельность (без религии) — Запрещено мутировать входные параметры функции. — Локальная мутация внутри функции допустима, если она не «утекает» наружу и делает код проще. — Во Vue: не делаем «магические» мутации, которые ломают реактивность. Если меняем состояние — делаем это в ожидаемом месте (store/composable/component state). 3) Return в конце функции/метода (строго) 3.1. Основное правило По возможности функция/метод имеет один основной return в конце. 3.2. Зачем — линейное чтение; — проще дебажить (одна точка выхода); — меньше риска «вышли раньше и забыли важный шаг». 3.3. Как писать — используем переменную результата: result/response/nextState (или доменное имя); — выполняем вычисления/подготовку; — возвращаем результат в конце. 3.4. Исключения (разрешены) — валидация/guard clauses: ранние return допустимы, чтобы не раздувать вложенность; — ошибки: throw допустим и считается нормальным ранним выходом; — очень короткие функции (1–3 строки), где ранний return не ухудшает читаемость. 3.5. Запрещено — делать «return в конце» ценой адской вложенности из 4–5 уровней if. Если без guard clauses получается вложенный лабиринт — используем guard clauses. 4) Нейминг (строго, без креатива) 4.1. Общие правила — имя отвечает на вопрос «что это?» и «в каком смысле/единицах?»; — чем шире область видимости — тем более полное имя; — запрещены бессмысленные имена: data, info, temp, value, obj, res (кроме очень локального контекста, где это реально стандарт, например req/res в express-обработчике). 4.2. Переменные — boolean: is/has/can/should/needs (isEnabled, hasAccess, canRetry) — коллекции: множественное число (users, orders) — индексированные структуры: usersById, ordersByStatus — единицы измерения: timeoutMs, sizeBytes, ageYears 4.3. Функции/методы — глагол + объект: getUser, buildPayload, parseDate, validateOrder — предикаты: isValidX, hasX — обработчики: выбираем один стиль и держим его: — либо handleX — либо onX 4.4. Типы/интерфейсы/классы — PascalCase: User, OrderService — типы-алиасы для смысловых единиц: UserId, OrderStatus — интерфейсы без префикса I (если нет исторической причины) 4.5. Разделение домена и транспорта — домен: User — транспорт: UserDto — представление (если реально есть слой): UserViewModel 5) ООП (строго, но без зоопарка) 5.1. Наследование — допускается только при реальном отношении is-a; — максимум 2 уровня: Base → Derived → Concrete. Третий уровень наследования запрещён. Дальше — композиция. 5.2. Композиция предпочтительнее Сервисы собираются из зависимостей (Repository/Client/Logger), а не наследуются от «BaseEverythingService». 5.3. Классы vs функции — классы: когда есть состояние, инварианты, жизненный цикл; — функции/модули: когда это чистая логика/утилиты. 5.4. Vue-слой — компоненты: UI и склейка; — бизнес-логика: composables/services; — доступ к API: отдельный client/service слой. 6) TypeScript-строгость и типы — any запрещён по умолчанию. Если очень надо: unknown + runtime-проверка. — предпочитаем union types вместо «магических строк». — enum используем осторожно; для фронта часто лучше string union. — типы должны упрощать чтение: не пишем «типовую поэзию» ради умности. 7) Ошибки и исключения (Node.js) — ошибки не глотаем; — try/catch пишем только там, где: — можем обработать; — или добавляем контекст и пробрасываем дальше. — допускаются свои классы ошибок/коды, но без бесконечного зоопарка. 8) Async/await (строго) — не смешиваем then/catch и await в одном стиле в одном модуле без причины; — параллельные операции: Promise.all; — последовательные операции: for..of / for. Запрещено: forEach(async () = ...) (это ловушка: не ждёт как вы думаете). 9) Мини-правила ревью (как это применять) — если видим reduce, ревьюер обязан спросить: «это реально свёртка в одно значение?» — если видим for, автор обязан указать причину: break/continue, perf, async-seq, аллокации. — если видим 5 ранних return в бизнес-логике — просим привести к одному return в конце (кроме валидации). — если видим имена типа data/temp/value — просим переименовать. — если видим наследование глубже 2 уровней — блокируем MR. Если хочешь, я могу дописать финальный раздел «структура проекта» отдельно для Node (controllers/services/repositories) и для Vue (components/composables/stores/api), но мне нужно одно решение: вы используете во Vue Pinia или Vuex? И на Node у вас Express/Nest/Fastify?