О системе

Energoskan Development Portal — внутренняя корпоративная платформа для разработки, хранения, тестирования и публикации приложений компании.

Текущая версия

Продукт

Energoskan Development Portal

Версия

Загрузка…

Ветка

Загрузка…

Статус

Загрузка…

Кодовое имя

Загрузка…

Назначение портала

• Создание и хранение внутренних проектов Energoskan.
• Работа с проектами через VS Code в браузере.
• Использование Claude Code и других AI-инструментов.
• Публикация приложений на отдельных адресах.
• Хранение документации и истории изменений.

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

• Panel — пользовательский интерфейс портала.
• Workspace — контейнеры разработки пользователей.
• Claude Shim — шлюз для AI-моделей.
• nginx — публичный доступ и маршрутизация.
• Git — контроль версий и история проекта.

История проекта

Основные этапы создания, миграции и развития корпоративного портала Energoskan.

Июль 2026 — создание стабильной основы

• Рабочий портал перенесён из /opt/vibe-portal в /opt/dev-portal.
• Сайт energoskandev.ru переключён на новую рабочую директорию.
• Настроено хранение проекта в частном GitHub-репозитории.
• Созданы техническая документация, контрольные точки и резервные копии.
• Проверена работа VS Code, Claude Code, проектов и пользовательских контейнеров.

Переход к Energoskan Development Portal

• Удаляется учебное наследие прежнего Vibe Portal.
• Интерфейс переводится на фирменный стиль Energoskan.
• Создаётся корпоративная база знаний.
• Вводится собственное версионирование портала.

Текущий этап

Ведётся разработка ветки development-2.0. Текущая предварительная версия — 2.0.0-alpha.1, кодовое имя — Phoenix.

Следующие этапы

• Полная очистка интерфейса от старых учебных разделов.
• Создание разделов документации и администрирования.
• Доработка корпоративного дизайна.
• Развитие управления проектами и правами доступа.
• Добавление статистики использования и состояния сервисов.

Документация проекта

Технические документы, журналы изменений, контрольные точки и материалы для продолжения разработки портала.

Основная документация

• README.md — краткое описание проекта и запуск.
• VERSION — текущая версия и статус разработки.
• CHANGELOG.md — история изменений.
• PROJECT_STATUS.md — текущее состояние проекта.
• CLAUDE.md — инструкции и контекст для AI-разработки.

Каталог docs

В каталоге /opt/dev-portal/docs хранятся технические отчёты, описания миграций, стабильные снимки и инструкции для продолжения работы.

Принцип ведения документации

• Значимые изменения фиксируются в Git.
• Перед крупными доработками создаются резервные копии.
• Ошибки и способы их решения записываются в технический журнал.
• После завершения этапа обновляются статус и история проекта.
• Секреты, токены и файлы .env в репозиторий не добавляются.

Расположение проекта

Рабочая директория

/opt/dev-portal

Документация

/opt/dev-portal/docs

Панель портала

/opt/dev-portal/panel

Корпоративный контент

/opt/dev-portal/content

Администрирование портала

Основные компоненты инфраструктуры, служебные команды и правила безопасного обслуживания портала.

Основные сервисы

Панель портала

vibe-panel.service, адрес 127.0.0.1:3020

AI-шлюз

anthropic-shim.service, порт 8190

Веб-сервер

nginx.service

Прокси

privoxy.service, адрес 127.0.0.1:8118

Рабочие пространства

Пользовательские Docker-контейнеры на базе vibe-workspace:dev

Проверка состояния

systemctl status vibe-panel.service --no-pager
systemctl status anthropic-shim.service --no-pager
systemctl status nginx.service --no-pager
docker ps
curl -s http://127.0.0.1:3020/api/version

Перезапуск панели

systemctl restart vibe-panel.service
systemctl status vibe-panel.service --no-pager

Журналы

journalctl -u vibe-panel.service -n 100 --no-pager
journalctl -u anthropic-shim.service -n 100 --no-pager
journalctl -u nginx.service -n 100 --no-pager

Правила безопасности

• Перед крупными изменениями создавать резервную копию файла.
• После изменения проверять синтаксис и работу сервиса.
• Не публиковать токены, пароли, ключи и содержимое .env.
• Не удалять рабочие контейнеры и пользовательские проекты без отдельной проверки.
• Изменения фиксировать в Git только после успешного тестирования.

Папка .claude

Каталог .claude используется для проектных настроек, команд, skills и дополнительного контекста Claude Code.

Рекомендуемая структура

.claude/
├── commands/
├── skills/
└── settings.json

Не добавляйте в этот каталог рабочие токены, OAuth-данные и другие секреты.

Шаблоны проектов

Шаблоны позволяют быстро создавать проекты с заранее подготовленной структурой, настройками контейнера и метаданными портала.

Основные требования

• В шаблоне не должно быть секретов и пользовательских данных.
• Проект должен запускаться стандартной командой.
• Обязательны README.md и описание переменных окружения.
• Порты и точки запуска должны быть явно указаны.

Полезный софт

• VS Code / code-server — разработка в браузере.
• Git — контроль версий.
• Docker — изоляция и запуск проектов.
• Claude Code — AI-помощник разработчика.
• curl — проверка HTTP и API.
• jq — обработка JSON в терминале.

Полезные ссылки

Здесь будут размещаться проверенные ссылки на внутренние ресурсы, документацию сервисов и репозитории Energoskan.

• Репозиторий Energoskan Dev Portal.
• Документация Bitrix24 REST API.
• Документация Docker.
• Документация Git.
• Документация используемых AI-инструментов.

Частые проблемы и решения

VS Code открыл пустую страницу

Подождите несколько секунд и откройте его повторно. Затем проверьте состояние контейнера проекта.

Claude возвращает ошибку 401

Проверьте авторизацию, срок действия токена и настройки ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN.

Claude возвращает ошибку 429

Это ограничение запросов или доступного тарифа. Повторите запрос позже и проверьте лимиты используемого провайдера.

Портал возвращает ошибку 502

Проверьте контейнер, upstream-сервис, proxy, nginx и системные журналы.

Изменения приложения не появились

Проверьте, что сохранены файлы, перезапущен нужный процесс и выполнена повторная публикация.