Репозитории GitLab¶
GitLab: git.karmann.tech
Всего: 26 активных репозиториев (23 в группе vpn/, 3 в группе devops/) + 29 архивных.
vpn/ — 22 репозитория¶
Бэкенд и сервисы¶
| Репо | ID | Ветка | Описание |
|---|---|---|---|
| Back | #33 | main |
API-сервер (Spring Boot). Blue-green деплой, auto CI/CD. |
| vpn-config-service | #55 | main |
VCS (FastAPI + worker). Деплой: push → CI → ручной deploy_prod. Перенесён из back/ → vpn/ 23 Mar 2026. |
| docs | #63 | main |
DevOps скрипты и диагностика. Каталог скриптов. |
| xray-health-checker | #62 | main |
VLESS probe-сервис. Развёрнут на 10.99.87.51:8001. |
| audit-bot | #56 | main |
Telegram audit-bot для мониторинга изменений. |
| telegram-user-bot | #58 | main |
@shivaru_bot — пользовательский Telegram бот. |
| firebase-remote-config | #44 | main |
Firebase Remote Config управление. |
Клиенты¶
| Репо | ID | Ветка | Описание |
|---|---|---|---|
| Android | #31 | main |
Android-клиент (Kotlin). |
| Ios | #32 | main |
iOS-клиент (Swift). |
| desktop-alpha | #59 | main |
Desktop-клиент (Tauri + Rust). Наш форк (fixmelabs.com). Локально: desktop-alpha/. |
| Desktop | #38 | main |
Оригинальный desktop-клиент. Не трогать — upstream от оригинальных разработчиков. |
XUI¶
| Репо | ID | Ветка | Описание |
|---|---|---|---|
| 3x-ui-xray project | #36 | main |
Форк XUI (кастомные патчи ShivaVPN). |
Фронтенд (group-frontend) — 10 репозиториев¶
Все фронтенд-репо — отдельные git-репозитории (не submodule), каждый со своим CI/CD и GitLab-проектом. Локально находятся в .gitignore основного monorepo.
| Репо | ID | Описание |
|---|---|---|
| Frontend | #37 | Основной сайт (Next.js). |
| Admin Front | #39 | Админка (React). Деплой: MANUAL update_service_prod. |
| Lk Front | #40 | Личный кабинет. Доступен на shiva-app.io/account (nginx → vpn-lk на 10.99.87.63:8082). |
| frontent_payment_widget | #53 | Виджет оплаты. |
| frontend_common | #51 | Общие компоненты для фронтенда. |
| frontend_ui_kit | #52 | UI Kit. |
| new_partner_land | #43 | Партнёрский лендинг. |
| front_land_ru | #42 | RU лендинг (shiva-app.io, shiva-vpn.app). |
| front_marketing | #64 | Маркетинговый лендинг (shiva-app.com). |
| frontend_ios_land | #50 | iOS лендинг. |
| partner_land (#46), front_partners (#41) | — | Старые партнёрские лендинги (устаревшие). |
devops/ — 3 репозитория¶
| Репо | ID | Ветка | Описание |
|---|---|---|---|
| shiva-ansible | #54 | main |
Ansible IaC — источник истины для инфраструктуры. 257 хостов, 18 групп. |
| Documentation | #60 | main |
Этот wiki (MkDocs). CI/CD: push → auto deploy на wiki.shiva-app.io. |
| manage | #34 | main |
Вспомогательные скрипты управления. |
Архивные репозитории (29 штук)¶
Заархивированы 23 Mar 2026. Все они — legacy:
- karmann/ — инфраструктурные репо под Karmann (10 шт.)
- ura/ — устаревшие репо раннего периода (8 шт.)
- back-micro/ — попытка микросервисной архитектуры (11 шт.), заморожена
Архивные репо доступны только для чтения, новые MR/issues не принимаются.
Конвенция имён¶
| Тип | Формат | Пример |
|---|---|---|
| Бэкенд/сервисы | kebab-case |
vpn-config-service, audit-bot |
| Фронтенд (старые) | snake_case |
frontend_common, front_land_ru |
| Фронтенд (новые) | kebab-case |
admin-front, lk-front |
| Клиенты | PascalCase / single word |
Android, Ios, Desktop |
| DevOps | kebab-case |
shiva-ansible |
Новые репо создавать в vpn/ или devops/ в kebab-case.
Ключевые заметки¶
- vpn-config-service перенесён из
back/→vpn/23 Mar 2026. Все старые ссылки наback/vpn-config-service— неактуальны. - Desktop #38 (оригинал) и desktop-alpha #59 (наш форк) — два разных репозитория. Вся разработка ведётся только в
desktop-alpha. - Локальная копия
shivavpnmonorepo — не git submodule:frontend/,lk_front/,payment-widget/добавлены в.gitignoreкак независимые git-репо. - Вся инфраструктура управляется через
devops/shiva-ansible(Ansible). Прямыеdocker runна продакшн-серверах — недопустимы.