Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/RELEASE_POLICY.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Automatic release policy for generated 4FusionLab Fusion add-ins

[Русская версия](RELEASE_POLICY.ru.md)

- Trigger: direct push or merged PR to `main`, but only when shipped paths in `.github/release-paths.txt` changed. A `workflow_dispatch` or PR validation run is always read-only.
- The initializer is one-time; it generates stable Fusion UUIDs and does not publish an initial Hello World release.
- GitVersion.Tool 6.8.2 derives `MAJOR.MINOR.PATCH` from full Git history. Use Conventional Commits. CI builds the versioned ZIP and SHA-256, stamps its embedded manifest and verifies it with shared 4FusionLab Actions.
Expand Down
11 changes: 11 additions & 0 deletions .github/RELEASE_POLICY.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# Политика автоматических релизов созданных аддонов 4FusionLab для Fusion

[English](RELEASE_POLICY.md)

- Запуск: прямой push или объединение PR в `main`, но только при изменении поставляемых путей из `.github/release-paths.txt`. Запуски `workflow_dispatch` и проверка PR всегда работают только на чтение.
- Инициализатор запускается один раз; он создаёт стабильные UUID Fusion и не публикует первоначальный релиз Hello World.
- GitVersion.Tool 6.8.2 определяет `MAJOR.MINOR.PATCH` по полной истории Git. Используйте Conventional Commits. CI собирает версионированный ZIP и SHA-256, проставляет версию вложенного манифеста и проверяет его общими Actions 4FusionLab.
- Автономные тесты на Linux, macOS и Windows должны пройти успешно. Это **не** подтверждает приёмку в самом Fusion.
- Право записи содержимого есть только у задания релиза. Оно автоматически создаёт ранее не существовавшие неизменяемые тег `vMAJOR.MINOR.PATCH` и GitHub Release. Не отправляйте теги вручную и не перезаписывайте теги, релизы или артефакты.
- Изменения только README, документации, тестов, workflows, `AGENTS.md`, политик или GitVersion не должны вызывать публикацию.
- Общие Actions закреплены за проверенным коммитом `ad9d60ba4aabc494b4f2c85d6c566a50ca423751` в 4FusionLab/.github. См. [общую платформу релизов](https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md).
2 changes: 2 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# 4FusionLab Fusion add-in development contract

[Русская версия](AGENTS.ru.md)

Read [4FusionLab shared engineering rules](https://github.com/4FusionLab/.github/blob/main/AGENTS.md) and [the release platform](https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md) first.

## Working model
Expand Down
30 changes: 30 additions & 0 deletions AGENTS.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Правила разработки аддонов 4FusionLab для Fusion

[English](AGENTS.md)

Сначала прочитайте [общие инженерные правила 4FusionLab](https://github.com/4FusionLab/.github/blob/main/AGENTS.md) и [платформу релизов](https://github.com/4FusionLab/.github/blob/main/RELEASE_PLATFORM.md).

## Порядок работы

- Это аддон Autodesk Fusion на Python. Начальный пакет — `FusionAddin/`; инициализатор заменяет его имя и создаёт стабильные идентификаторы.
- Обсуждайте требования и планы на русском. Для команд, элементов управления и диагностики Fusion и стабильных имён API используйте понятный английский. Поддерживайте отдельные английский и русский README.
- Считайте официальную документацию Autodesk Fusion API источником истины. Никогда не выдумывайте символы SDK; успешный автономный CI сам по себе не означает приёмку CAD.
- Расчёты и предметные правила размещайте в `FusionAddin/core.py` или модулях, которые **не импортируют adsk**. Взаимодействия с Fusion API относятся к адаптерам, обработчикам событий и командам, выполняемым в разрешённом контексте Fusion.
- Делайте команды безопасными: проверяйте активный документ, объекты, единицы, параметры и состояние таймлайна; используйте нативный предпросмотр, где применимо. Никогда не изменяйте CAD-данные пользователя в тестах или без явного действия командой.
- Сохраняйте экземпляры обработчиков событий на время работы; в `stop(context)` отсоединяйте элементы интерфейса и определения команд. После начального создания сохраняйте идентификаторы стабильными. Избегайте глобального состояния, связанного с устаревшими документами.
- Добавляйте значимые модульные и автономные интеграционные тесты. Когда это важно, отдельно проверяйте реальные сценарии Fusion на Windows/macOS; сообщайте, что фактически проверено, а что нет.

## Версии и публикация

- `python scripts/init_addin.py --name NewAddin` выполняется **один раз**; никогда не создавайте заново UUID манифеста или ID команд существующего продукта.
- Для версии используются GitVersion.Tool **6.8.2**, Conventional Commits и закреплённые общие Actions. Прямой push или объединение PR в `main` запускает релиз **только** для поставляемых путей из `.github/release-paths.txt`.
- До публикации должны пройти все проверки. Изменения документации, тестов и CI не публикуют новый релиз. Не создавайте теги вручную, не перезаписывайте опубликованные ZIP и не перемещайте существующие теги.
- Только задание публикации имеет `contents: write`. Версия ZIP, встроенного манифеста, контрольные суммы и заметки релиза должны совпадать. ZIP должен устанавливаться как папка Fusion Add-in.
- Не коммитьте учётные данные, частные CAD-файлы, ключи подписи, созданные платформой артефакты и пользовательские пути. Перед публичным распространением проверьте лицензирование репозитория.

## Команды

- Автономные тесты: `python -m unittest discover -s tests -v`.
- Валидатор проекта: `python scripts/check_project.py`.
- ZIP продукта: `python scripts/build.py --version 0.1.0`.
- Контрольный список ручной CAD-приёмки: `docs/DEVELOPMENT.md`.
2 changes: 2 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Contributing to 4FusionLab add-ins

[Русская версия](CONTRIBUTING.ru.md)

Welcome! Keep contributions focused, testable, and safe to run in Autodesk Fusion.

- Discuss breaking CAD/UX changes before implementing.
Expand Down
16 changes: 16 additions & 0 deletions CONTRIBUTING.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Участие в разработке аддонов 4FusionLab

[English](CONTRIBUTING.md)

Добро пожаловать! Изменения должны быть целенаправленными, проверяемыми и безопасными для запуска в Autodesk Fusion.

- Обсуждайте несовместимые изменения CAD-поведения и интерфейса до реализации.
- Предпочитайте один небольшой PR на каждое логическое изменение и Conventional Commits (`feat:`, `fix:`, `perf:`, `docs:`, `refactor:`).
- Держите предметную логику независимой от среды Autodesk и покрывайте её значимыми автономными тестами.
- Не добавляйте в репозиторий модели клиентов, учётные данные, ключи и абсолютные пути пользователей.
- Локально запускайте `python -m unittest discover -s tests -v` и `python scripts/build.py --version 0.1.0`; CI проверяет три операционные системы.
- Различайте результаты автономных тестов и фактическую приёмку CAD-сценариев в Fusion.
- При изменении пользовательского поведения обновляйте обе языковые версии README.
- Изменения исполняемых компонентов, объединённые с `main`, публикуются автоматически только после успешного CI; не создавайте теги релизов вручную.

Полный порядок работы описан в [руководстве разработчика](docs/DEVELOPMENT.ru.md).
4 changes: 2 additions & 2 deletions README.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

<p align="center"><a href="https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0"><strong>Скачать экспериментальную версию 1.0.0</strong></a> · <a href="README.md">English</a> · <a href="https://github.com/4FusionLab/Mesora/issues">Сообщить о проблеме</a></p>

> **Экспериментальная версия: используйте только тестовые документы.** Безопасность сохранения и повторного открытия не подтверждена. Не сохраняйте документы при включённой сборке: CustomGraphics в Fusion может оставить недоступный постоянный артефакт даже после удаления графики. Реализованное удаление перед сохранением и восстановление после него не проверены и не гарантируют безопасность. Подробнее — в [исследовании](docs/fusion-safety.md).
> **Экспериментальная версия: используйте только тестовые документы.** Безопасность сохранения и повторного открытия не подтверждена. Не сохраняйте документы при включённой сборке: CustomGraphics в Fusion может оставить недоступный постоянный артефакт даже после удаления графики. Реализованное удаление перед сохранением и восстановление после него не проверены и не гарантируют безопасность. Подробнее — в [исследовании](docs/fusion-safety.ru.md).

## Измерения в контексте модели

Expand Down Expand Up @@ -37,7 +37,7 @@ python3 scripts/check_project.py
python3 scripts/build.py --version 1.0.0
```

[Безопасность и результаты проверок](docs/fusion-safety.md) · [Разработка](docs/DEVELOPMENT.md) · [Участие в разработке](CONTRIBUTING.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues)
[Безопасность и результаты проверок](docs/fusion-safety.ru.md) · [Разработка](docs/DEVELOPMENT.ru.md) · [Участие в разработке](CONTRIBUTING.ru.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues)

Mesora распространяется по [PolyForm Noncommercial License 1.0.0](LICENSE). Коммерческое использование за пределами разрешённых лицензией случаев возможно по отдельной договорённости с правообладателем; свяжитесь с 4FusionLab.

Expand Down
4 changes: 2 additions & 2 deletions README_RU.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

<p align="center"><a href="https://github.com/4FusionLab/Mesora/releases/tag/v1.0.0"><strong>Скачать экспериментальную версию 1.0.0</strong></a> · <a href="README.md">English</a> · <a href="https://github.com/4FusionLab/Mesora/issues">Сообщить о проблеме</a></p>

> **Экспериментальная версия: используйте только тестовые документы.** Безопасность сохранения и повторного открытия не подтверждена. Не сохраняйте документы при включённой сборке: CustomGraphics в Fusion может оставить недоступный постоянный артефакт даже после удаления графики. Реализованное удаление перед сохранением и восстановление после него не проверены и не гарантируют безопасность. Подробнее — в [исследовании](docs/fusion-safety.md).
> **Экспериментальная версия: используйте только тестовые документы.** Безопасность сохранения и повторного открытия не подтверждена. Не сохраняйте документы при включённой сборке: CustomGraphics в Fusion может оставить недоступный постоянный артефакт даже после удаления графики. Реализованное удаление перед сохранением и восстановление после него не проверены и не гарантируют безопасность. Подробнее — в [исследовании](docs/fusion-safety.ru.md).

## Измерения в контексте модели

Expand Down Expand Up @@ -37,7 +37,7 @@ python3 scripts/check_project.py
python3 scripts/build.py --version 1.0.0
```

[Безопасность и результаты проверок](docs/fusion-safety.md) · [Разработка](docs/DEVELOPMENT.md) · [Участие в разработке](CONTRIBUTING.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues)
[Безопасность и результаты проверок](docs/fusion-safety.ru.md) · [Разработка](docs/DEVELOPMENT.ru.md) · [Участие в разработке](CONTRIBUTING.ru.md) · [Сообщить о проблеме](https://github.com/4FusionLab/Mesora/issues)

Mesora распространяется по [PolyForm Noncommercial License 1.0.0](LICENSE). Коммерческое использование за пределами разрешённых лицензией случаев возможно по отдельной договорённости с правообладателем; свяжитесь с 4FusionLab.

Expand Down
2 changes: 2 additions & 0 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Security policy

[Русская версия](SECURITY.ru.md)

Please do not publish vulnerabilities, secrets, license keys, customer models, or unredacted diagnostic logs in public issues.

Use GitHub's private vulnerability reporting for this repository when enabled, or contact a repository maintainer privately through the 4FusionLab organization. Include affected versions, reproducible steps and impact, without posting sensitive artifacts.
Expand Down
9 changes: 9 additions & 0 deletions SECURITY.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Политика безопасности

[English](SECURITY.md)

Не публикуйте уязвимости, секреты, лицензионные ключи, модели клиентов и необезличенные диагностические журналы в открытых обращениях.

Используйте закрытую отправку отчётов об уязвимостях GitHub для этого репозитория, если она включена, либо свяжитесь с сопровождающим проекта через организацию 4FusionLab в частном порядке. Укажите затронутые версии, шаги воспроизведения и последствия, не публикуя конфиденциальные материалы.

При сборке намеренно отклоняются файлы, похожие на содержащие секреты, и символические ссылки. Эта проверка не заменяет ревью кода или реальную проверку в Autodesk Fusion.
2 changes: 2 additions & 0 deletions docs/DEVELOPMENT.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Mesora development

[Русская версия](DEVELOPMENT.ru.md)

`Mesora/Mesora.py` contains the Fusion command and event lifecycle; `Mesora/renderer.py` handles graphics, and `Mesora/dimensions/` contains measurement and layout logic. The top-level `dimensions/` directory is retained as historical offline code; the shipped package is `Mesora/`.

## Offline checks and package
Expand Down
Loading
Loading