wsb1224
e3479f0546
# 问题 修复 文件 1 前端构建失败（引号错误） size="small type=" → size="small" type=" PosterHistoryPage.vue 2 migrate_014 ORM vs 缺失列 全部改为原始 SQL，不再引用 ORM 模型 migrate_014.py 3 cleanup 字段名错误 output_path → ppt_path cleanup.py 4 文案生成 case 越权 添加 case.user_id != user_id 校验 poster/service.py 5 存储路径未接通持久化卷 全部改用 get_storage_root()（默认 /app/api/storage/insurance） config.py, ppt/routes.py, poster/service.py, poster/tasks.py 高风险问题修复 # 问题 修复 文件 6 migrate_019 rollback 撤销成功字段 每个 ALTER 后立即 commit，失败只回滚当前语句 migrate_019.py 7 迁移锁 Windows 不兼容 + 句柄未持久化 全局变量保存锁句柄，支持 Windows msvcrt api/insurance/db/__init__.py 8 PDF 校验异常时放行 异常返回 False（文件损坏） security.py 9 健康检查始终返回成功 缺少关键资源时返回 503 + missing 列表 poster/routes.py 10 短密钥掩码泄露原值 ≤4 字符返回 **** ppt_admin_service.py 11 设置无键名白名单 添加 _ALLOWED_SETTING_KEYS 白名单 ppt_admin_service.py 12 容器重启任务永久 stuck 添加 recover_stale_tasks() 启动恢复函数 poster/tasks.py, ppt/parse_worker.py
70 lines
3.3 KiB
Markdown
70 lines
3.3 KiB
Markdown
# Extract Flow
|
|
|
|
Identify reusable patterns, components, and design tokens, then extract and consolidate them into the design system for systematic reuse.
|
|
|
|
## Step 1: Discover the Design System
|
|
|
|
Find the design system, component library, or shared UI directory. Understand its structure: component organization, naming conventions, design token structure, import/export conventions.
|
|
|
|
**CRITICAL**: If no design system exists, STOP and call the AskUserQuestion tool to clarify. before creating one. Understand the preferred location and structure first.
|
|
|
|
## Step 2: Identify Patterns
|
|
|
|
Look for extraction opportunities in the target area:
|
|
|
|
- **Repeated components**: Similar UI patterns used 3+ times (buttons, cards, inputs)
|
|
- **Hard-coded values**: Colors, spacing, typography, shadows that should be tokens
|
|
- **Inconsistent variations**: Multiple implementations of the same concept
|
|
- **Composition patterns**: Layout or interaction patterns that repeat (form rows, toolbar groups, empty states)
|
|
- **Type styles**: Repeated font-size + weight + line-height combinations
|
|
- **Animation patterns**: Repeated easing, duration, or keyframe combinations
|
|
|
|
Assess value: only extract things used 3+ times with the same intent. Premature abstraction is worse than duplication.
|
|
|
|
## Step 3: Plan Extraction
|
|
|
|
Create a systematic plan:
|
|
|
|
- **Components to extract**: Which UI elements become reusable components?
|
|
- **Tokens to create**: Which hard-coded values become design tokens?
|
|
- **Variants to support**: What variations does each component need?
|
|
- **Naming conventions**: Component names, token names, prop names that match existing patterns
|
|
- **Migration path**: How to refactor existing uses to consume the new shared versions
|
|
|
|
**IMPORTANT**: Design systems grow incrementally. Extract what is clearly reusable now, not everything that might someday be reusable.
|
|
|
|
## Step 4: Extract & Enrich
|
|
|
|
Build improved, reusable versions:
|
|
|
|
- **Components**: Clear props API with sensible defaults, proper variants for different use cases, accessibility built in (ARIA, keyboard navigation, focus management), documentation and usage examples
|
|
- **Design tokens**: Clear naming (primitive vs semantic), proper hierarchy and organization, documentation of when to use each token
|
|
- **Patterns**: When to use this pattern, code examples, variations and combinations
|
|
|
|
## Step 5: Migrate
|
|
|
|
Replace existing uses with the new shared versions:
|
|
|
|
- **Find all instances**: Search for the patterns you extracted
|
|
- **Replace systematically**: Update each use to consume the shared version
|
|
- **Test thoroughly**: Ensure visual and functional parity
|
|
- **Delete dead code**: Remove the old implementations
|
|
|
|
## Step 6: Document
|
|
|
|
Update design system documentation:
|
|
|
|
- Add new components to the component library
|
|
- Document token usage and values
|
|
- Add examples and guidelines
|
|
- Update any Storybook or component catalog
|
|
|
|
**NEVER**:
|
|
- Extract one-off, context-specific implementations without generalization
|
|
- Create components so generic they are useless
|
|
- Extract without considering existing design system conventions
|
|
- Skip proper TypeScript types or prop documentation
|
|
- Create tokens for every single value (tokens should have semantic meaning)
|
|
- Extract things that differ in intent (two buttons that look similar but serve different purposes should stay separate)
|
|
|