Организация разработки

• Основные понятия
  • Решение
    • Системные требования
  • Дистрибутив сервера приложения
    • Системные требования
  • Модуль
    • Зависимости
    • Проектный модуль
  • Репозиторий библиотек
  • Комплект сборки
  • База данных
    • Системные требования
    • Конфигурация решения
    • Создание базы данных для разработки
    • Создание тестовой базы данных
    • Шаблон ландшафта
  • Файловое хранилище
• Проект
  • Структура проекта
  • Конфигурация проекта
    • Источники модуля
    • local
    • git
    • base
    • buildKit
    • Пример конфигурации
  • Конфигурация репозиториев
    • Работа в изолированной сети
  • Интеграция в vcs
    • Стратегии ветвления
  • Публикация решения
  • Публикация комплекта сборки
• Релизы
  • Решение
  • Конфигурация
  • Сервер приложения
  • Комплект сборки
  • Snapshot версия
  • Релиз прикладного модуля
    • Версия модуля
    • Типы релиза
      • Состав релиза
        • Схема базы данных модуля
        • Доменная схема
        • Расширенная схема
      • Поставочные данные модуля
      • Миграционные данные
    • Миграционные пакеты
      • Общие сведения
      • Порядок вызова
      • Миграционные задачи
        • UpTask
          • Простая задача
          • Задача с секцией orElse
          • Анонимная задача
          • Зависимости
          • Зависимости между модулями.
        • DownTask
    • Sql-скрипты миграции
      • Общие сведения
      • Описание файла скриптов
      • Пример файла скриптов
  • Инструкции
    • Создание задачи миграции
    • Создание sql-скрипта миграции
    • Выпуск новой версии
    • Установка релиза
      • Алгоритм работы
      • Сброс состояния обновления
    • Создание нового тега
• Работа с Git
  • Введение
    • Предисловие
      • Назначение
      • Аудитория
      • Содержание
      • Предварительные требования
      • Git
        • Основные определения
      • Ключевые особенности
      • Взаимодействие с Git
      • Глоссарий (ключевые термины и концепции)
    • Установка и настройка
      • Установка Git в Windows
        • Способ 1: Установка с официального сайта
        • Способ 2: Установка через пакетный менеджер Winget
      • Установка Git в ОС семейства GNU/Linux (на примере ALT Linux)
      • Установка дополнительных инструментов (рекомендуемых)
      • Первичная настройка Git
    • Дополнительная документация
      • Основные материалы по системе управления версиями Git
      • Материалы по работе с командной строкой (Terminal/Shell)
      • Документация по интеграции Git со средами разработки (IDE) и редакторами кода
      • Дополнительные рекомендованные ресурсы
  • Основные понятия Git
    • Структура репозитория
      • Введение: что такое репозиторий Git
      • Логическая структура: состояния файлов
        • Рабочий процесс работы с состоянием файлов
          • Работа через командную строку (Terminal / CLI)
          • Работа через интегрированную среду разработки (IDE)
      • Физическая структура
        • Скрипты-хуки
        • Глобальные файлы исключений
        • База данных объектов objects/*
          • Объекты
        • Система ссылок
          • Указатели
          • Конфигурационные файлы
          • Прочие важные элементы
        • Логическая структура
    • Коммит
      • Правила наименования коммитов
      • Метаданные коммита
      • Основные свойства
        • 1. Неизменяемость
        • 2. Атомарность
        • 3. Ссылочная целостность
      • Коммит и ветвление
    • Ссылки
      • Тег
        • Типы тегов
      • Ветка
        • Особенности веток
        • Ветвление веток
        • HEAD и detached HEAD
    • Ветка
      • Правила наименования веток
      • Слияние веток
      • Типы слияния
        • Fast-Forward слияние
        • Recursive слияние (трехстороннее)
        • Слияние с отклонением fast-forward (–no-ff)
      • Процесс слияния
      • Стратегии слияния
      • Лучшие практики
      • Команды слияния
    • Merge request
      • Зачем он нужен
      • Процесс работы с Merge Request
        • Шаг 1: Подготовка перед созданием MR
        • Шаг 2: Создание Merge Request
        • Шаг 3: Ревью и процесс обсуждения
        • Шаг 4: Слияние (Merge)
        • Идеальный Merge Request
  • Ответы на частые вопросы
    • Примеры рабочих процессов
      • Разработка несрочного функционала или исправлений
      • Экстренные исправления (hotfix) или срочный функционал для релизной ветки
        • Копирование экстренных исправлений в основную ветку разработки
          • Копирование одиночного коммита
          • Перенос диапазона коммитов
      • Перенос изменений в релизную ветку через rebase
      • Актуализация долгосрочных веток
      • Организация совместной разработки
        • Создание индивидуальных веток
        • Синхронизация изменений
        • Интеграция изменений в основную ветку
  • Приложение
    • Global GitFlow
      • Рекомендации по настройке окружения
      • Основные ветки
      • Вспомогательные ветки
      • Тестирование веток
      • Процесс выпуска релизов
      • Организация разработки
      • Заключение
    • Выпуск релизов ядровых модулей
      • Версионирование релизов
      • Управление задачами через релизы в Support
      • Процесс выпуска релизов
      • Примеры жизненного цикла версии
      • Организация разработки
    • Выпуск тегов ядровых модулей
      • Расписание
      • Подготовка
      • Процедура выпуска
      • Завершение выпуска
• Развёртывание рабочего места
  • Под Windows
    • Необходимые компоненты
    • Установка
    • Настройка проекта на примере pgDev
  • Под Astra Linux
    • Необходимые компоненты
    • Установка
  • Под Alt Linux
    • Необходимые компоненты
    • Установка
• Ревью Кода Scala/SQL
  • Руководство по Ревью Кода Scala/SQL (GlobalFramework)
    • 1. Метаописания и Структура Классов
      • Именование классов
      • Именование атрибутов
      • Типы атрибутов
      • Соответствие БД и метаданных
      • Связи
      • JSON/Jsonb-поля
      • Отсутствие дубликатов
    • 2. Конфигурация Модулей GSF
      • project.yaml
      • Структура каталогов
      • Зависимости
      • Конфигурации сборки/публикации
    • 3. Использование стандартных компонентов GSF
      • Использование сервисов GSF
      • Кэширование и запросы
      • Логирование
    • 4. Обработка Ошибок и Зависимости
      • Прикладные исключения
      • Объявление исключений
      • Логирование ошибок
      • Транзакции и зависимые задачи
    • 5. Особенности SQL в GSF (Валидации и Ограничения)
      • Оптимизация запросов
      • Индексы и параметры
      • Соединения и типы
      • Рекурсивные запросы
    • 6. Требования к Структуре Scala-Кода
      • Соглашения по стилю
      • D/A-паттерн кода
      • Null-типы GSF
    • 7. Общие Принципы и Стиль Кода
      • Комментарии
      • Именование
      • Форматирование
      • Scaladoc
    • 8. Безопасность и Надёжность
      • null
      • null для AnyVal
      • head / get
      • if-else / pattern-matching
    • 9. Производительность
      • .view
      • Pattern matching в комбинаторах
      • Изменяемые коллекции
      • ArrayBuffer
      • Выбор коллекции
      • Большие реестры
    • 10. Работа с API и ROP
      • HTTP-пакеты
      • Файлы
      • copyAro
      • Загрузка ROP по gid
      • Поиск по коду
      • getVar
      • Использование source-generated конструкций
    • 11. Работа с Базой Данных и SQL (Дополнения)
      • checkworkability
      • Вложенные циклы
      • onRefresh
      • @FlushBefore
      • OQuery и итерация
      • OQuery и условия
      • Интерполяция строк
      • Symbol в on
    • 12. Архитектура и Дизайн
      • lazy
      • dataInstall
      • Изменение параметров
      • Новые параметры
      • Сложная логика в AVI
      • Scala-классы с компаньоном
    • 13. Работа с Атрибутами и Полями (Дополнения)
      • Source-generated доступ
      • getSelfVar с A.idPerson.name
      • Хранимые поля в AVI
      • var в case class в onRefresh
    • 14. Строки и JSON
      • Интерполяция строк
      • .stripMargin
      • StringBuilder
      • scala.util.parsing.json
      • Btk_JsonPkg
    • 15. Специфика UI: AVI и Списочные Отображения
      • getVar / getSelfVar / A в checkWorkAbility
      • Поля с большим объёмом данных
      • @FlushBefore в LookUp
      • DefaultRep#deactivateOper
      • prepareSelectStatement
    • 16. Специфика UI: Кэширование, Логика и Настройки
      • Переходы состояний
      • @Setter(refreshAfter = true)
      • Кастомные выборки
      • onRefreshExt и id
      • AdditionalInfo
      • AdditionalInfo2
    • 17. Отражение (Reflection)
      • Обоснование
      • scala.reflect.io._
    • 18. Специфика Модулей и Проектов
      • Модуль STK
      • Модуль ACT
      • Проектные модули
    • 19. Безопасность и Целостность Данных
      • SQL-инъекции
      • Ограничения целостности
      • Валидации
      • Чувствительные данные
    • 20. Соответствие Best Practices
      • Документация
      • Чистота кода
    • 21. Красные Флаги (Блокирующие)
      • DML через ASQL
      • Долгая транзакция
      • Функции GSF в массовых выборках
      • Арифметика с N-типами
      • Конкатенация строк SQL
      • Дублирование логики
  • Чек-лист для ревью кода в GlobalFramework
    • 1. Метаописания и Структура Классов
    • 2. Конфигурация Модулей GSF
    • 3. Использование стандартных компонентов GSF
    • 4. Обработка Ошибок и Зависимости
    • 5. Особенности SQL в GSF
    • 6. Требования к Структуре Scala-Кода
    • 7. Производительность
    • 8. Работа с API и ROP
    • 9. Работа с Базой Данных и SQL (Дополнения)
    • 10. Архитектура и Дизайн
    • 11. Работа с Атрибутами и Полями (Дополнения)
    • 12. Строки и JSON
    • 13. Специфика UI: AVI и Списочные Отображения
    • 14. Специфика UI: Кэширование, Логика и Настройки
    • 15. Отражение (Reflection)
    • 16. Специфика Модулей и Проектов
    • 17. Безопасность и Целостность Данных
    • 18. Соответствие Best Practices
    • 19. Красные Флаги (Блокирующие)
• Подключение сторонних библиотек к локальному globalserver
  • Прямое подключение
• Пример содержимого project.yaml
  • Детальное описание полей конфигурации: