microdao-daarion/docs/hardcode_vs_config.md

Хардкод vs Конфігурація

🔴 ХАРДКОД (Hardcode) - Що це?

Хардкод = значення, які "зашиті" прямо в коді і не можуть змінюватись без редагування коду.

Приклад хардкоду:

# ❌ ХАРДКОД - значення прямо в коді
local_model = "qwen3-8b"  # Якщо треба змінити модель, треба редагувати код!

Проблеми хардкоду:

1. Треба редагувати код для зміни значення
2. Не можна змінити без перезапуску сервісу
3. Важко тестувати різні конфігурації
4. Не гнучко - однаковий код для всіх середовищ (dev/prod)

---

✅ КОНФІГУРАЦІЯ (Config) - Що це?

Конфігурація = значення, які зберігаються окремо від коду (в файлах, змінних середовища, БД) і можуть змінюватись без редагування коду.

Приклад конфігурації:

# ✅ КОНФІГ - значення в окремому файлі router-config.yml
llm_profiles:
  qwen3_science_8b:
    provider: ollama
    model: qwen3:8b
    max_tokens: 2048

# ✅ КОД читає з конфігу
llm_profile = router_config.get("llm_profiles", {}).get("qwen3_science_8b")
model = llm_profile.get("model")  # Беремо з конфігу, не хардкодимо!

Переваги конфігурації:

1. Зміна без редагування коду - просто змінити YAML файл
2. Різні конфіги для різних середовищ (dev/prod/staging)
3. Легко тестувати - можна створити test-config.yml
4. Гнучко - один код, багато конфігурацій

---

📊 ПОРІВНЯННЯ

Аспект	Хардкод	Конфігурація
Де зберігається?	В коді	В окремих файлах
Як змінити?	Редагувати код	Редагувати конфіг
Потрібен рестарт?	Так (перекомпіляція)	Так (перезапуск)
Гнучкість	Низька	Висока
Тестування	Важко	Легко

---

🔧 ЩО МИ ВИПРАВИЛИ?

БУЛО (хардкод):

# ❌ Хардкод - модель завжди "qwen3-8b"
local_model = "qwen3-8b"

СТАЛО (з конфігу):

# ✅ Читаємо з конфігу
if llm_profile.get("provider") == "ollama":
    ollama_model = llm_profile.get("model", "qwen3:8b")
    local_model = ollama_model.replace(":", "-")  # qwen3:8b → qwen3-8b

Результат:

• ✅ Модель береться з router-config.yml
• ✅ Якщо змінити конфіг → зміниться поведінка
• ✅ Не треба редагувати код для зміни моделі
• ✅ Різні агенти можуть мати різні локальні моделі

---

💡 КОЛИ ВИКОРИСТОВУВАТИ?

Хардкод - тільки для:

• Константи (π = 3.14, версія API)
• Значення, які ніколи не зміняться
• Технічні деталі (timeout = 5.0 сек)

Конфігурація - для:

• Моделі LLM
• API ключі
• URL сервісів
• Параметри (temperature, max_tokens)
• Налаштування агентів

---

📝 ПРИКЛАД З НАШОГО ПРОЄКТУ

router-config.yml (конфігурація):

agents:
  helion:
    default_llm: qwen3_science_8b  # ← Можна змінити тут

llm_profiles:
  qwen3_science_8b:
    provider: ollama
    model: qwen3:8b  # ← Можна змінити модель тут

main.py (код):

# Читаємо з конфігу
default_llm = agent_config.get("default_llm", "qwen3-8b")
llm_profile = llm_profiles.get(default_llm, {})
model = llm_profile.get("model")  # ← Беремо з конфігу!

Тепер можна змінити модель просто редагуванням YAML файлу! 🎉