stepan
45065d3202
Ревью rust: перенос в вики не должен удалять из репозитория то, что нужно агенту для работы (бэклог, статус, планы, код-стайл, спеки). Дублирование вики и репы разрешено и обязательно: вики — актуальные версии для людей, docs/ — зеркало для контекста агентов. README разведён по ролям.
3.8 KiB
3.8 KiB
Дизайн: разбиение проектов на логические папки (namespace = папка)
Дата: 2026-09-11. Статус: согласовано владельцем (решения 1–5).
1. Цель
Упорядочить код по назначению: вместо «свалки» файлов разных видов в одной папке с единым
namespace — подпапки по назначению, при этом namespace соответствует пути папки.
2. Таксономия папок (по назначению)
| Папка | Что кладём |
|---|---|
Abstractions/ |
интерфейсы I*.cs |
Services/ |
прикладная логика: *Service, *WorkerService.*, *Guard, *Pacer, *Evaluator, *Counter, *Detector, *Normalizer, *Matcher, *Composer, *Cleaner, *Classifier, *Mapper, *Builder, *Writer, *Recomputer, *Suggester, *Filler, *Generator, *Hasher и аналогичные исполнители |
Models/ |
доменные типы: сущности, value-объекты, enum, статусы/виды, константные реестры (*Statuses, *Kinds, *Prefixes, *Keys, *Events, *Periods, *Sources, *Field, *Defaults) |
Dtos/ |
транспортные типы: *Dto, *Request, *Response, *Patch |
Extensions/ |
*Extensions |
Options/ |
*Options |
Exceptions/ |
*Exception |
Registrars/ |
*ModuleRegistrar |
Существующие feature-папки (ColumnRules, Parse, существующие Models) сохраняются.
3. Правила
namespaceстрого соответствует пути папки.- Имена типов и публичные контракты не меняются — только расположение и
namespace. - Один тип = один файл (уже соблюдается).
- Частичные классы (
Foo.cs,Foo.Part.cs) переносятся вместе. - Тестовые проекты группируются по областям:
Modules/<X>,Api,Infrastructureи т.п.,namespace=Deal.Tests.Unit.<Область>.
4. Механика переноса (на проект)
- Классифицировать файлы по таблице §2.
- Перенести файлы в подпапки и заменить
namespace. - Миграция
using: в файлах-потребителях заменить несуществующий старыйusing <OldNs>;наusingвсех новых подпространств (пере-добавление безопасно; при коллизии имён — ручное разрешение). Файлы внутри проекта-источника получаютusingсоседних подпространств. dotnet build→ исправить остатки (полные имена,cref),dotnet test.- Отдельный коммит (русский) после каждого проекта.
5. Порядок
Пилот — Deal.Modules.Cards (чистый домен). Далее: остальные Deal.Modules.*, затем
Deal.Infrastructure, Deal.Api, Deal.Contracts/Deal.SharedKernel, сервисы telegram/ai/ml,
затем тестовые проекты. После каждого шага — сборка + тесты + коммит.
6. Риски
- Коллизия простых имён при пере-добавлении
using→ разрешается вручную по ошибкам сборки. - Не забыть
cref/полные имена в XML-док иnameof— выявляются сборкой.