Принятые архитектурные и организационные решения

<div class="materials-page">

<div class="page-meta">
ENERGOSKAN DEVELOPMENT PORTAL · ПРИНЯТЫЕ РЕШЕНИЯ
</div>

<h1>Принятые архитектурные и организационные решения</h1>

<p>
В этом документе фиксируются ключевые решения, принятые в ходе разработки
Energoskan Development Portal. Его цель — объяснить не только <b>что</b>
сделано, но и <b>почему</b> это было сделано именно так.
</p>

<hr>

<h2>1. Собственный портал вместо учебного</h2>

<p>
Принято решение отказаться от использования учебного Vibe Portal как основы рабочего проекта.
Создан отдельный Energoskan Development Portal со своим брендом, структурой и документацией.
</p>

<hr>

<h2>2. Разделение кода и контента</h2>

<p>
Вся документация хранится отдельно от программного кода. Это позволяет обновлять статьи без изменения логики портала и упрощает использование материалов в RAG-системах.
</p>

<hr>

<h2>3. Разделение на три уровня</h2>

<ul>
<li><b>База знаний</b> — практические материалы для пользователей.</li>
<li><b>Документация</b> — технические материалы, регламенты и описание технологий.</li>
<li><b>Администрирование</b> — сведения о самом портале, инфраструктуре и эксплуатации.</li>
</ul>

<hr>

<h2>4. Git как источник истины</h2>

<p>
Все изменения должны фиксироваться в Git. История разработки, версии и документация сопровождают код и позволяют восстановить ход развития проекта.
</p>

<hr>

<h2>5. Поддержка нескольких AI-провайдеров</h2>

<p>
Архитектура изначально проектируется с возможностью подключения нескольких AI-провайдеров. Пользователь выбирает провайдера (например, Claude, Kimi, OpenAI и др.), а конкретные модели управляются централизованно через административный интерфейс.
</p>

<hr>

<h2>6. Документация как база знаний для AI</h2>

<p>
Вся документация создается с расчетом на использование не только людьми, но и RAG-агентами. Статьи должны быть структурированными, независимыми и пригодными для автоматического поиска и цитирования.
</p>

<hr>

<h2>7. Принцип «сначала содержание — потом дизайн»</h2>

<p>
До завершения наполнения портала основной упор делается на структуру и содержание. Финальная доработка интерфейса, навигации и оформления выполняется после формирования полноценной базы знаний.
</p>

</div>