Версия: 1.3.0 (см.
Version.txt) | Платформа: Revit 2019-2025 / .NET Framework 4.8 + .NET 8 / C# 12 / WPF Последнее обновление: 2026-04-19
Этот файл — единая точка входа в документацию проекта SmartCon. AI-агент должен загрузить этот файл первым, затем подгружать нужные разделы по контексту задачи.
SmartCon — плагин для Autodesk Revit, автоматизирующий рутинные MEP-операции. Флагманский модуль — PipeConnect: соединение трубных элементов на любых видах двумя кликами с автоматическим подбором фитингов, параметров и типов соединений.
Целевой пользователь: MEP-инженер-проектировщик.
Ключевая боль: Revit не умеет удобно соединять элементы в 3D-виде — приходится тягать коннекторы и надеяться на совпадение координат в пространстве. Нет системы типов соединений (резьба/сварка/раструб). Нет умного подбора фитингов-переходников.
Загружай документы по мере необходимости. Колонка «Когда загружать» — подсказка.
| Документ | Описание | Когда загружать |
|---|---|---|
architecture/solution-structure.md |
Проекты, папки, файлы каждого слоя | Всегда при создании/перемещении файлов |
architecture/dependency-rule.md |
Правило зависимостей между слоями | Всегда |
architecture/tech-stack.md |
Стек технологий, версии, NuGet-пакеты | При настройке проекта или добавлении зависимостей |
| Документ | Описание | Когда загружать |
|---|---|---|
domain/models.md |
Все доменные классы с полными сигнатурами | При работе с моделями данных |
domain/interfaces.md |
Все интерфейсы-контракты с сигнатурами методов | При реализации или вызове сервисов |
domain/glossary.md |
Единый словарь терминов проекта | При любых сомнениях в терминологии |
| Документ | Описание | Когда загружать |
|---|---|---|
pipeconnect/state-machine.md |
Диаграмма состояний, переходы, правила | При работе с логикой PipeConnect |
pipeconnect/algorithms.md |
Алгоритмы: выравнивание, параметры, фитинги, цепочки | При реализации алгоритмов |
pipeconnect/ui-spec.md |
Спецификация UI: окна, layout, MVVM-паттерны | При работе с UI |
pipeconnect/business-cases.md |
Бизнес-кейсы: логика при разных сценариях коннекта, reducer, размеры | При реализации логики соединения |
| Документ | Описание | Когда загружать |
|---|---|---|
invariants.md |
Жёсткие правила I-01..I-13. Нарушение = баг. | ВСЕГДА |
multi-version-guide.md |
Стандарт multi-version: 10 правил, шаблоны, чеклист | При создании нового функционала |
adr/README.md |
Индекс Architecture Decision Records | При вопросах «почему так сделано?» |
roadmap.md |
Фазы разработки, зависимости, критерии приёмки | При планировании работ |
references.md |
Внешние ссылки на документацию Revit API | При работе с конкретными API |
future-work.md |
Tracking TODO-комментариев и planned features ([ChainV2], [Phase 6B]) | При работе над новыми фичами |
- Загрузи этот файл (
docs/README.md) - Загрузи
invariants.md— жёсткие правила, обязательные всегда - Загрузи
architecture/dependency-rule.md— чтобы понимать куда класть код - По задаче загружай нужные документы из карты выше
- Не создавай новые доменные классы без обновления
domain/models.md - Не создавай новые интерфейсы без обновления
domain/interfaces.md
| Модуль | Статус | Примечание |
|---|---|---|
| SmartCon.Core | ✅ Полный | Модели, интерфейсы, алгоритмы, FormulaSolver |
| SmartCon.Revit | ✅ Полный | Все Revit API реализации |
| SmartCon.UI | ✅ Полный | Тема, стили, контролы, конвертеры |
| SmartCon.App | ✅ Полный | Ribbon, DI, ExternalEvents, Updater |
| SmartCon.PipeConnect | ✅ Полный | PipeConnect: 5 partial VM, 12 сервисов, 6 окон |
| SmartCon.Tests | ✅ 676 тестов, 0 ошибок | Unit + ViewModel тесты (xUnit + Moq) |
OSS-perfection refactor (2026-04-19): Фазы A-J по плану oss-perfection-plan.md завершены.
Clean Architecture, MVVM compliance, XML-docs, ExtensibleStorage, CI matrix, dependency updates.