Архитектура проекта

Данный документ описывает архитектуру Energoskan Development Portal и служит технической документацией для разработчиков, администраторов и AI-агентов.

1. Общая схема

Пользователь
      │
      ▼
 Nginx
      │
      ▼
Node.js Panel
      │
      ├──────────────► База знаний
      │
      ├──────────────► Документация
      │
      ├──────────────► Администрирование
      │
      ├──────────────► VS Code
      │
      └──────────────► API

2. Основные компоненты

• Nginx — обратный прокси и HTTPS.
• Node.js Panel — веб-интерфейс портала.
• Content — HTML-документация и база знаний.
• Workspace — рабочие проекты пользователей.
• Docker — изолированные среды разработки.
• GitHub — хранение исходного кода и версий.

3. Структура проекта

/opt/dev-portal
│
├── panel
├── content
├── templates
├── workspace-image
├── scripts
├── shim
├── nginx
├── systemd
└── docs

4. Архитектурные принципы

• Максимальная модульность.
• Разделение интерфейса и контента.
• Документация хранится отдельно от кода.
• Все изменения фиксируются в Git.
• Поддержка нескольких AI-провайдеров.
• Минимальная зависимость между модулями.

5. Дальнейшее развитие

Архитектура рассчитана на подключение новых сервисов, AI-провайдеров, RAG-агентов, инструментов разработки, систем мониторинга и корпоративных модулей без изменения базовой структуры портала.