Привязка прототипа к ТЗ (prototype-mapping)

Навигационная карта возможностей продукта PIN: UI-поверхность / возможность → bounded context(ы) → use-case / user-story → папка детального ТЗ. Помогает найти нужное ТЗ по странице или возможности и проверить, что каждая продуктовая поверхность покрыта контекстом и документацией. Обновляется при написании ТЗ каждого контекста: проставляются ссылки на созданные api//domain//UC-документы.

Страницы портала (front-end) → контексты

Страница/фича	Что делает	Контекст(ы)	UC/US	Детальное ТЗ
/ (лендинг, CTA)	Маркетинг, вход	identity	—	identity/
Auth-модалка (СМС: signUpOrSignIn→confirm, referrerUrl)	Вход/регистрация по СМС, lazy-регистрация	identity, referral	UC-1/2/3 (шаги СМС)	identity/api/, referral/
/lots (каталог, фильтры, бесконечная лента; гейт: токен или реф-cookie)	Лента объектов	catalog	CTL: лента/поиск/фильтры/сортировка	catalog/
/lots/[id]/info (планировка/карта/тур/сводка)	Карточка лота	catalog, chessboard	CTL: карточка объекта	catalog/, chessboard/
/lots/[id]/analytics (график роста, калькулятор, метрики; readOnly для реф-гостя)	Инвест-аналитика лота	invest-analytics	CTL: карточка полная; PRC UC	invest-analytics/
Программы покупки + график платежей	Калькулятор 100%/рассрочка/ипотека	crm (booking)	US-INV-05/06, BKG UC	crm/
Кнопка «Забронировать» (форма ФИО+телефон)	Заявка на бронирование	crm (booking/leads)	UC-3, BKG UC	crm/
«Заявка на презентацию» (модалка, 409 DUPLICATE_PHONE)	Лид-заявка	crm (leads)	UC-1/UC-2	crm/
/favorites	Избранное	favorites	FAV UC (слияние сессий)	favorites/
Реф-шаринг (useShareReferralLink, cookie 30 дней)	Реферальные ссылки	referral	UC-1..3 (вход по ссылке), REF UC	referral/
/crm (канбан этапов, создание сделки)	Воронка сделок	crm	CRM UC, US-AGT	crm/
/crm/deals/[id] (этапы, участники+роли, чат)	Карточка сделки	crm, messenger	US-INV-02..23, US-AGT, US-DEV, US-MGR	crm/, messenger/
Чат сделки	Групповой чат сделки (собственный мини-мессенджер, SignalR — ADR-0055)	messenger	US-INV-15..17	messenger/
/social → Telegram	Раздел соцсети	news	NWS UC	news/
Сессия/useViewer (pin:session, 401→clear)	Текущий пользователь	identity	—	identity/

Страницы: отели, подборки, профиль, клиентская база

Страница/фича	Что делает	Контекст(ы)	UC/US	Детальное ТЗ
/hotels + /hotels/[id]/{info,assortment}	Каталог отелей/проектов, ассортимент лотов	catalog, chessboard	CTL: лента/карточка проекта	catalog/, chessboard/
/hotels/[id]/chessboard	Шахматка отеля (матрица)	chessboard, catalog	CTL: просмотр шахматки	chessboard/
/hotels/[id]/news	Новости отеля/проекта	news	NWS UC (привязка к проекту)	news/
/collection (подборки из избранного, SharePopover с реф-ссылкой)	Подборки	selections, referral	SEL UC; UC-1..3 (шаринг)	selections/
/profile/personal (несколько персон) + features/client-documents	Персональные данные, наборы данных (муж/жена/дети)	profile	PRF UC (персоны, реквизиты)	profile/
/profile/deals, /profile/events	Сделки и история событий пользователя	crm, user-activity	US-INV-01..; ACT UC	crm/, user-activity/
/profile/my-lots	«Мои лоты» (портфель)	investor-owner	OWN UC	investor-owner/
/profile/partner	Партнёрская программа (реф-ссылки/статистика)	referral	REF UC	referral/
/crm/clients + [clientId]/{events,collections,history}	Клиентская база агента: карточка клиента, события, подборки, история	crm, user-activity, selections	матрица «Агент» §2; CRM UC	crm/
Карточка сделки: вкладки Документы/О лоте/О проекте/Условия (+форма данных клиента)	Детали сделки	crm, profile	US-INV-02,12..14,18,22,23	crm/
Бронирование: опциональное отчество, форма неполного профиля	Заявка на бронь	crm (booking), profile	UC-3, BKG UC	crm/

Табы админ-панели → контексты

Таб админки	Контекст	Детальное ТЗ
Лоты / Корпуса / Настройка лотов (оверрайды)	catalog	catalog/ (admin API)
Программы покупки	crm (booking)	crm/
Глобальный дефолт + помесячные оверрайды (эконом-модель) + investor-preview + growth-chart	invest-analytics	invest-analytics/
Заявки	crm (leads)	crm/
Рефералы (журнал ссылок/регистраций)	referral (admin)	referral/

Правила ведения

• При написании ТЗ контекста: проставлять ссылки на созданные api//domain//UC-документы.
• Новые страницы/возможности добавляются сюда вместе с их ТЗ.
• Финальная проверка (Этап 6): каждая UI-поверхность/возможность имеет соответствие в детальном ТЗ.

Обратные ссылки

Автоссылки: где используется этот документ.

• Домен (CQRS) (7): Entity / Aggregate: PersonEntity, Entity / Aggregate: ProfileEntity, Entity / Aggregate: ReferralBondEntity, Entity / Aggregate: ReferralLinkEntity, Entity / Aggregate: ReferralRegistrationEntity, Entity / Aggregate: RequisiteTemplateEntity, Entity: PersonDocumentEntity
• API (8): GET /api/agent/crm/clients/{clientId} — Карточка клиента, GET /api/developer/crm/deals/{dealId} — Карточка сделки (застройщик), GET /api/developer/crm/purchase-program — Программа покупки застройщика, GET /api/user-activity/me/history — Своя история активности (просмотры + действия), GET /api/v1/partner/stats — Партнёрская сводка по каналам, POST /api/v1/profile/persons/{personId}/documents — Добавление документа персоны (addPersonDocument), POST /api/v1/profile/persons/{personId}/documents/{documentId}/scans — Прикрепление скана документа (attachDocumentScan), PUT /api/v1/profile/verification/{requestId} — Правка черновика заявки KYC (updateVerificationDraft)
• Use Cases (5): UC-ACT-003. Инвестор просматривает свою историю просмотров и действий, UC-PRF-001. Заполнение профиля и персоны «Сам» (первый вход инвестора в ЛК), UC-PRF-002. Добавление персоны «Супруг(а)» с паспортом и сканами, UC-PRF-004. Создание шаблона реквизитов и его использование в бронировании (CRM), UC-REF-001. Создание реферальной ссылки с каналом и шаринг
• index.md (4): Документация PIN, Фронтенды PIN, Messenger Service, user-activity Service
• glossary.md (1): Глоссарий PIN
• registries (1): Реестры PIN (registries)
• technical-assignment.md (1): Техническое задание PIN — нормализованная структура