Initial commit: QInventor CAD workbench for Windows

docs/workflows.md

@@ -0,0 +1,233 @@
+# Рабочие процессы QInventor
+
+## Общая таблица параметров
+
+Кнопка **3D-модель → Параметры** открывает параметры всего активного документа;
+предварительно выделять деталь не нужно. Завершите редактирование эскиза или
+панели операции перед применением таблицы.
+
+Таблица показывает объект, имя параметра, единицы, формулу/значение,
+вычисленный результат и комментарий. Она включает размеры эскизов, свойства
+операций и нативные наборы переменных. Справочные и недоступные в текущем
+режиме свойства доступны для чтения. Имена модельных свойств сохраняются для
+стабильности выражений; пользовательские параметры можно переименовать.
+
+1. Нажмите **Добавить параметр**, задайте имя, тип и значение. Поддерживаются
+   длина, угол и безразмерное число; например `Width = 40 mm` и `Depth = 20 mm`.
+2. В строке нужного размера введите выражение, например
+   `QIUserParameters.Width / 2` для радиуса и `QIUserParameters.Depth` для
+   длины выдавливания. Ссылку выбранной строки можно скопировать снизу окна.
+   Параметры одного набора могут ссылаться друг на друга: `Width / 2`.
+3. Нажмите **Применить**. Новые переменные и связи можно задать одним
+   применением; модель перестраивается, изменения образуют один шаг отмены.
+4. Исправьте поле в том же окне, если получена ошибка единиц, циклической
+   зависимости, решателя или геометрии. Отклонённый набор сохраняет модель
+   и историю Undo/Redo. Закрытие окна отбрасывает неприменённые правки.
+
+Переименование пользовательской переменной обновляет её штатные зависимости.
+Удаление используемого параметра отклоняется, пока его потребители не удалены
+или не перевязаны в том же наборе изменений. Комментарии сохраняются в FCStd
+и участвуют в отмене. Для связей между документами предварительно сохраните
+оба проекта; внешние потребители пересчитываются вместе с источником.
+
+Чертёж и его спецификация могут существовать до изменения параметров детали.
+Обычные таблицы, управляющие геометрией, сохраняют свои связи; выходной лист
+спецификации нельзя использовать как вход модели. Если изменение меняет тип
+вычисленной ячейки таблицы, например с целого на дробное число, оно отклоняется
+до применения: штатная отмена FreeCAD не восстанавливает такую ячейку корректно.
+Формулы пользователя при этом сохраняются.
+
+После изменения модели вне таблицы нажмите **Обновить**. Эта кнопка загружает
+актуальные значения и сбрасывает неприменённые правки окна. Если в таблице
+остались правки, применение устаревших строк блокируется с пояснением;
+так старый индекс ограничения не изменит другой размер после правки эскиза.
+Поиск скрывает строки, а удаление действует только на выбранную видимую строку.
+
+## Размеры и эскизы
+
+Создание эскиза — явная операция с выбором плоскости или плоской грани.
+Редактор содержит геометрию и список ограничений; зелёная геометрия указывает
+на полностью определённый эскиз. Не фиксируйте всю геометрию вместо размеров,
+если модель должна оставаться параметрической.
+
+В рабочем месте QInventor дерево закреплено слева, размеры и задачи — справа.
+Панели не перекрывают полотно. Кнопки **Завершить эскиз** и **Отменить эскиз**
+находятся в нижней строке ленты и доступны независимо от прокрутки инструментов.
+Завершение и отмена возвращают штатную камеру без повторного автоматического
+вписывания; команды вида остаются на вкладке **Вид**.
+
+Универсальный размер D выбирает длину, расстояние, угол или диаметр по
+выбранной геометрии. Расположение курсора определяет горизонтальный,
+вертикальный или наклонный размер; M переключает допустимые варианты.
+Стрелка рядом с **Размер D** открывает явный выбор: горизонтальный,
+вертикальный, длина, радиус, диаметр или угол. Справа в **Размеры эскиза**
+показаны только размеры активного эскиза, их значения, формулы и тип связи.
+Щелчок по строке подсвечивает размер; двойной щелчок или **Изменить размер**
+открывает исходный редактор значения FreeCAD. Флажок **Скрытые** добавляет
+скрытые размеры в список.
+Управляющее ограничение изменяет эскиз; справочное только измеряет. В выражениях
+доступна штатная система FreeCAD. Полностью определённые примеры имеют именованные
+размеры «Длина», «Ширина», «Радиус» и связанные свойства заготовки. Имена свойств
+`QILength` / `QIWidth` / `QIRadius` остаются стабильными для выражений.
+
+Закончите текущий инструмент Esc, затем нажмите **Завершить эскиз**. Эта
+кнопка сохраняет построение и выбирает профиль для следующей операции.
+**Отменить эскиз** восстанавливает геометрию и зависимости существующего
+эскиза до начала редактирования; при отмене нового эскиза удаляется только
+новое построение. Имена ограничений отображаются по-русски. Внутренние
+идентификаторы параметров остаются стабильными для выражений.
+При редактировании существующего эскиза последующие операции пересчитываются.
+Для пустого или незамкнутого профиля выдавливание сообщает причину ошибки.
+
+**Проецировать геометрию** переносит выбранное ребро или все контуры грани
+в открытый эскиз с сохранением связи с исходной деталью. Изменение исходной
+геометрии обновляет проекцию. В обычном режиме замкнутый контур участвует
+в профиле; режим **Вспомогательная** оставляет его для привязок и размеров.
+**Разорвать связь** превращает выбранную проекцию в независимую геометрию,
+сохраняя её текущую форму и связанные ограничения. Для проекции целой грани
+связь разрывается сразу для всех её контуров. Действие поддерживает отмену.
+
+В блоке **Изменить** находятся **Смещение геометрии**, **Зеркальное отражение**,
+**Прямоугольный массив**, **Круговой массив** и **Параметры повторений**.
+Сначала выберите геометрию открытого эскиза; Ctrl добавляет элементы к выбору.
+Диалог содержит русские поля, **Предпросмотр**, **Создать** и **Отмена**.
+Повторный предпросмотр заменяет предыдущий вариант. Отмена возвращает
+геометрию, зависимости, историю отмены и исходный признак сохранения.
+Подтверждение создаёт один шаг отмены.
+
+Смещение поддерживает окружность, отдельный отрезок и выпуклый замкнутый
+контур из отрезков. **Выбирать связанный замкнутый контур** расширяет выбор
+по совпадающим концам линий; для отдельного отрезка отключите этот флажок.
+Положительное расстояние расширяет окружность и контур, отрицательное
+уменьшает. Для отдельного отрезка положительное расстояние означает левую
+сторону в направлении от начала к концу. **Сохранить равное расстояние**
+связывает результат с исходной геометрией; без флажка получается независимая
+копия. Размер смещения остаётся настоящим управляющим ограничением эскиза.
+Дуги, сплайны, вогнутые и открытые многосегментные цепочки пока не поддерживаются.
+
+Связанные зеркала и массивы поддерживают отрезки и окружности. Ось зеркала —
+горизонтальная/вертикальная ось эскиза или его отрезок, в том числе
+вспомогательный. Если линия зеркала была включена в выбор, она служит осью
+и не копируется. Количество массива включает исходную геометрию.
+Прямоугольный массив задаётся количеством и шагом в двух перпендикулярных
+направлениях; угол поворачивает первое направление. Круговой массив задаётся
+центром, количеством и общим углом. При 360° экземпляры равномерно распределены
+по окружности без повторения исходника; при меньшем угле они включают оба
+конца сектора. Отрицательные шаг или угол меняют сторону повторения.
+Изменение размеров исходной геометрии обновляет копии, в том числе после
+сохранения и повторного открытия FCStd.
+
+**Параметры повторений** позволяет изменить уже созданную операцию.
+Шаг, угол и центр остаются редактируемыми через её управляющие размеры.
+Изменение количества или оси зеркала требует перестроения: оно разрешено,
+пока после операции не добавлена другая геометрия и её экземпляры не используются
+сторонними зависимостями. При нарушении этих условий приложение сообщает
+причину и сохраняет модель. Режим общей длины массива, подавление отдельных
+экземпляров и неортогональные направления пока не реализованы.
+Если управляющий размер связан формулой, числовой диалог не заменяет эту
+формулу и не перестраивает количество с потерей связи. Изменяйте выражение
+в редакторе ограничений эскиза; несвязанные поля операции остаются доступными.
+
+## Деталь
+
+Операции применяются к активному телу детали (Body). Для выреза профиль должен пересекать
+тело. Объединение должно давать одно связное твёрдое тело; для независимой
+геометрии выбирайте **Новое тело**. Вращение, отверстия, скругления и фаски
+открывают собственные панели параметров CAD-движка. Свойства операции и её
+профиль доступны в дереве модели. Сохранение в FCStd сохраняет историю.
+
+В **Выдавить** можно задать прямое, обратное, симметричное или двустороннее
+направление. В двустороннем режиме длины независимы. Режимы завершения:
+**По длине**, **Сквозь всё**, **До грани**, **До следующей**. Для **До грани**
+выберите плоскую конечную грань; наклонная грань обрезает объём по своей
+плоскости. **Продолжить грань** разрешает выход профиля за её края. Без этого
+флажка вся геометрия должна укладываться в выбранную грань, включая отверстия.
+**До следующей** ищет ближайшую плоскую грань, полностью перекрывающую профиль;
+криволинейные и неоднозначные опоры вызывают понятную ошибку. Изменение опоры
+перестраивает операцию. Двойной щелчок по выдавливанию открывает его параметры.
+
+## Сборка
+
+Новая сборка создаёт объект встроенной среды сборок (Assembly) и группу соединений.
+Добавьте компоненты из открытых документов, закрепите базовый компонент,
+затем выберите компоненты/элементы соединения и нужный тип связи.
+**Решить** пересчитывает сборку. Дополнительные типы соединений и симуляция
+доступны в штатной среде сборок (Assembly). Пример сборки содержит закреплённую плиту,
+неподвижный и вращающийся штифты, связанные экземпляры деталей и спецификацию.
+
+### Спецификация и физические свойства
+
+**Сборка → Спецификация** открывает состав документа без предварительного
+выделения. Выберите весь документ или нужную сборку. **Сводная** показывает
+конечные детали и их общее количество; **Структурная** сохраняет уровни
+подсборок. Количество внутри родителя и количество во всей выбранной области
+отображаются отдельно. Итоговая масса не складывает повторно массу родителя
+и его дочерних строк.
+
+Повторные экземпляры учитываются по реальным связям CAD. Одинаковые подписи
+или обозначения разных исходников не объединяют их в одну деталь. Материал
+и плотность берутся у конечных деталей; сборка из нескольких материалов
+показывает суммарную массу и среднюю плотность. Скрытие компонента само по
+себе не убирает его из состава.
+Материал назначается конечной детали или её экземпляру. Для изменения
+материалов сборки выбирайте входящие в неё детали.
+
+После изменения геометрии или материалов нажмите **Обновить**. **Экспорт CSV**
+пересчитывает выбранную область и сохраняет текущее представление. Ошибка
+источника отклоняет экспорт до замены прежнего файла. **Масса и объём** доступна
+для выбранной детали или сборки; для единственной сборки выделение не нужно.
+При создании чертежа сборки из разных материалов поле материала основной
+надписи указывает **См. спецификацию**.
+
+## Чертёж
+
+Создайте чертёж из существующей детали или сборки. QInventor добавляет
+ассоциативные виды спереди, сверху и в изометрии на собственный русский A4.
+Изменение модели обновляет проекции. Откройте страницу двойным щелчком,
+выберите нужные рёбра вида и инструмент **Размер**. Полная среда чертежей (TechDraw)
+содержит разрезы, выносные виды, аннотации и оформление. PDF/SVG/DXF сохраняют
+лист; исходный проект FCStd сохраняет редактируемую страницу.
+
+### Спецификация на листе
+
+Откройте **Чертёж → Оформление → Спецификация на листе**. Если листов несколько,
+выберите один в дереве; для единственного листа выделение не требуется.
+Если листа ещё нет, сначала создайте чертёж. Завершите активное редактирование
+детали или сборки перед работой с таблицей.
+
+В окне показаны фактические источники проекций выбранного листа. Все проекции
+должны показывать одну область состава. Спецификация относится к этой области;
+посторонние детали документа в неё не добавляются. **Сводная — только детали**
+показывает общее количество конечных деталей. **Структурная — состав сборок**
+сохраняет позиции подсборок, количество внутри родителя и общее количество.
+Итоговая масса учитывает конечные экземпляры один раз.
+
+Проверьте строки и нажмите **Разместить на листе**. Для существующей таблицы
+кнопка называется **Обновить на листе**. **Обновить предпросмотр** перечитывает
+источники и строки перед применением. **Закрыть** или Esc отменяют неприменённые
+изменения; уже применённое изменение можно отменить Ctrl+Z и повторить Ctrl+Y.
+
+После перестроения модели таблица на листе пересчитывает состав и массу.
+Для просмотра актуальных строк в открытом окне нажмите **Обновить предпросмотр**.
+Если источники проекций изменены, проверьте новый состав и явно обновите таблицу.
+Проект FCStd сохраняет таблицу и её связи. **Экспорт чертежа** сохраняет весь лист
+в PDF/SVG; DXF содержит проекции, сетку таблицы и редактируемые текстовые строки.
+Ошибка модели или таблицы отклоняет экспорт и сохраняет прежний файл.
+
+На штатном A4 помещаются до **4 строк состава в сводном** или **5 в структурном**
+режиме. Заголовок и строка «Итого» в это число не входят. Длинный текст также
+должен помещаться в столбцах, а проекции не должны перекрывать таблицу.
+При переполнении сократите область состава или
+текст исходных обозначений/наименований; приложение сохраняет прежнюю таблицу.
+
+## Обмен и восстановление
+
+STEP / IGES передают точную геометрию, но не историю эскизов другого CAD.
+STL — треугольная сетка. Пользовательские настройки отдельны от установленных
+на компьютере сред FreeCAD. Резервные FCStd1/FCBak управляются CAD-движком.
+Экспорт учитывает мировое размещение выбранной детали или сборки, включая
+преобразования родительских контейнеров. STEP сохраняет физические элементы
+массива; BREP, IGES и STL учитывают его маску элементов. Явно выбранный скрытый
+элемент экспортируется отдельно. Если маска не оставляет геометрии, экспорт
+геометрического формата отклоняется. Ошибка записи сохраняет прежний файл.
+Если приложение не запускается, сохраните `logs/launcher.log` и `logs/cad.log`.