# Кадастр в AutoCAD — установка0.2.0

Комплект подготовлен для полного настольного AutoCAD2020–2026 на Windows/macOS.
**Статус: кандидат для проверки в AutoCAD; настоящий AutoCAD в этой сессии не запускался.**
AutoCAD LT2020–2023 Windows и AutoCAD LT Mac не поддерживают нужный AutoLISP-контракт.
ОС должна поддерживаться вашей версией AutoCAD. «Любая Windows/macOS» не означает
несовместимые с самой CAD системой выпуски. На Windows нужен curl в System32
(есть в современных Windows10/11); на macOS используется системный curl.

## Установка пользователем
1. Распакуйте архив целиком. Windows: запустите Install-Windows.cmd;
   Mac: Install-macOS.command. На Mac при запрете запуска скачанного файла используйте
   штатное подтверждение доверия владельцем через Finder/настройки ОС; защиты не отключать.
2. Перезапустите AutoCAD. Откройте Kadastr на панели либо выполните KADASTR.
   Если автовагрузка отключена вашим администратором, загрузите Contents/bootstrap.lsp
   через APPLOAD из установленного Kadastr.bundle по правилам доверенных путей организации.
3. Первый запуск: HTTPS-адрес сервиса и код активации, выданный владельцем сервиса.
   Плагин определяет ОС/версию AutoCAD сам; токен сохраняется в профиле текущего пользователя.

На Windows создаётся небольшая панель Kadastr. На Mac один раз откройте CUI,
создайте команду с макросом `^C^C_KADASTR ` и добавьте кнопку в Tool Sets.
Автоматическое создание кнопки Mac не подтверждено API Autodesk; инструкция этого не скрывает.
Пакет не меняет SECURITY/SECURELOAD/LISPSYS, файлы acad.lsp и настройки запуска других плагинов.

## Работа
Нажмите кнопку. Два режима:
- **Вся область геоподосновы**: рамка геометрии пространства модели, включая поддерживаемые
  блоки/ссылки, без ранее нанесённых слоёв KADASTR и таблиц. Рамка — приближение,
  посторонние объекты расширяют область; неподдерживаемая геометрия вызывает предупреждение/отказ.
- **Вдоль трассы**: выделенные LINE/полилинии либо все линии указанного слоя.
  Расстояние — в каждую сторону, включая округлённые торцы:20 м означает область ±20 м,
  полную ширину40 м.0 м означает только пересечение/касание оси. Дуги учитываются.

Укажите метрическую СК чертежа и масштаб подписей. Затем плагин получает результаты по интернету:
границы на цветных слоях, номер участка (форма собственности), таблица справа от геоподосновы,
XLSX рядом с DWG. Для несохранённого чертежа появляется выбор файла. Старый Excel не перезаписывается.
Таблица — переносимая сетка LINE/MTEXT, а не зависимый от платформы объект ActiveX Table.
После начала расчёта сервер выполнит задание даже при закрытии AutoCAD.
При обрыве/отмене выполните KADASTR_RESUME: повторный анализ не требуется.
Во время ожидания текущая команда AutoCAD занята; фоновая палитра — последующее улучшение.

Цвета: частные — жёлтый; федеральные — красный; субъекта РФ — пурпурный;
муниципальные — зелёный; государственные без уточнения — синий; смешанные — оранжевый;
нет сведений — серый. Неизвестная собственность не вычисляется. Внутренние кольца сохраняются.
МСК пока не подтверждены на контрольных точках владельца: инженер проверяет координаты.

Mac2020 открывает нативные системные диалоги; Mac2021+ использует DCL.
Legacy Windows2020/LISPSYS0 использует английское меню (ASCII); русские подписи CAD передаются
DXF Unicode escapes. В новых Unicode-движках меню русское. Не менять LISPSYS автоматически.

## Подключение сервиса — для владельца
В публичных установках API плагина **по умолчанию выключен**. До выкладки требуется отдельный
проверенный HTTPS-доступ к `/api/plugin/v1` на выбранном сервере; включение `KADASTR_PLUGIN_ENABLED=1`
для API, тот же постоянный KADASTR_WORK_DIR у API/worker. CRM actor и cookie портала для плагина
не используются: собственная Bearer-активация. Доступ к результатам только своей установке.
Адрес — корень подключённого приложения (например https://HOST/kadastr-app), не страница /kadastr.
Опубликовано13–14.10.2026: скачивание доступно в живых CRM/портале; защищённый API
работает на https://xn--e1anog9b.online/kadastr-app. На CRM API активация выключена.
Этот адрес уже предложен в меню первого подключения. Код выдаёт администратор.

Веб-модуль включает одинаковую кнопку для CRM и портала. Архив выбирает ОС браузера;
рядом есть явные ссылки Windows/macOS, если скачиваете для другого компьютера.

Управление пока через локальную команду администратора на выбранном сервере:

```sh
kadastr-plugin-admin --db "$KADASTR_WORK_DIR/plugin.sqlite3" issue-code --max-installs 1
kadastr-plugin-admin --db "$KADASTR_WORK_DIR/plugin.sqlite3" stats
kadastr-plugin-admin --db "$KADASTR_WORK_DIR/plugin.sqlite3" revoke INSTALLATION_ID
kadastr-plugin-admin --db "$KADASTR_WORK_DIR/plugin.sqlite3" renew INSTALLATION_ID --until 2027-01-01T00:00:00+00:00
kadastr-plugin-admin --db "$KADASTR_WORK_DIR/plugin.sqlite3" set announcement 'Новая информация для пользователей'
kadastr-plugin-admin --db "$KADASTR_WORK_DIR/plugin.sqlite3" set latest_version 0.3.0
kadastr-plugin-admin --db "$KADASTR_WORK_DIR/plugin.sqlite3" set update_url https://HOST/PLUGIN-DOWNLOAD
```

Коды активации и токены — секреты: не копировать в переписку, Git и отчёты.
Сервер хранит только их хэши. На клиенте токен — файл доступа в личном профиле,
Mac-каталог700, Windows — ACL профиля; не переносить auth.conf другому пользователю.
Учёт содержит ID активации, ОС/версии, время, режим/расстояние, серверный статус/число участков,
и отдельный сигнал клиента «нанесено». Имени DWG/содержимого чертежа в аналитической базе нет.
Геометрия расчётных заданий хранится отдельно в папке jobs; это необходимый вход расчёта, не аналитика.
Число установок — уникальные активированные профили, не доказанное число физически установленных копий.
Сигнал нанесения заявляет клиент; серверное завершение считается независимо и без дублей.
Срок лицензии/отзыв работают; платежи и кабинет продаж ещё не подключены.
Уведомление показывается при следующем запуске плагина. Закрытый AutoCAD не получает push.
Обновление — уведомление и новая установка пакета; удалённые команды и автоисполнение не допускаются.

В будущем панель администратора/биллинг могут использовать PluginStore и версионированный API:
место размещения и интерфейс владелец ещё не выбрал. Бизнес-логика отделена от UI и CAD.

## Источники совместимости Autodesk
- DCL Mac появился2021: https://help.autodesk.com/cloudhelp/2021/ENU/AutoCAD-MAC-WhatsNew/files/GUID-398836D1-D64F-41F0-9C49-24CCF84C15F1.htm
- Папки bundle Windows/Mac: https://help.autodesk.com/cloudhelp/2020/ENU/AutoCAD-Customization/files/GUID-5E50A846-C80B-4FFD-8DD3-C20B22098008.htm
- Кнопка Mac Tool Sets: https://help.autodesk.com/cloudhelp/2024/ENU/AutoCAD-MAC-Customization/files/GUID-67D7996E-1258-44A1-8EB3-0B9EB31959A3.htm
