# QInventor для Windows

Параметрическое CAD-приложение с русской лентой, настоящими эскизами, точными
твёрдыми телами, сборками и ассоциативными чертежами. Основа — FreeCAD 1.1.4 /
Open CASCADE. Все необходимые CAD-библиотеки поставляются в `runtime`.

## Запуск

Откройте **QInventor.exe** в этой папке. Установка Python, .NET или Autodesk
Inventor не требуется. Для переноса копируйте всю папку, включая `runtime`,
`src`, `scripts`, `data/runtime-path.txt` и `examples`.

Настройки находятся в `data`, журналы запуска — в `logs`. Проекты сохраняются
в выбранную пользователем папку. `FCStd` хранит эскизы, размеры, выражения,
операции, сборки и чертежи. Для обмена геометрией используйте STEP или IGES;
для 3D-печати — STL. Исходные IPT/IAM/IDW Autodesk Inventor не поддерживаются.

## Первый эскиз и деталь

1. Нажмите **Новая деталь → Создать эскиз**.
2. Выберите XY / XZ / YZ или заранее выделите плоскую грань детали.
3. **L** — непрерывная линия, **C** — окружность. Прямоугольник и дуга — на ленте.
4. **D** — универсальный размер: выберите геометрию, разместите размерную
   линию, задайте значение. Размеры управляют геометрией; зависимости определяют
   совпадение, направление, касание и равенство.
5. **Esc** отменяет текущий инструмент. **Завершить эскиз** выходит из редактора.
6. **E** открывает выдавливание: профиль, операция, направление, длина,
   предпросмотр. Подтвердите результат.
7. Двойной щелчок по эскизу открывает редактирование. После изменения размера
   последующие операции перестраиваются. Именованные параметры примеров
   доступны также через **Параметры**.

Размеры активного эскиза собраны в отдельной панели справа: выберите строку
для подсветки или дважды щёлкните для изменения. Стрелка у **Размер D**
позволяет явно выбрать горизонтальный размер, вертикальный, длину, радиус,
диаметр или угол. Кнопки завершения и отмены закреплены под лентой;
панель задач не перекрывает рабочее поле.

Мышь: левая кнопка — выбор; колесо — масштаб; средняя — перемещение;
Shift + средняя — вращение. Ctrl+S сохраняет, Ctrl+Z / Ctrl+Y отменяют и повторяют
операцию. Подробности: [docs/workflows.md](docs/workflows.md).

## Возможности

- Общая таблица модельных и пользовательских параметров: единицы, формулы,
  вычисленные значения, комментарии, связанные размеры и отмена одним шагом.
- Эскизы на плоскостях и гранях, геометрические зависимости, управляющие и
  справочные размеры, ввод возле курсора, решатель ограничений.
- Связанные проекции рёбер и контуров грани в эскиз; преобразование проекции
  в независимую геометрию с сохранением текущего построения.
- Смещение окружностей, отрезков и выпуклых линейных контуров; связанные
  зеркала, прямоугольные и круговые массивы отрезков/окружностей с русскими
  параметрами, предпросмотром, отменой и сохранением зависимостей.
- Выдавливание, вырез, вращение, отверстия, скругления, фаски, массивы,
  зеркальное отражение; остальные операции — в исходной среде PartDesign.
- Параметрические заготовки, пластина с отверстиями, кронштейн.
- Сборки с компонентами, жёсткими/вращательными/скользящими/цилиндрическими
  соединениями и решателем; сводная и структурированная спецификация вложенных
  экземпляров, CSV и масса по материалам конечных деталей.
- Лист A4 со связанными проекциями и спецификацией:
  **Чертёж → Оформление → Спецификация на листе**. Выберите лист или откройте
  единственный лист документа, проверьте источники и сводный/структурный состав,
  затем разместите таблицу. Геометрия, количество и масса связаны с моделью;
  лист сохраняется в FCStd и экспортируется в PDF, SVG и DXF.
- Материалы, объём, масса, центр масс, сохранение истории, STEP/IGES/BREP/STL.
- Исходные среды FreeCAD доступны через **Вид → Все инструменты** и штатный
  переключатель сред. Они включают дополнительные инструменты моделирования,
  таблиц, CAM и FEM.

QInventor воспроизводит основной пользовательский процесс Inventor на другом
геометрическом ядре. Полное совпадение всех инструментов, алгоритмов решателя,
файловых форматов и поведения Inventor **не подтверждено и не заявляется**.
Границы соответствия перечислены в [docs/inventor-compatibility.md](docs/inventor-compatibility.md).

## Разработка и проверки

Цель развития, очередь работ и критерии готовности:
[docs/development-roadmap.md](docs/development-roadmap.md).

Исходный код интерфейса и сервисов находится в `src/QInventor`. В PowerShell:

```powershell
.\scripts\bootstrap.ps1
.\scripts\build-launcher.ps1
.\scripts\test.ps1
.\scripts\package.ps1
```

Тесты запускаются в отдельном профиле настоящего CAD-процесса, проверяют
геометрию, изменение размеров, сохранение/повторное открытие, STEP, эскизный
процесс, сборку и чертёж. Отчёт — `artifacts/validation.json`, изображения и
проверочные модели — `artifacts/validation`.
Полный прогон с подготовкой нативных чертежей занимает около 40 минут;
штатный лимит `scripts/test.ps1` — 60 минут.
Повреждённые циклические графы проверяются в отдельном FreeCADCmd с собственным
профилем: графический процесс не создаёт их сцену. В отчёте сохраняются
результаты проверок и код завершения дочернего CAD-процесса.

Лицензия собственного кода — MIT. Лицензии CAD-движка сохранены в `runtime`;
см. [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).