Skip to content

docs: Product Design 및 Figma 실행 계획 추가#413

Open
seonghobae wants to merge 6 commits into
mainfrom
docs/product-design-figma-plan
Open

docs: Product Design 및 Figma 실행 계획 추가#413
seonghobae wants to merge 6 commits into
mainfrom
docs/product-design-figma-plan

Conversation

@seonghobae

@seonghobae seonghobae commented Jul 1, 2026

Copy link
Copy Markdown
Collaborator

요약

  • pg-erd-cloud의 Product Design/Figma 실행 계획 문서를 추가하고 최신 Figma 산출물 상태까지 갱신했습니다.
  • 현재 UI/UX 레퍼런스와 프론트엔드 소스 기준의 1차 UX 감사 보고서를 추가했습니다.
  • Product Design Kit Figma design 파일을 생성하고 intake, reference, foundations, components, core flow prototype, QA/handoff 페이지를 구성했습니다.
  • Figma 01 Current References 페이지에 docs/ui-ux의 9개 PNG 레퍼런스를 모두 이미지-fill 카드로 배치했습니다.
  • Figma 02 Foundations에 로컬 변수, 텍스트 스타일, 효과 스타일을 만들고 향후 CSS custom property 이름을 기록했습니다.
  • Figma 03 Components에 button, input field, ERD table node, status pill, toolbar button, share/export modal component set을 추가했습니다.
  • Figma 04 Core Flow Prototype에 dashboard -> connection setup -> ERD editor -> share/export 화면 흐름과 주요 CTA click reaction을 추가했습니다.
  • 핵심 connection-to-share 사용자 흐름을 FigJam으로 생성하고 Mermaid 원본을 저장했습니다.
  • 구현 전 디자인 QA 체크리스트를 추가해 Figma/구현 비교 게이트를 문서화했습니다.
  • docs/ui-ux README에서 실행 계획, 감사, QA 체크리스트, Figma 파일, Mermaid 원본, FigJam 보드, 주요 Figma node를 바로 찾을 수 있도록 링크했습니다.

Figma / FigJam 산출물

검증

  • Figma metadata confirmed pages: 00 Intake, 01 Current References, 02 Foundations, 03 Components, 04 Core Flow Prototype, 05 QA and Handoff
  • Figma 01 Current References verified 9/9 screenshot slots as IMAGE fills with FIT scale mode
  • Figma screenshot of Current UI References confirmed all 9 cards render without missing images or label overlap
  • Figma variable validation confirmed 4 local collections and 57 variables with scoped usage and WEB code syntax
  • Figma screenshot checks completed for foundations, button, input field, ERD table node, status pill, toolbar button, share/export modal, ERD editor prototype, and share/export prototype
  • Core flow prototype buttons have ON_CLICK -> NAVIGATE reactions for New diagram, Create snapshot, and Share/export
  • git diff --check
  • git show --check --stat --oneline HEAD
  • git diff --check -- docs/ui-ux/README.md docs/ui-ux/design-qa-checklist.md docs/ui-ux/product-design-audit.md docs/ui-ux/product-design-figma-execution-plan.md

참고

  • 문서/Figma/FigJam 계획 및 디자인 시스템 산출물 변경만 포함합니다.
  • 프로덕션 UI 코드는 아직 변경하지 않았습니다.
  • 다음 코드 PR의 권장 첫 범위는 Product Design audit의 P1 finding인 share/export modal 정리입니다.

Copilot AI review requested due to automatic review settings July 1, 2026 23:15

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds UI/UX documentation artifacts under docs/ui-ux to make Product Design work and a future Figma workflow more repeatable and easy to discover from the existing screenshot reference entrypoint.

Changes:

  • Add an execution plan doc for turning current UI evidence into a Figma file + prototype workflow.
  • Add a first-pass UX audit report grounded in existing screenshots and current frontend source.
  • Update docs/ui-ux/README.md to link directly to the new plan + audit docs.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
docs/ui-ux/README.md Adds an “Execution planning” section linking to the new plan and audit docs.
docs/ui-ux/product-design-figma-execution-plan.md New execution plan describing scope, work packages, deliverables, and verification commands.
docs/ui-ux/product-design-audit.md New UX audit report with findings, impacts, and recommended next steps.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

OpenCode exhausted the configured model pool without a usable current-head review conclusion. This is not approval evidence, so the PR is blocked until a source-backed review can establish approval sufficiency or identify concrete fixes.

Findings

1. HIGH review evidence:1 - OpenCode could not establish approval sufficiency

  • Problem: every configured model path failed to produce a usable current-head control block.
  • Root cause: model execution, timeout, export, normalization, or approval-gate validation did not complete after exponential retry across the configured model pool.
  • Impact: approving from deterministic check state alone would miss PR-intent mismatches, missing files, edge-case bugs, robustness gaps, UX/DX regressions, security issues, and CodeGraph-backed base/head flow changes.
  • Fix: rerun OpenCode after model availability recovers, or update the PR with the missing files, tests, docs, generated artifacts, and verification evidence needed for a source-backed review conclusion.
  • Regression test: keep the approval gate posting REQUEST_CHANGES, not APPROVE or check-only failure, when no model produces a valid current-head review.

Summary

  • Result: REQUEST_CHANGES
  • Reason: coverage-evidence passed and peer GitHub Checks completed without failures, but no model produced a valid review control block.
  • Deterministic evidence checked but not used for approval: current-head changed-file evidence (docs/ui-ux/README.md, docs/ui-ux/core-user-flow.mmd, docs/ui-ux/design-qa-checklist.md, docs/ui-ux/product-design-audit.md, docs/ui-ux/product-design-figma-execution-plan.md); coverage-evidence result success; peer checks from statusCheckRollup excluding this OpenCode check.
  • Model outcome: model_pool=exhausted; selected_model=none.
  • Head SHA: 5cd8f24c2cbe0e53b593a71779ef739f866dc59a
  • Workflow run: 28554296347
  • Workflow attempt: 1

No PR approval was posted because model-output failure is not evidence that the PR has no blockers.

Inline comment note: OpenCode could not find an added RIGHT-side diff line for this PR, so the model-exhaustion blocker is attached to the PR review body instead of a file line.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Docs (5 files)"]
  S1 --> I1["operator or user guidance"]
  I1 --> R1["Review risk: Docs (5 files)"]
  R1 --> V1["docs review"]
Loading

@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

OpenCode Review Overview

  • Head SHA: e5562a8f617ebf8cc7d6ca852eaaef4bff457a58
  • Workflow run: 28556662411
  • Workflow attempt: 2
  • Gate result: REQUEST_CHANGES (approval step)

Pull request overview

OpenCode exhausted the configured model pool without a usable current-head review conclusion. This is not approval evidence, so the PR is blocked until a source-backed review can establish approval sufficiency or identify concrete fixes.

Findings

1. HIGH review evidence:1 - OpenCode could not establish approval sufficiency

  • Problem: every configured model path failed to produce a usable current-head control block.
  • Root cause: model execution, timeout, export, normalization, or approval-gate validation did not complete after exponential retry across the configured model pool.
  • Impact: approving from deterministic check state alone would miss PR-intent mismatches, missing files, edge-case bugs, robustness gaps, UX/DX regressions, security issues, and CodeGraph-backed base/head flow changes.
  • Fix: rerun OpenCode after model availability recovers, or update the PR with the missing files, tests, docs, generated artifacts, and verification evidence needed for a source-backed review conclusion.
  • Regression test: keep the approval gate posting REQUEST_CHANGES, not APPROVE or check-only failure, when no model produces a valid current-head review.

Summary

  • Result: REQUEST_CHANGES
  • Reason: coverage-evidence passed and peer GitHub Checks completed without failures, but no model produced a valid review control block.
  • Deterministic evidence checked but not used for approval: current-head changed-file evidence (docs/ui-ux/README.md, docs/ui-ux/core-user-flow.mmd, docs/ui-ux/design-qa-checklist.md, docs/ui-ux/product-design-audit.md, docs/ui-ux/product-design-figma-execution-plan.md); coverage-evidence result success; peer checks from statusCheckRollup excluding this OpenCode check.
  • Model outcome: model_pool=exhausted; selected_model=none.
  • Head SHA: e5562a8f617ebf8cc7d6ca852eaaef4bff457a58
  • Workflow run: 28556662411
  • Workflow attempt: 2

No PR approval was posted because model-output failure is not evidence that the PR has no blockers.

Inline comment note: OpenCode could not find an added RIGHT-side diff line for this PR, so the model-exhaustion blocker is attached to the PR review body instead of a file line.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Docs (5 files)"]
  S1 --> I1["operator or user guidance"]
  I1 --> R1["Review risk: Docs (5 files)"]
  R1 --> V1["docs review"]
Loading

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

OpenCode exhausted the configured model pool without a usable current-head review conclusion. This is not approval evidence, so the PR is blocked until a source-backed review can establish approval sufficiency or identify concrete fixes.

Findings

1. HIGH docs/ui-ux/README.md:1 - OpenCode could not establish approval sufficiency

  • Problem: every configured model path failed to produce a usable current-head control block.
  • Root cause: model execution, timeout, export, normalization, or approval-gate validation did not complete after exponential retry across the configured model pool.
  • Impact: approving from deterministic check state alone would miss PR-intent mismatches, missing files, edge-case bugs, robustness gaps, UX/DX regressions, security issues, and CodeGraph-backed base/head flow changes.
  • Fix: rerun OpenCode after model availability recovers, or update the PR with the missing files, tests, docs, generated artifacts, and verification evidence needed for a source-backed review conclusion.
  • Regression test: keep the approval gate posting REQUEST_CHANGES, not APPROVE or check-only failure, when no model produces a valid current-head review.

Summary

  • Result: REQUEST_CHANGES
  • Reason: coverage-evidence passed and peer GitHub Checks completed without failures, but no model produced a valid review control block.
  • Deterministic evidence checked but not used for approval: current-head changed-file evidence (docs/ui-ux/README.md, docs/ui-ux/core-user-flow.mmd, docs/ui-ux/design-qa-checklist.md, docs/ui-ux/product-design-audit.md, docs/ui-ux/product-design-figma-execution-plan.md); coverage-evidence result success; peer checks from statusCheckRollup excluding this OpenCode check.
  • Model outcome: model_pool=exhausted; selected_model=none.
  • Head SHA: 22228c4e4c274091f94a31b2a7104c5df228ad45
  • Workflow run: 28554594695
  • Workflow attempt: 1

No PR approval was posted because model-output failure is not evidence that the PR has no blockers.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Docs (5 files)"]
  S1 --> I1["operator or user guidance"]
  I1 --> R1["Review risk: Docs (5 files)"]
  R1 --> V1["docs review"]
Loading

Comment thread docs/ui-ux/README.md
- Modals should be centered, restrained, and form-first.
- The ERD editor should prioritize canvas space, toolbars, side properties, sharing, and export workflows.

Execution planning:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

HIGH OpenCode could not establish approval sufficiency

  • Problem: the model pool exhausted without a valid current-head review control block, so this changed line cannot be approved from deterministic check state alone.
  • Impact: PR-intent mismatches, missing files, robustness bugs, UX/DX regressions, and CodeGraph-backed flow changes could be missed.
  • Fix: rerun OpenCode after model availability recovers, or add the missing source/test/docs/generated verification evidence needed for a source-backed approval.
  • Verification: rerun the OpenCode Review workflow and confirm it emits APPROVE or source-backed REQUEST_CHANGES for this head SHA.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

OpenCode exhausted the configured model pool without a usable current-head review conclusion. This is not approval evidence, so the PR is blocked until a source-backed review can establish approval sufficiency or identify concrete fixes.

Findings

1. HIGH review evidence:1 - OpenCode could not establish approval sufficiency

  • Problem: every configured model path failed to produce a usable current-head control block.
  • Root cause: model execution, timeout, export, normalization, or approval-gate validation did not complete after exponential retry across the configured model pool.
  • Impact: approving from deterministic check state alone would miss PR-intent mismatches, missing files, edge-case bugs, robustness gaps, UX/DX regressions, security issues, and CodeGraph-backed base/head flow changes.
  • Fix: rerun OpenCode after model availability recovers, or update the PR with the missing files, tests, docs, generated artifacts, and verification evidence needed for a source-backed review conclusion.
  • Regression test: keep the approval gate posting REQUEST_CHANGES, not APPROVE or check-only failure, when no model produces a valid current-head review.

Summary

  • Result: REQUEST_CHANGES
  • Reason: coverage-evidence passed and peer GitHub Checks completed without failures, but no model produced a valid review control block.
  • Deterministic evidence checked but not used for approval: current-head changed-file evidence (docs/ui-ux/README.md, docs/ui-ux/core-user-flow.mmd, docs/ui-ux/design-qa-checklist.md, docs/ui-ux/product-design-audit.md, docs/ui-ux/product-design-figma-execution-plan.md); coverage-evidence result success; peer checks from statusCheckRollup excluding this OpenCode check.
  • Model outcome: model_pool=exhausted; selected_model=none.
  • Head SHA: aa49c02a254b4e8f76d44e2849de74e47b98416f
  • Workflow run: 28555043205
  • Workflow attempt: 1

No PR approval was posted because model-output failure is not evidence that the PR has no blockers.

Inline comment note: OpenCode could not find an added RIGHT-side diff line for this PR, so the model-exhaustion blocker is attached to the PR review body instead of a file line.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Docs (5 files)"]
  S1 --> I1["operator or user guidance"]
  I1 --> R1["Review risk: Docs (5 files)"]
  R1 --> V1["docs review"]
Loading

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

OpenCode exhausted the configured model pool without a usable current-head review conclusion. This is not approval evidence, so the PR is blocked until a source-backed review can establish approval sufficiency or identify concrete fixes.

Findings

1. HIGH review evidence:1 - OpenCode could not establish approval sufficiency

  • Problem: every configured model path failed to produce a usable current-head control block.
  • Root cause: model execution, timeout, export, normalization, or approval-gate validation did not complete after exponential retry across the configured model pool.
  • Impact: approving from deterministic check state alone would miss PR-intent mismatches, missing files, edge-case bugs, robustness gaps, UX/DX regressions, security issues, and CodeGraph-backed base/head flow changes.
  • Fix: rerun OpenCode after model availability recovers, or update the PR with the missing files, tests, docs, generated artifacts, and verification evidence needed for a source-backed review conclusion.
  • Regression test: keep the approval gate posting REQUEST_CHANGES, not APPROVE or check-only failure, when no model produces a valid current-head review.

Summary

  • Result: REQUEST_CHANGES
  • Reason: coverage-evidence passed and peer GitHub Checks completed without failures, but no model produced a valid review control block.
  • Deterministic evidence checked but not used for approval: current-head changed-file evidence (docs/ui-ux/README.md, docs/ui-ux/core-user-flow.mmd, docs/ui-ux/design-qa-checklist.md, docs/ui-ux/product-design-audit.md, docs/ui-ux/product-design-figma-execution-plan.md); coverage-evidence result success; peer checks from statusCheckRollup excluding this OpenCode check.
  • Model outcome: model_pool=exhausted; selected_model=none.
  • Head SHA: aa49c02a254b4e8f76d44e2849de74e47b98416f
  • Workflow run: 28555043205
  • Workflow attempt: 2

No PR approval was posted because model-output failure is not evidence that the PR has no blockers.

Inline comment note: OpenCode could not find an added RIGHT-side diff line for this PR, so the model-exhaustion blocker is attached to the PR review body instead of a file line.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Docs (5 files)"]
  S1 --> I1["operator or user guidance"]
  I1 --> R1["Review risk: Docs (5 files)"]
  R1 --> V1["docs review"]
Loading

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

OpenCode exhausted the configured model pool without a usable current-head review conclusion. This is not approval evidence, so the PR is blocked until a source-backed review can establish approval sufficiency or identify concrete fixes.

Findings

1. HIGH review evidence:1 - OpenCode could not establish approval sufficiency

  • Problem: every configured model path failed to produce a usable current-head control block.
  • Root cause: model execution, timeout, export, normalization, or approval-gate validation did not complete after exponential retry across the configured model pool.
  • Impact: approving from deterministic check state alone would miss PR-intent mismatches, missing files, edge-case bugs, robustness gaps, UX/DX regressions, security issues, and CodeGraph-backed base/head flow changes.
  • Fix: rerun OpenCode after model availability recovers, or update the PR with the missing files, tests, docs, generated artifacts, and verification evidence needed for a source-backed review conclusion.
  • Regression test: keep the approval gate posting REQUEST_CHANGES, not APPROVE or check-only failure, when no model produces a valid current-head review.

Summary

  • Result: REQUEST_CHANGES
  • Reason: coverage-evidence passed and peer GitHub Checks completed without failures, but no model produced a valid review control block.
  • Deterministic evidence checked but not used for approval: current-head changed-file evidence (docs/ui-ux/README.md, docs/ui-ux/core-user-flow.mmd, docs/ui-ux/design-qa-checklist.md, docs/ui-ux/product-design-audit.md, docs/ui-ux/product-design-figma-execution-plan.md); coverage-evidence result success; peer checks from statusCheckRollup excluding this OpenCode check.
  • Model outcome: model_pool=exhausted; selected_model=none.
  • Head SHA: e5562a8f617ebf8cc7d6ca852eaaef4bff457a58
  • Workflow run: 28556662411
  • Workflow attempt: 1

No PR approval was posted because model-output failure is not evidence that the PR has no blockers.

Inline comment note: OpenCode could not find an added RIGHT-side diff line for this PR, so the model-exhaustion blocker is attached to the PR review body instead of a file line.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Docs (5 files)"]
  S1 --> I1["operator or user guidance"]
  I1 --> R1["Review risk: Docs (5 files)"]
  R1 --> V1["docs review"]
Loading

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

OpenCode exhausted the configured model pool without a usable current-head review conclusion. This is not approval evidence, so the PR is blocked until a source-backed review can establish approval sufficiency or identify concrete fixes.

Findings

1. HIGH review evidence:1 - OpenCode could not establish approval sufficiency

  • Problem: every configured model path failed to produce a usable current-head control block.
  • Root cause: model execution, timeout, export, normalization, or approval-gate validation did not complete after exponential retry across the configured model pool.
  • Impact: approving from deterministic check state alone would miss PR-intent mismatches, missing files, edge-case bugs, robustness gaps, UX/DX regressions, security issues, and CodeGraph-backed base/head flow changes.
  • Fix: rerun OpenCode after model availability recovers, or update the PR with the missing files, tests, docs, generated artifacts, and verification evidence needed for a source-backed review conclusion.
  • Regression test: keep the approval gate posting REQUEST_CHANGES, not APPROVE or check-only failure, when no model produces a valid current-head review.

Summary

  • Result: REQUEST_CHANGES
  • Reason: coverage-evidence passed and peer GitHub Checks completed without failures, but no model produced a valid review control block.
  • Deterministic evidence checked but not used for approval: current-head changed-file evidence (docs/ui-ux/README.md, docs/ui-ux/core-user-flow.mmd, docs/ui-ux/design-qa-checklist.md, docs/ui-ux/product-design-audit.md, docs/ui-ux/product-design-figma-execution-plan.md); coverage-evidence result success; peer checks from statusCheckRollup excluding this OpenCode check.
  • Model outcome: model_pool=exhausted; selected_model=none.
  • Head SHA: e5562a8f617ebf8cc7d6ca852eaaef4bff457a58
  • Workflow run: 28556662411
  • Workflow attempt: 2

No PR approval was posted because model-output failure is not evidence that the PR has no blockers.

Inline comment note: OpenCode could not find an added RIGHT-side diff line for this PR, so the model-exhaustion blocker is attached to the PR review body instead of a file line.

Changed-File Evidence Map

flowchart LR
  PR["PR changed files"] --> Evidence["OpenCode bounded evidence"]
  Evidence --> S1["Docs (5 files)"]
  S1 --> I1["operator or user guidance"]
  I1 --> R1["Review risk: Docs (5 files)"]
  R1 --> V1["docs review"]
Loading

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants