Artwork_Applications
/
design-ubl-settings-apps
9
0
Fork 1
Code Issues 7 Pull Requests Packages Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'e8ad16a249'
${ noResults }
design-ubl-settings-apps/ubl-settings-datetime/README.md

20 KiB
Raw Blame History Escape

ТЕХНИЧЕСКОЕ ЗАДАНИЕ на разработку утилиты ubl-settings-datetime

  1. ОПИСАНИЕ: Графическое средство настройки даты и времени в ОС UBLinux

  2. ЭТАПЫ И СРОКИ СОЗДАНИЯ ПРИЛОЖЕНИЯ:

    1. Общий срок работ по созданию приложения составляет N дней:
      1. N дня - макет и дизайн приложения и его утверждение
      2. N дней - разработка приложения
      3. N дня - тестирование приложения и исправление ошибок
    2. Перечень этапов разработки приложения:
      1. Разработка макета и дизайна приложения, самостоятельно
      2. Утверждение и доработка макета, самостоятельно
      3. Создание работающего интерфейса, включая полную разработку действующих ярлыков, кнопок и т.д., самостоятельно
    3. Проектирование алгоритма работы приложения, самостоятельно
    4. Написание работающего кода приложения, включая полноценно работающие элементы графического интерфейса, а также перевод (поддержка локализации En, Ru), самостоятельно
    5. Тестирование и исправление ошибок, самостоятельно
    6. Публикация

  3. ТЕХНОЛОГИЧЕСКИЕ ТРЕБОВАНИЯ:

    1. Приложение разрабатывается под нужды операционной системы UBLinux
    2. Использование фирменного логотипа компании
    3. Название приложения, техническое: ubl-settings-datetime
    4. Название приложения, публичное: Дата и время
    5. Стек технологий:
      1. Язык программирования: Bash или C++
      2. Приложение для разработки графического интерфейса: Glade 3
      3. Графические библиотеки: GTK3
      4. Операционная система разработки: UBLinux DB
    6. Структура:
      1. /usr/bin/ubl-settings-datetime (скомпилированный бинарный файл) Bash/C: Весь функционал сосредоточен в графической части, вызовы и исполнение процедур написаны на языках Bash, C++
      2. Файл glade скомпилирован в бинарный файл Графическая часть, фронт
      3. Файл css скомпилирован в бинарный файл Стили виджетов GTK
      4. /usr/share/ubl-settings-datetime/images/{*.png,*.svg} Элементы изображений
      5. /usr/share/ubl-settings-datetime/locale -> /usr/share/locale Локализация En/Ru

  4. ТЕХНИЧЕСКОЕ ЗАДАНИЕ:

    1. Ярлык (desktop-файл):
      1. Type: Application
      2. Exec: ubl-settings-datetime
      3. Categories: X-UBL-SettingsManager;X-UBL-SystemSettings
    2. Главное окно:
      1. Требования к внешнему виду:
        1. Адаптивный (резиновый) дизайн.
        2. Наличие элементов интерфейса:
          1. Статических - не меняют свою ширину при изменении размеров окна или родительского элемента.
          2. Динамических - меняют свою ширину при изменении размеров окна или родительского элемента. Обычно занимают пространство от края до края окна или родительского элемента, либо пространство от рядом расположенного элемента до до края окна или родительского элемента.
        3. Минимальный размер окна до прекращения масштабирования 800 на 600 пикселей.
        4. Шапка в стиле приложений GTK3 с содержимым:
          1. Иконка приложения. Статический элемент. Выравнивание по левому краю.
          2. Кнопка с выпадающим списком "Загрузить" -> ("Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию"). Статический элемент. Выравнивание по левому краю.
          3. Заголовок окна, название приложения. Выравнивание по центру между элементами.
          4. Кнопка с выпадающим списком "Сохранить" -> ("Сохранить глобальную конфигурацию, Сохранить локальную конфигурацию"). Статический элемент. Выравнивание по правому краю.
          5. Кнопка с иконкой с выпадающим списком -> "Справка, О приложении". Статический элемент. Выравнивание по правому краю.
          6. Стандартные элементы окна, кнопки "Свернуть, Минимизировать/На весь экран, Закрыть"
        5. В верхней части крупный логотип утилиты, с права от него краткое описание утилиты. Фон заполнен изображением. Статические элементы. Выравнивание по левому краю.
        6. Срока уведомления, представляющая собой полосу с инфографикой строки уведомлений. Динамический элемент. От края до края окна по горизонтали.
        7. Рабочая область.
      2. Требования к "Рабочей области". Динамический элемент. От края до края по горизонтали и вертикали окна. Выводятся группы настроек запуска:
        1. Блок с заголовком "Текущие дата и время". Динамический элемент. От края до края окна по горизонтали.
          1. лейбл "Время". Статический элемент. Выравнивание по левому краю.
          2. счётчик от 00 до 23 (часы). Статический элемент. Выравнивание по левому краю.
          3. лейбл ":" (разделитель). Статический элемент. Выравнивание по левому краю.
          4. счётчик от 00 до 59 (минуты). Статический элемент. Выравнивание по левому краю.
          5. лейбл "Дата". Статический элемент. Выравнивание по левому краю.
          6. поле ввода. Ввод даты в формате ДД.ММ.ГГГГ Статический элемент. Выравнивание по левому краю.
          7. кнопка с иконкой календаря. Вызов объекта датапикер (визуальное представление выбора даты). Статический элемент. Выравнивание по левому краю.
          8. кнопка "Синхронизировать". Синхронизация выставленных даты и времени с часами и датой системы. Неактивно, если выбраны значения "По умолчанию, DHCP, Вручную" чекбокса в блоке "Синхронизация через NTP". Динамический элемент. Выравнивание по левому краю. Делит пространство в равных долях с соседними элементами.
          9. кнопка "Синхронизировать аппаратное время". Синхронизация даты и времени с временем BIOS рабочей станции. Динамический элемент. Выравнивание по левому краю. Делит пространство в равных долях с соседними элементами.
        2. Блок с заголовком "Синхронизация через NTP". Динамический элемент. От края до края окна по горизонтали.
          1. комбобокс с вариантами выбора сервера: "Остановлено, По умолчанию, DHCP, Вручную". При выборе "По умолчанию", второе поле для ввода вручную становится заблокированным для манипуляций - текст введённого поля серый. При выборе "По умолчанию" в конфигурационный файл передаются значения: "NTPSERVERS=default". Статический элемент. Выравнивание по левому краю.
          2. поле ввода для ручного указания серверов. Неактивно, если выбраны значения "Отключено, Остановлено, По умолчанию, DHCP" комбобокса в блоке "Синхронизация через NTP". Динамический элемент. Выравнивание по левому краю. Делит пространство с соседними элементами.
        3. Блок с заголовком "Часовой пояс". Динамический элемент. От края до края окна по горизонтали.
          1. лейбл "Синхронизация аппаратного времени:". Статический элемент. Выравнивание по левому краю.
          2. комбокс с вариантами "Локальное время, Время по UTC". Динамический элемент. Выравнивание по левому краю. Делит пространство с соседними элементами.
          3. лейбл "Регион:". Статический элемент. Выравнивание по левому краю.
          4. комбобокс. Локализованный перечень регионов. Динамический элемент. Выравнивание по левому краю. Делит пространство с соседними элементами.
          5. лейбл "Зона:". Статический элемент. Выравнивание по левому краю.
          6. комбобокс. Перечень городов с поправкой на часовой пояс. Например, "(UTC +06) Омск". Перечень регионов, локализация стандартными средствами. Динамический элемент. Выравнивание по левому краю. Делит пространство с соседними элементами.

  5. ОСОБЕННОСТИ

    1. При загрузке утилиты по умолчанию загружаются данные из локального конфигурационного файла (выполняются команды блоков "Чтение значений: из локального конфигурационного файла").
    2. Функции записи в локальный конфигурационный файл и чтения-записи в глобальный конфигурационный файл должны проходить процедуру повышения привилегий прав пользователя через polkit.
    3. Кнопка "Загрузить" -> ("Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию"). При нажатии на кнопку происходит открытие меню с пунктами: "Загрузить глобальную конфигурацию, Загрузить локальную конфигурацию". Загрузка текущей и глобальной конфигурации в системе через скрипт ubconfig (выполняются команды блоков "Чтение значений: из локального конфигурационного файла"), загрузка конфигурации из файла настроек ОС ublinux.ini (выполняются команды блоков "Чтение значений: из глобального конфигурационного файла").
    4. Кнопка "Сохранить" -> ("Cохранить конфигурацию, Сохранить в глобальную конфигурацию, Сохранить в локальную конфигурацию"). Сохраняет текущие настройки через скрипт ubconfig (выполняются команды блоков "Установить значение: в локальный конфигурационный файл") и в конфигурационный файл настроек ОС ublinux.ini (выполняются команды блоков "Установить значение: в глобальный конфигурационный файл"). При выборе пунктов "Сохранить в глобальную конфигурацию, Сохранить в локальную конфигурацию" происходит отдельное сохранение настроек.
    5. Строка уведомлений. Цвет в зависимости от сигнала:
      • песочный, пиктограмма "Птичка", сообщения об удачных загрузках или сохранениях конфигураций системы.
      • красный, пиктограмма "Восклицательный знак", сообщения об ошибках при сохранении, загрузке параметров конфигурации, при ошибках в работе программы.
    6. Окно с выводом информации о программе:
      1. Заголовок окна по локализованному названию утилиты
      2. Версия берётся из main.cpp глобальной переменной в исходника: UBAPP_VERSION
      3. Копирайты, порядок:
        1. Иконка приложения
        2. Название утилиты
        3. Версия программы
        4. Название утилиты, локализованное
        5. Ссылка "Домашняя страница проекта" на https://ublinux.ru/
        6. Copyright (c) 2023 - UBSoft Software LLC

  6. КОМАНДЫ

    1. Текущие дата и время
      1. Чтение значения:
        1. через средства функции на языке Си
      2. Установить значение:
        1. счётчики часы и минуты: date +%T -s "h:m:sec" (кнопка "Синхронизировать")
        2. дата: date +%Y%m%d -s "2000:06:14" (кнопка "Синхронизировать")
      3. Синхронизировать аппаратное время:
      4. Установить значение: hwclock --systohc (кнопка "Синхронизировать аппаратное время")
    2. Синхронизация через NTP
      1. Чтение значения:
        1. из локального конфигурационного файла: /usr/bin/ubconfig --default --source system get network NTPSERVERS
        2. из глобального конфигурационного файла: /usr/bin/ubconfig --default --source global get network NTPSERVERS
      2. Установить значение:
        1. "Остановлено" в локальный конфигурационный файл: /usr/bin/ubconfig --target system set network NTPSERVERS=stop в глобальный конфигурационный файл: /usr/bin/ubconfig --target global set network NTPSERVERS=stop
        2. "По умолчанию" в локальный конфигурационный файл: /usr/bin/ubconfig --target system set network NTPSERVERS=default в глобальный конфигурационный файл: /usr/bin/ubconfig --target global set network NTPSERVERS=default
        3. "DHCP" в локальный конфигурационный файл: /usr/bin/ubconfig --target system set network NTPSERVERS=dhcp в глобальный конфигурационный файл: /usr/bin/ubconfig --target global set network NTPSERVERS=dhcp
        4. "Вручную" в локальный конфигурационный файл: /usr/bin/ubconfig --target system set network NTPSERVERS=$VALUE в глобальный конфигурационный файл: /usr/bin/ubconfig --target global set network NTPSERVERS=$VALUE где $VALUE - перечень серверов, полученных из поля в блоке "Синхронизация через NTP", разделённых "," или ";".
      3. Проверка запущенных процессов синхронизации (systemd-timesyncd, ntpd, chronyd) и остановка этих сервисов сервисов, осуществляется выполнением команды /usr/bin/ubconfig remove network NTPSERVERS при выборе опции "Остановлено" из выпадающего списка блока "Синхронизация через NTP"
    3. Часовой пояс
      1. Синхронизация аппаратного времени:
        1. Чтение значений:
          • из локального конфигурационного файла: /usr/bin/ubconfig --default --source system get clock HWCLOCK_SYNC
          • из глобального конфигурационного файла: /usr/bin/ubconfig --default --source global get clock HWCLOCK_SYNC
        2. Установить значение:
          1. "Локальное время" в локальный конфигурационный файл: /usr/bin/ubconfig --target system set clock HWCLOCK_SYNC=localtime в глобальный конфигурационный файл: /usr/bin/ubconfig --target global set clock HWCLOCK_SYNC=localtime
          2. "Время по UTC" в локальный конфигурационный файл: /usr/bin/ubconfig --target system set clock HWCLOCK_SYNC=utc в глобальный конфигурационный файл: /usr/bin/ubconfig --target global set clock HWCLOCK_SYNC=utc
      2. Комбобокс "Регион", "Зона":
        1. Чтение значений:
          • из локального конфигурационного файла: /usr/bin/ubconfig --default --source system get clock ZONE
          • из глобального конфигурационного файла: /usr/bin/ubconfig --default --source global get clock ZONE
        2. Установить значение:
          • в локальный конфигурационный файл: /usr/bin/ubconfig --target system set clock ZONE=$VALUE
          • в глобальный конфигурационный файл: /usr/bin/ubconfig --target global set clock ZONE=$VALUE где $VALUE - сложение срок-значений из комбобокса "Регион" и "Зона" через символ "/", например "Asia/Omsk".

  7. ПРИБЛИЗИТЕЛЬНЫЙ МАКЕТ ПРИЛОЖЕНИЯ.

    1. Главное окно