④段整套同步(六节 + P/S/F/J + 模板)+ open-design 移到技能根

一、④段整套同步(用户选候选 A)
- 新增 `references/stage-proto-doc/assets/产品文档模板.html`(16 KB/247 行,从备份拷、转 LF)。
- ④段 SKILL.md 换成备份 15:28 那版,并按模板口径改齐:
  · 「产品文档框架」从「四块+一附录」改成**六节** —— 页面结构/功能清单/使用场景/操作流程/
    跨页与界面状态/待确认与偏离;与模板同构,⛔ 不从空白页重写结构。
  · 编号从 R/S/F 改成 **P 页面/S 场景/F 功能/J 二级功能**,各自唯一、按展示顺序通排。
  · 保留旧版有价值的要求:每项功能补齐 做什么/入口在哪/输入边界/异常与恢复;重点功能三处标红;
    横向流程图每步写清页面/功能/操作/完成判据。
  · 完成标准「七节」→「六节」,自查清单同步换掉「需求」那批条目,补模板与配图两条。
  · 路径 `designs/<项目>/` → `docs/pm/<项目>/ui/`(2 处)。
  · 补回本机那条「每份产出文档开头都要有一张图」的引用(指向主 skill,段内不复述)。
- 主 skill 同步:四段结构表④行、④段沿革、画图小节(④段画页面结构图 + 用户路径)。

二、open-design 移到技能根(用户选候选 A)
- `git mv product-planning/references/stage-delivery/assets/open-design → open-design/`(4178 文件)。
- `.gitignore` 白名单加 `!/open-design/` —— 否则移出去就不再纳入版本控制。
- 引用改 11 处:路径形态 `assets/open-design/...` → `<技能根>/open-design/...`;
  「随段携带的自带件」改称「同根技能」;「路径怎么找」那条改成自带件(段内相对路径)与
  同根技能(`<技能根>/<技能名>/`)两类分开写。
- open-design 自己的 ATTRIBUTION.md 两处同步(它现在与 oil-ui-pro 同层)。
- 副作用(有益):命名闸门读数由 2063 降到 225 —— 此前它把 open-design 里 919 个第三方 md
  当成规则一起扫了;现在只扫本包 23 个 md。已确认④段的 H1 与 4a/4b/4c 子步仍在检查范围内。

三、验收
- check_naming.py --ws E:/ProgramData/AIProject/contentm_agent = 通过 225 / 失败 0 / 提示 27。
- 活文件里 `assets/open-design` 残留 0;工作区 CRLF 文件 0。
This commit is contained in:
admin committed 2026-10-15 21:17:28 +08:00
1 parent fa0a9026c8
commit 5afeb6b78a
4184 files changed
+326 -70

No files matched your search

@@ -0,0 +1,168 @@
# Design System Inspired by Discord
> Category: Продуктивність і SaaS
> Платформа для голосового спілкування та чату. Глибокий блерпл, темні поверхні за замовчуванням, грайливі акцентні моменти.
## 1. Візуальна тема та атмосфера
Продукт Discord розроблений для вечорів, рейдів та групових голосових сесій — тому вся поверхня є темною за замовчуванням. Стандартний фон — глибокий `Background Primary` (`#313338` у світлій темі, `#1e1f22` у темній), а колонки чату накладаються на трохи світліші або темніші відтінки для позначення каналів, гілок обговорень і бічних панелей. Фірмовий **Blurple** (`#5865f2`) зарезервований для знаку бренду, основних CTA, згадок та власного ідентифікатора — використовується дозовано, щоб виділятися на тлі приглушених нейтральних тонів.
Типографіка — **gg sans** (власна заміна Whitney від Discord) для основного тексту та інтерфейсу, із заокругленими геометричними формами, які виглядають доступно, але залишаються зрозумілими за малих розмірів, яких вимагає чат-клієнт. Заголовки збільшуються поступово; рядки чату щільні (4–8px між групами повідомлень), щоб годинний скролбек залишався легким для перегляду.
Мова форм — заокруглена, але не роздута: радіус 8px для карток, 4px для полів введення, повні овали для значків статусу та теґів. Сервери — аватари у формі заокругленого квадрата розміром 48px, які перетворюються на кола при наведенні — невеликий елемент руху, що став частиною фірмового стилю бренду.
**Ключові характеристики:**
- Темні поверхні за замовчуванням: `#1e1f22` / `#2b2d31` / `#313338` (3 рівні глибини)
- Blurple `#5865f2` як єдиний насичений акцент у поверхні чату
- gg sans (стиль Whitney) для всього тексту — дружній, геометричний, нейтральний
- Аватари серверів у формі заокругленого квадрата (радіус 16px), що перетворюються на кола при наведенні
- Щільний міжрядковий інтервал у чаті, великі відступи в бічній панелі
- Точки статусу: зелена — онлайн, жовта — відсутній, червона — не турбувати, сіра — офлайн
- Роздільники 1px з вирівнюванням по пікселях у приглушеному білому з низькою прозорістю
## 2. Кольорова палітра та ролі
### Основні кольори
- **Blurple** (`#5865f2`): Основний колір бренду, основний CTA, виділення згадок.
- **Blurple Hover** (`#4752c4`): Стан наведення/активний для blurple.
- **Blurple Soft** (`#7289da`): Застарілий blurple, другорядний акцент у маркетингу.
### Поверхня (темна тема — за замовчуванням)
- **Background Tertiary** (`#1e1f22`): Панель списку серверів, найглибший фон.
- **Background Secondary** (`#2b2d31`): Бічна панель каналів, бічна панель налаштувань.
- **Background Primary** (`#313338`): Поверхня чату, колонка повідомлень.
- **Background Floating** (`#111214`): Спливаючі елементи, підказки, автодоповнення.
- **Background Modifier Hover** (`rgba(78, 80, 88, 0.3)`): Оверлей наведення на рядки.
- **Background Modifier Selected** (`rgba(78, 80, 88, 0.6)`): Активний рядок.
### Поверхня (світла тема)
- **Light Bg Primary** (`#ffffff`): Поверхня чату у світлій темі.
- **Light Bg Secondary** (`#f2f3f5`): Бічна панель у світлій темі.
- **Light Bg Tertiary** (`#e3e5e8`): Найглибша світла поверхня.
### Текст
- **Header Primary** (`#f2f3f5`): Заголовки каналів, назви модальних вікон у темній темі.
- **Header Secondary** (`#b5bac1`): Приглушені заголовки.
- **Text Normal** (`#dbdee1`): Основний текст у темній темі — дещо холодніший за чистий білий.
- **Text Muted** (`#949ba4`): Мітки часу, назви серверів, другорядні метадані.
- **Text Link** (`#00a8fc`): Гіперпосилання в повідомленнях — небесно-блакитний, відрізняється від blurple.
- **Channels Default** (`#80848e`): Назва неактивного каналу в бічній панелі.
### Статус і семантика
- **Status Online** (`#23a55a`): Точка онлайн, стани успіху.
- **Status Idle** (`#f0b232`): Точка відсутності, afk.
- **Status DND** (`#f23f43`): Не турбувати, також використовується як деструктивний червоний.
- **Status Streaming** (`#593695`): Пурпурний колір «трансляції».
- **Status Offline** (`#80848e`): Сірий офлайн.
- **Mention Highlight** (`rgba(88, 101, 242, 0.1)`): М'яке blurple-накладення на рядки з @-згадками.
### Рамки та роздільники
- **Background Modifier Accent** (`rgba(255, 255, 255, 0.06)`): Стандартний роздільник у темній темі.
- **Border Subtle** (`#3f4147`): Суцільний роздільник для карток.
## 3. Правила типографіки
### Гарнітура шрифту
- **Основний текст / UI / Заголовки**: `gg sans`, з запасним варіантом: `"Helvetica Neue", Helvetica, Arial, sans-serif`
- **Відображення (застарілий / Whitney)**: `Whitney`, з запасним варіантом: `gg sans`
- **Код / Моноширинний**: `"gg mono"`, з запасним варіантом: `Consolas, Andale Mono, Courier New, Courier, monospace`
### Ієрархія
| Роль | Шрифт | Розмір | Насиченість | Висота рядка | Міжлітерний інтервал | Примітки |
|------|------|------|--------|-------------|----------------|-------|
| Display Hero | gg sans | 56px (3.5rem) | 800 | 1.1 | -0.02em | Маркетинговий герой |
| Page Heading | gg sans | 24px (1.5rem) | 700 | 1.25 | normal | Заголовки налаштувань/профілю |
| Channel Name | gg sans | 16px (1rem) | 600 | 1.25 | normal | `#general`, заголовок каналу |
| Message Body | gg sans | 16px (1rem) | 400 | 1.375 | normal | Стандартний текст чату |
| Username | gg sans | 16px (1rem) | 500 | 1.25 | normal | Автор повідомлення |
| Timestamp | gg sans | 12px (0.75rem) | 500 | 1.25 | normal | «Today at 4:32 PM» |
| Sidebar Channel | gg sans | 16px (1rem) | 500 | 1.25 | normal | Рядки списку каналів |
| Server Name | gg sans | 16px (1rem) | 600 | 1.25 | normal | Заголовок сервера |
| Caption / Meta | gg sans | 12px (0.75rem) | 400 | 1.3 | 0.02em | Текст статусу, мітка редагування |
| Code Inline | gg mono | 0.875em | 400 | inherit | normal | Вбудований `code` |
| Code Block | gg mono | 14px (0.875rem) | 400 | 1.5 | normal | Блок ```triple-fenced``` |
### Принципи
- **Дружня геометрія**: gg sans замінює Whitney, маючи заокруглені закінчення символів a/g/s — бренд прагне теплоти без шкоди для читабельності.
- **Контраст насиченості замість контрасту кольору**: ієрархія будується на кроках насиченості 400→500→600→700→800; поверхня залишається нейтральною.
- **Основний текст 16px**: повідомлення чату не зменшуються нижче 16px. Щільність досягається висотою рядка (1.375), а не розміром шрифту.
## 4. Стилі компонентів
### Кнопки
**Основна**
- Background: `#5865f2`
- Text: `#ffffff`
- Padding: 8px 16px
- Radius: 4px
- Hover: `#4752c4`
- Використання: основні CTA, «Continue», «Join Server»
**Другорядна**
- Background: `#4e5058`
- Text: `#ffffff`
- Padding: 8px 16px
- Radius: 4px
- Hover: `#6d6f78`
**Третинна / Прихована (стиль посилання)**
- Background: transparent
- Text: `#dbdee1`
- Hover: підкреслення тексту, фон не змінюється
**Деструктивна**
- Background: `#da373c`
- Text: `#ffffff`
- Hover: `#a12d2f`
### Поля введення
- Background: `#1e1f22`
- Text: `#dbdee1`
- Border: 1px solid `#1e1f22`
- Radius: 4px
- Padding: 10px 12px
- Focus: border `#5865f2`
### Аватари серверів
- Розмір: 48×48px
- Radius: 16px (заокруглений квадрат) за замовчуванням; при наведенні та в активному стані переходить до 50%.
- Активний стан: біла овальна смуга 4px по лівому краю колонки іконок.
### Точки статусу
- Розмір: 10×10px
- Border: 3px solid background-tertiary (створює ефект «виїмки»)
- Позиція: правий нижній кут аватара.
### Картки / Вставки
- Background: `#2b2d31` (темна) або `#f2f3f5` (світла)
- Ліва рамка: 4px solid акцентний колір вставки.
- Radius: 4px
- Padding: 8px 16px
### Пілюля згадки
- Background: `rgba(88, 101, 242, 0.3)`
- Text: `#c9cdfb`
- Padding: 0 2px
- Radius: 3px
## 5. Відступи та макет
- **Базова одиниця**: 4px. Шкала: 4, 8, 12, 16, 20, 24, 32, 40.
- **Панель серверів**: 72px, фіксована.
- **Бічна панель каналів**: 240px.
- **Список учасників**: 240px на десктопі.
- **Колонка чату**: рідка, мін. 380px.
## 6. Анімація
- **Тривалість**: 200ms для наведення; 350ms для морфінгу аватара в коло; 80ms для появи підказки.
- **Пом'якшення**: `cubic-bezier(0.215, 0.61, 0.355, 1)` для морфінгу аватара (різкий початок і плавне завершення).
- **Пульс сповіщення**: 1.4s ease-in-out infinite для індикатора непрочитаної згадки.
## 7. Обмеження використання
- Зберігайте темну оболонку, компактну щільність та ієрархію дій на основі blurple разом; використання blurple у світлому маркетинговому макеті руйнує відчуття продукту Discord.
- Тримайте поверхні з великою кількістю навігаційних елементів структурованими навколо панелей, бічних меню та колонок чату, а не ізольованих декоративних карток.
- Використовуйте мову аватарів-заокруглених-квадратів і точок статусу при відображенні людей, серверів або активної присутності.