Чистий Код — Принципи + Чекліст

🔟 Основні принципи чистого JavaScript-коду

Один рядок — одна дія
const total = price * quantity; — уникай кількох операцій в одному рядку.
Змінні з чіткими іменами
const userProfile; краще, ніж const u;
Функція робить одну річ
Наприклад, функція fetchUserProfile; лише отримує дані, а не оновлює UI.
DRY — Don’t Repeat Yourself
Використовуй map або slice для уникнення повторів.
Використовуй use за замовчуванням
Замість let використовуй const, якщо значення не змінюється.
Мінімізуй вкладеність
Використовуй ранній return, наприклад:
```
if (!user) return null;
```

Коментарі пояснюють «чому»
Наприклад:

// Кешуємо результат для оптимізації
const cachedData = getData();

Використовуй ES6+ можливості
Стрілкові функції, деструктуризація: const { id, name } = user;
Обробляй асинхронність чітко
Використовуй async/await замість .then.
Форматуй код автоматично
ESLint + Prettier для єдиного стилю.
Уникай глобальних змінних
Використовуй модулі або замикання.
Перевіряй типи даних
Використовуй typeof або TypeScript для безпеки.

✅ Чекліст чистого JavaScript-коду

🔡 Імена та змінні Ім’я змінної/функції передає її суть? (Наприклад, calculateTotalPrice краще, ніж calc) Магічні значення винесені? (Наприклад, const MAX_USERS = 100; замість 100) Немає схожих імен, що плутають? (Наприклад, user і users можуть заплутати)

🧩 Структура Один рядок — одна дія? (Наприклад, const sum = a + b; замість кількох дій) Функції невеликі, роблять одне? (Функція до 20 рядків, наприклад, getUserById) Глибина вкладеності мінімальна? (Використовуй ранній return замість глибоких if)

♻️ Повтори Уникнено копіпасту? (Наприклад, використовуй array.map замість циклів) Схожі речі реалізовані однаково? (Наприклад, форматування дат через date-fns)

🧼 Форматування Прогнав через Prettier/ESLint? (ESLint і Prettier) Всі відступи, лапки, пробіли — однакові? (Перевір через форматувальник) Видалено мертвий код? (Наприклад, невикористані функції чи console.log)

🧠 Логіка Перевірено всі гілки? (Перевір if/else, switch, цикли) Використано ===, а не ==? (Строга рівність уникає помилок) Оброблені всі edge cases? (Перевір null, undefined, порожні масиви) Перевірено асинхронний код? (Переконайся, що async/await обробляє помилки)

📜 Коментарі Є коментарі там, де треба? (Коментуй складну логіку, наприклад, замикання) Коментарі пояснюють «чому», а не «що»? (Наприклад, "// Дозволяємо доступ до адмінки лише адміністраторам") Код зрозумілий без коментарів? (Чіткі імена зменшують потребу в коментарях)

🧪 Тестування Код перевірено в дії? (Запусти та перевір результат) Не ламає існуючу логіку? (Перевір старі функції після змін) Протестовано руками або автотестом? (Використовуй Jest або Mocha)

🔒 Безпека Перевірено на вразливості (XSS, ін’єкції)? (Екрануй дані, наприклад, через DOMPurify) Використані безпечні методи доступу? (Наприклад, уникнення eval чи innerHTML)

⚡ Оптимізація Код оптимізовано для продуктивністі? (Наприклад, використовуй forEach замість for для читабельності) Вдалося запобігти надмірному використанню ресурсів? (Перевір витоки пам’яті в замиканнях чи слухачах подій) Чи активовано режим "use strict"? (Додай "use strict"; на початку файлу)

🔟 Основні принципи чистого PHP-коду

Дотримуйся стандартів PSR
Використовуй PSR-12 для форматування коду.
Чіткі імена змінних і методів
$userRepository краще, ніж $repo.
Одна функція — одна відповідальність
Наприклад, getUserData лише отримує дані.
DRY — Don’t Repeat Yourself
Використовуй функції чи класи для повторюваного коду. >
Використовуй типізацію
Наприклад:
```
function add(int $a, int $b): int { return $a + $b; }
```
>
Мінімізуй вкладеність
Використовуй ранній return:
```
if (!$user) return null;
```
Обробляй помилки
Використовуй try/catch для винятків. >

Коментарі пояснюють «чому»
Наприклад:

// Використовується для кешування
private $cache = [];

Використовуй Composer
Організуй залежності через composer.json. >
Уникай глобальних змінних
Краще передавай дані через параметри.

✅ Чекліст чистого PHP-коду

🔡 Імена та змінні Чіткі імена змінних і методів? (Наприклад, $userService краще, ніж $s) Магічні значення винесені? (Наприклад, const MAX_USERS = 100;) Немає схожих імен? (Наприклад, $user і $users)

🧩 Структура Один рядок — одна дія? (Наприклад, $sum = $a + $b;) Методи невеликі, роблять одне? (До 20-30 рядків) Мінімальна вкладеність? (Ранній return замість вкладених if)

♻️ Повтори Уникнено копіпасту? (Винось у функції чи класи) Схожі задачі реалізовані однаково? (Наприклад, однаковий формат логів)

🧼 Форматування Дотримано PSR-12? (PSR-12) Однакові відступи та форматування? (Перевір через форматувальник) Видалено невикористаний код? (Наприклад, старі функції)

🧠 Логіка Перевірено всі гілки? (Перевір if/else, цикли) Оброблено винятки? (Використовуй try/catch) Перевірено edge cases? (Наприклад, порожні дані, light)

📜 Коментарі Є коментарі там, де треба? (Коментуйте складну логіку) Коментарі пояснюють «чому»? (Наприклад, «// Для безпеки») Код зрозумілий без коментарів? (Чітки імена зменшують потребу)

🧪 Тестування Код перевірено в дії? (Запустіть та перевір) Не ламає існуючу логіку? (Перевір старі функції) Протестовано автотестами? (Наприклад, PHPUnit)

🔒 Безпека Перевірено на SQL-ін’єкції та XSS? (Використовуй підготовлені запити) Використані безпечні методи? (Наприклад, htmlspecialchars)

⚡ Оптимізація Оптимізовано продуктивність? (Уникайте зайвих запитів до БД) Вдалося запобігти надмірному використанню ресурсів? (Перевір кешування)

🔟 Основні принципи чистого Python-коду

Дотримуйся PEP 8
Використовуй flake8 для форматування. >
Чіткі імена змінних
user_profile > краще, ніж u.
Функція робить одну річ
Наприклад, >get_user_data лише отримує дані. >
< DRY — Don’t Repeat Yourself
Використовуй > функції чи класи для повторів. >
Використовуй list comprehensions
Наприклад: >
```
[x*2 for x in numbers]
```
>
< >strong>Мінімізуй вкладеність
Використовуй ранній > return:
```
if not user: return None
```
Обробляй винятки
Використовуй > try/except для помилок. >
< Коментарі пояснюють «чому»
Наприклад: >
```
# cache для оптимизации
cache = {}
```
>
Використовуй віртуальні середовища
Наприклад, > >venv або poetry. > >
> Пиши самодокументований код
Чіткі імена > зменшують потребу в коментарях. >

✅ Чекліст чистого Python-коду

🔡 Імена та змінні Чітки імена змінних? >(Наприклад, user_data краще, ніж >d) Магічні значення винесені? >(Наприклад, MAX_USERS = 100) Немає схожих імен? >(Наприклад, user і users)

🧩 Структура Один рядок — одна дія? >(Наприклад, total = a + b) Функції невеликі, роблять одне? (До 20-30 рядків) Мінімальна вкладеність? >(Ранній return)

♻️ Повтори Уникнено копіпасту? (Винось у функції) Схожі задачі реалізовані однаково? (Наприклад, однаковий формат логів)

🧼 Форматування Дотримано PEP 8? (PEP 8) Однакові відступи та форматування? (Перевод через flake8) Видалено невикористаний код? (Наприклад, старі функції)

🧠 Логіка Перевірено всі гілки? (Перевір касс/если, цикли) Оброблено винятки? (Використовуй try/except) Перевірено edge cases? (Наприклад, порожні дані, None)

📜 Коментарі Є коментарі там, де треба? (Коментуй складну логіку) Коментарі пояснюють «чому»? (Наприклад, «// Для кешування») Код зрозумілий без коментарів? (Зрозумілі імена зменшують потребу у коментарях)

🧪 Тестування Код перевірено в дії? (Запусти та перевір) Не ламає існуючу логіку? (Перевір старі функції) Протестовано автотестами? (Наприклад, pytest)

🔒 Безпека Перевірено на вразливість? (Екрануй дані, наприклад, html.escape) Використані безпечні методи? (Наприклад, підготовлені запити до БД)

⚡ Оптимізація Оптимізовано продуктивність? (Уникайте зайвих циклів) Вдалося запобігти надмірному використанню ресурсів? (Перевір кешування)