Окей, Джон. Node.js + Vue, линтер уже есть, и reduce — не «религия», а инструмент. Тогда держи черновик регламента по TypeScript-кодстайлу под ваши вводные: декларативность, forEach по умолчанию, for — когда реально надо ускорить, нейминг без цирка, ООП — аккуратно и максимум 2 уровня наследования. ДОКУМЕНТ: TypeScript Code Style (Node.js + Vue) 1) Цели стиля (зачем мы это делаем) Мы пишем код так, чтобы: — его можно было читать без телепатии; — изменения были локальными и предсказуемыми; — производительность не убивалась «красотой ради красоты»; — типы помогали, а не мешали. 2) Декларативность: что это у нас значит Декларативный стиль = «что делаем», а не «как по шагам бежим по массиву». Предпочтения: — map/filter/some/every/find/flatMap вместо ручного накопления; — функции без побочных эффектов там, где это возможно; — минимизация мутаций (особенно входных параметров); — ранние return вместо вложенных if-ов. Но: декларативность не должна ухудшать читаемость. Если цепочка из 6 методов превращает код в лапшу — это не декларативность, это маскировка. 3) Циклы и коллекции (главное правило) 3.1. Базовое правило — По умолчанию используем методы массивов: forEach/map/filter/etc. — for разрешён, когда есть измеримая/ожидаемая выгода по производительности или нужен break/continue. 3.2. Когда forEach уместен forEach — для «сделать действие для каждого элемента», когда результат не нужен как новый массив. Пример (норм): const errors: string[] = []; items.forEach((item) = { if (!item.isValid) errors.push(item.id); }); Но если вы собираете новый массив — это уже map/filter. 3.3. Когда for лучше (и это не стыдно) — нужен break/continue; — очень горячий участок (парсинг, большие массивы, tight loop); — нужно избежать лишних аллокаций (map/filter создают новые массивы); — вы делаете сложную логику в одном проходе и это реально быстрее/проще. Пример (норм): for (let i = 0; i ((acc, user) = { acc[user.id] = user; return acc; }, {}); Хорошо (сумма): const total = orders.reduce((sum, o) = sum + o.amount, 0); Плохо (reduce вместо filter/map): const activeNames = users.reduce((acc, u) = { if (u.active) acc.push(u.name); return acc; }, []); // Лучше: const activeNames = users.filter((u) = u.active).map((u) = u.name); Плохо (reduce ради побочек): items.reduce((_, item) = { doSomething(item); return 0; }, 0); // Лучше: forEach 3.5. Иммутабельность: без фанатизма — Не мутируем входные параметры функций. — Внутри функции локальная мутация допустима, если она упрощает код и не течёт наружу. — В Vue особенно: не ломаем реактивность странными мутациями, но и не копируем всё подряд «на всякий случай». 4) Нейминг (переменные, функции, типы) — чтобы было понятно, а не «креативно» 4.1. Общие принципы — Имя отвечает на вопрос «что это?» и «в каких единицах/смысле?» — Избегаем аббревиатур, которые понятны только автору. — Чем шире область видимости — тем понятнее и полнее имя. 4.2. Переменные — boolean: is/has/can/should/needs isEnabled, hasAccess, canRetry, shouldCache — коллекции во множественном числе: users, orders, errorMessages — Map/Record: usersById, ordersByStatus — единицы измерения в имени: timeoutMs, ageYears, sizeBytes — не используем «data/info/value/temp» без уточнения смысла. Плохо: data, temp, res, obj Норм: userDto, responseBody, parsedConfig, authToken 4.3. Функции — глагол + объект: getUser, buildPayload, parseDate, validateOrder — обработчики событий: handleX / onX (выберите одно и держитесь) — функции-предикаты: isValidUser, hasPermission 4.4. Классы/типы/интерфейсы — Class/Interface/Type: PascalCase — типы-алиасы: UserId, OrderStatus — интерфейсы: без префикса I (если у вас нет старой традиции). Просто UserRepository, ApiClient. 4.5. DTO/модели/сущности (Node + Vue) Чтобы не путать домен и транспорт: — User (доменная модель) — UserDto (то, что пришло/ушло по API) — UserViewModel (если реально есть слой представления) 5) ООП «в пределах разумности» (и максимум 2 наследования) 5.1. Правило по наследованию — Наследование допускается, когда есть реальная иерархия «is-a». — Максимум: Base → Derived → Concrete (2 уровня). Дальше — композиция. 5.2. Предпочтение композиции Если поведение можно собрать из зависимостей — собираем. Пример: Service использует Repository + Logger + HttpClient, а не наследуется от «MegaBaseServiceWithEverything». 5.3. Абстракции — Интерфейсы/типы для контрактов (репозитории, клиенты, порты). — Классы — когда есть состояние/инварианты/жизненный цикл. — В Vue компонентах: бизнес-логику выносим в composables/services, компонент — про UI. 6) TypeScript: типы, которые помогают — noImplicitAny, strict: желательно включены. — Не злоупотребляем any. Если надо — unknown + проверка. — Предпочитаем union types вместо «магических строк». — Enum: осторожно. Для фронта часто лучше union из строк (легче сериализация/дебаг). 7) Ошибки и исключения (Node) — Ошибки должны быть типизированы (своими классами или кодами), но без зоопарка. — Не глотаем ошибки молча. — В async/await: try/catch только там, где вы реально можете обработать/обогатить контекст. 8) Async/await — Не мешаем then/catch и await в одном стиле. — Параллельность: Promise.all, когда операции независимы. — В циклах: если нужно последовательно — for..of/for (да, тут for уместен). forEach с async — ловушка. Плохо: items.forEach(async (item) = { await process(item); }); Норм: for (const item of items) { await process(item); } Или параллельно: await Promise.all(items.map((item) = process(item))); 9) Мини-примеры «плохо/хорошо» по декларативности 9.1. Поиск Плохо: let found: User | undefined; users.forEach((u) = { if (u.id === id) found = u; }); Хорошо: const found = users.find((u) = u.id === id); 9.2. Проверка условий Хорошо: const hasInvalid = items.some((i) = !i.isValid); 10) Правило «если спорно — выбираем читаемость» Если два варианта одинаково корректны, выбираем тот, который: — проще объяснить новичку; — проще отладить; — проще расширить без переписывания. Хочешь — я доведу это до совсем боевого стандарта под ваш репозиторий: скажи, вы хотите отдельные секции «Node (backend)» и «Vue (frontend)» с примерами (например, сервисы/репозитории для Node и composables/stores для Vue), или один общий документ без разделения?