﻿Cut Planner 1.0.0 — установка на Linux
Вариант поставки: без .NET (требуется установленный .NET 10)

═══════════════════════════════════════════════════════════════════════════

1. ЧТО НУЖНО

   64-разрядный дистрибутив Linux (x86-64) с графической оболочкой.
   Проверено на Ubuntu 24.04 LTS.

   Установленный .NET 10 Runtime. Нужен именно базовый «.NET Runtime»
   (Microsoft.NETCore.App) — ASP.NET Core Runtime и SDK не требуются.

   Проверить, что уже стоит:

       dotnet --list-runtimes

   В выводе должна быть строка вида:

       Microsoft.NETCore.App 10.0.x [/usr/share/dotnet/shared/...]

   Если её нет, поставьте рантайм.

   Ubuntu 24.04 и новее, Debian 13:

       sudo apt install dotnet-runtime-10.0

   Fedora, RHEL:

       sudo dnf install dotnet-runtime-10.0

   Дистрибутив, где пакета нет (в том числе Astra Linux, РЕД ОС, ALT):

       curl -sSL https://dot.net/v1/dotnet-install.sh -o dotnet-install.sh
       sh dotnet-install.sh --channel 10.0 --runtime dotnet
       export PATH="$HOME/.dotnet:$PATH"

   Если ставить рантайм нельзя или не хочется — возьмите вариант
   «со встроенным .NET»: он крупнее, но не требует ничего.

   Кроме рантайма нужны системные библиотеки, которые почти всегда уже стоят:

   Debian, Ubuntu, Astra Linux, ALT (apt):

       sudo apt install libicu74 libx11-6 libice6 libsm6 libfontconfig1 \
                        fonts-dejavu-core

   Fedora, РЕД ОС, RHEL (dnf):

       sudo dnf install libicu libX11 libICE libSM fontconfig \
                        dejavu-sans-fonts

   Шрифты DejaVu (или Liberation) нужны для экспорта в PDF: без них
   отчёт не сформируется, а программа скажет об этом прямо.

2. РАСПАКОВКА

       tar -xzf cut-planner-1.0.0-linux-x64-dotnet-required.tar.gz
       cd cut-planner-1.0.0

3. ЗАПУСК БЕЗ УСТАНОВКИ

       chmod +x ./CutPlanner
       ./CutPlanner

4. УСТАНОВКА ДЛЯ ПОВСЕДНЕВНОЙ РАБОТЫ

   Скрипт установки кладёт программу в домашний каталог, права
   администратора ему не нужны:

       sh ./install.sh

   Что он делает:

       ~/.local/lib/cut-planner/                        сама программа
       ~/.local/bin/cut-planner                         команда запуска
       ~/.local/share/applications/cut-planner.desktop  ярлык в меню
       ~/.local/share/icons/.../cut-planner.png         значок

   После установки программа запускается из меню приложений или командой:

       cut-planner

   Если оболочка отвечает «command not found», значит ~/.local/bin не входит
   в PATH. Добавьте строку в ~/.profile и перезайдите в систему:

       export PATH="$HOME/.local/bin:$PATH"

   Установка на всю машину (нужен root):

       sudo PREFIX=/usr/local sh ./install.sh

5. ПРОВЕРКА ПОДЛИННОСТИ АРХИВА

       sha256sum cut-planner-1.0.0-linux-x64-dotnet-required.tar.gz

6. ГДЕ ЛЕЖАТ ВАШИ ДАННЫЕ

   Текущий проект, настройки и журналы:

       ~/.config/CutPlanner

   Проекты, которые вы сохраняете сами, лежат там, где вы их сохранили.
   Удаление программы эту папку не трогает.

7. ОБНОВЛЕНИЕ

   Распакуйте новый архив и снова выполните install.sh — файлы заменятся,
   данные и настройки сохранятся.

8. УДАЛЕНИЕ

       ~/.local/lib/cut-planner/uninstall.sh

   Рантайм .NET остаётся в системе — он общий для всех программ на .NET.

9. ЕСЛИ НЕ ЗАПУСКАЕТСЯ

   • «You must install .NET to run this application» — рантайм не найден.
     Вернитесь к пункту 1.
   • «Permission denied» — не выставлен бит исполнения: chmod +x ./CutPlanner
   • «error while loading shared libraries» — не хватает библиотеки из
     пункта 1; имя недостающей библиотеки указано в самом сообщении.
   • Окно не появляется в сеансе Wayland — попробуйте запустить с X11:
     GDK_BACKEND=x11 ./CutPlanner
   • Загляните в журнал: ~/.config/CutPlanner/logs
   • Напишите в канал поддержки и приложите журнал:
     https://max.ru/join/AF8dc5pLf9SHd-PcLAOGYgzHV16v-ut5QbQvmjOnuXc

10. ЛИЦЕНЗИЯ

   Условия использования — в файле LICENSE.md рядом с программой,
   а также в справке программы по клавише F1.

   Коротко: физическим лицам и организациям до 100 работников — бесплатно
   и бессрочно, включая коммерческое использование.
