Corp/backend/static/scss/MIGRATION_MATRIX.md
Игорь Надеин 9df9f78666 refactor: Complete SCSS architecture reorganization
SCSS Architecture 2.0 - Feature-based structure

### Major Changes:
- ✅ Reorganized 51 SCSS files into logical categories
- ✅ Created feature-based structure: core/, layout/, features/, utilities/
- ✅ Merged duplicate components: badges (2→1), modals (3→1), lists (2→1), spacing (2→1)
- ✅ Renamed files: ios-search→search, team-wheel→team-viz, recipientPicker→recipient-picker
- ✅ Cleaned custom-bootstrap.scss from all app components
- ✅ Moved chat components from custom-bootstrap to main.scss

### Results:
- Files: 51 → 38 (-13 files, -25%)
- bootstrap-custom.css: 301 KB → 229 KB (-72 KB, -24%)
- app.css: 95 KB → 137 KB (+42 KB, expected)
- Total CSS: 396 KB → 366 KB (-30 KB, -7.5%)

### New Structure:
scss/
├── abstracts/           # Variables, mixins (4 files)
├── core/               # UI Kit - reusable components (9 files)
│   ├── buttons, badges, cards, lists, modals, etc.
├── layout/             # App structure (6 files)
│   ├── grid, navbar, sidebar, rightbar, etc.
├── utilities/          # Utility classes (1 file)
│   └── spacing
└── features/           # Feature-specific styles (18 files in 6 folders)
    ├── feed/          (3 files)
    ├── requests/      (3 files)
    ├── documents/     (1 file)
    ├── employees/     (2 files)
    ├── notifications/ (1 file)
    └── chat/          (10 files)

### Benefits:
- Clear categorization
- No duplicate imports (removed 8 duplicates)
- Logical feature grouping
- Easier maintenance
- Clean architecture
- Better naming conventions

### Documentation:
- scss/README.md - full architecture documentation
- scss/MIGRATION_MATRIX.md - file migration matrix
- docs/reports/SCSS_REORGANIZATION_COMPLETE.md - completion report

Bootstrap remains as base UI framework.
2026-01-15 14:11:14 +03:00

7.1 KiB
Raw Blame History

SCSS Migration Matrix

Дата: 15 января 2026

Легенда

  • ✅ Готово
  • 🔄 Объединение файлов
  • ✏️ Переименование
  • ⏳ Ожидает

Core UI Kit (9 файлов)

# Старый файл Новый путь Действие Статус
1 components/_buttons.scss core/_buttons.scss Переместить ⏳
2 components/_cards.scss core/_cards.scss Переместить ⏳
3 components/_comments.scss core/_comments.scss Переместить ⏳
4 components/_common.scss core/_common.scss Переместить ⏳
5 components/_ios-search.scss core/_search.scss Переименовать ✏️ ⏳
6 components/_ios-components.scss core/_ui-elements.scss Переименовать ✏️ ⏳
7 components/_badges-bem.scss
components/_badges-telegram-style.scss
core/_badges.scss Объединить 🔄 ⏳
8 components/_modals.scss
components/_modal-overrides.scss
core/_modals.scss Объединить 🔄 ⏳
9 components/_card-list.scss
components/_list-view.scss
core/_lists.scss Объединить 🔄 ⏳
10 components/_logout-modal.scss core/_modals.scss Влить в modals 🔄 ⏳

Layout (5 файлов)

# Старый файл Новый путь Действие Статус
11 layout/_base-app.scss layout/_grid.scss Переименовать ✏️ ⏳
12 layout/_chat-layout.scss layout/_chat-layout.scss Оставить ⏳
13 components/_navbar.scss layout/_navbar.scss Переместить ⏳
14 components/_page-header.scss layout/_page-header.scss Переместить ⏳
15 components/_sidebar.scss layout/_sidebar.scss Переместить ⏳
16 components/_rightbar-calendar.scss layout/_rightbar.scss Переименовать ✏️ ⏳

Features: Feed (3 файла)

# Старый файл Новый путь Действие Статус
17 components/_feed-specific.scss features/feed/_layout.scss Переименовать ✏️ ⏳
18 components/_post-form.scss features/feed/_post-form.scss Переместить ⏳
19 components/_join-scroller.scss features/feed/_members-scroller.scss Переименовать ✏️ ⏳

Features: Requests (3 файла)

# Старый файл Новый путь Действие Статус
20 components/_request-list.scss features/requests/_list.scss Переименовать ✏️ ⏳
21 components/_request-detail.scss features/requests/_detail.scss Переименовать ✏️ ⏳
22 components/_recipientPicker.scss features/requests/_recipient-picker.scss Переименовать ✏️ ⏳

Features: Documents (1 файл)

# Старый файл Новый путь Действие Статус
23 components/_document-list.scss features/documents/_list.scss Переименовать ✏️ ⏳

Features: Employees (2 файла)

# Старый файл Новый путь Действие Статус
24 components/_department-controls.scss features/employees/_controls.scss Переименовать ✏️ ⏳
25 components/_team-wheel.scss features/employees/_team-viz.scss Переименовать ✏️ ⏳

Features: Notifications (1 файл)

# Старый файл Новый путь Действие Статус
26 components/_notifications.scss features/notifications/_center.scss Переименовать ✏️ ⏳

Features: Chat (10 файлов)

# Старый файл Новый путь Действие Статус
27 components/chat/_message-inputs.scss features/chat/_message-inputs.scss Переместить ⏳
28 components/chat/_chat-detail.scss features/chat/_chat-detail.scss Переместить ⏳
29 components/chat/_chat-date-groups.scss features/chat/_chat-date-groups.scss Переместить ⏳
30 components/chat/_chat-list-enhanced.scss features/chat/_chat-list-enhanced.scss Переместить ⏳
31 components/chat/_chat-enhanced.scss features/chat/_chat-enhanced.scss Переместить ⏳
32 components/chat/_chat-polls.scss features/chat/_chat-polls.scss Переместить ⏳
33 components/chat/_chat-new-messages-indicator.scss features/chat/_chat-new-messages-indicator.scss Переместить ⏳
34 components/chat/_message-selection.scss features/chat/_message-selection.scss Переместить ⏳
35 components/chat/_message-context-menu.scss features/chat/_message-context-menu.scss Переместить ⏳
36 components/chat/_message-reactions.scss features/chat/_message-reactions.scss Переместить ⏳

Utilities (1 файл)

# Старый файл Новый путь Действие Статус
37 components/_spacing-utils.scss
components/_layout-spacing.scss
utilities/_spacing.scss Объединить 🔄 ⏳

Abstracts (оставить как есть)

# Старый файл Новый путь Действие Статус
38 abstracts/_variables.scss abstracts/_variables.scss Оставить ✅
39 abstracts/_css-variables.scss abstracts/_css-variables.scss Оставить ✅
40 abstracts/_mixins.scss abstracts/_mixins.scss Оставить ✅
41 abstracts/_index.scss abstracts/_index.scss Оставить ✅

Другие файлы

# Файл Действие Статус
42 components/BUTTONS_README.md Переместить в docs/guides/ ⏳

Сводка

Всего файлов: 42
Переместить: 16
Переименовать: 12
Объединить: 8 (4 операции слияния)
Оставить: 4

Объединения:

  1. badges-bem + badges-telegram-style → badges (2→1)
  2. modals + modal-overrides + logout-modal → modals (3→1)
  3. card-list + list-view → lists (2→1)
  4. spacing-utils + layout-spacing → spacing (2→1)

Результат: 51 файл → 38 файлов (-13 файлов)