Архитектура

<article class="content-article">
  <div class="page-meta">ENERGOSKAN DEVELOPMENT PORTAL · ДОКУМЕНТАЦИЯ</div>

  <h1>Архитектура</h1>

  <p class="article-lead">
    Архитектура Energoskan Development Portal построена по модульному принципу.
    Каждый компонент отвечает за собственную область ответственности и может
    развиваться независимо.
  </p>

  <hr>

  <h2>Общая схема</h2>

  <pre><code>
                     Пользователь
                           │
                           ▼
                https://energoskandev.ru
                           │
                           ▼
                        nginx
                           │
            ┌──────────────┴──────────────┐
            ▼                             ▼
      Panel (Node.js)                Статические файлы
            │
            ├───────────────┐
            ▼               ▼
      Docker Workspace   Документация
            │
            ▼
      Claude Shim
            │
            ▼
       AI-провайдер
  </code></pre>

  <h2>Компоненты системы</h2>

  <h3>Panel</h3>
  <p>
    Центральный сервер портала. Отвечает за интерфейс, авторизацию,
    проекты, загрузку контента, API и взаимодействие между компонентами.
  </p>

  <h3>Workspace</h3>
  <p>
    Каждый пользователь работает в собственном Docker-контейнере с VS Code,
    что обеспечивает изоляцию проектов и единое окружение разработки.
  </p>

  <h3>Контент</h3>
  <p>
    База знаний, документация и административные материалы находятся
    в каталоге <code>/opt/dev-portal/content</code> и загружаются
    динамически через реестры разделов.
  </p>

  <h3>Claude Shim</h3>
  <p>
    Отвечает за подключение AI-провайдеров к порталу и взаимодействие
    с Claude Code.
  </p>

  <h3>nginx</h3>
  <p>
    Выполняет HTTPS-терминацию, маршрутизацию запросов и проксирование
    на внутренний сервер панели.
  </p>

  <h2>Структура проекта</h2>

  <pre><code>/opt/dev-portal
├── panel/
├── content/
├── docs/
├── shim/
├── nginx/
├── systemd/
├── scripts/
├── templates/
├── workspace-image/
└── VERSION</code></pre>

  <h2>Принципы архитектуры</h2>

  <ul>
    <li>Модульное развитие компонентов.</li>
    <li>Минимальная связанность между подсистемами.</li>
    <li>Разделение пользовательского интерфейса и контента.</li>
    <li>Поддержка нескольких AI-провайдеров в дальнейшем.</li>
    <li>Версионирование всех значимых изменений.</li>
    <li>Возможность независимого развития базы знаний и администрирования.</li>
  </ul>

  <div class="article-note">
    Архитектура версии 2.0 является базой для дальнейшего развития портала,
    включая поддержку нескольких нейросетей, новых сервисов и интеграций.
  </div>
</article>