solution-erp/.claude/agent-memory/frontend-designer/archive/2026-06.md

frontend-designer — archive 2026-06 (L2 verbatim · FROZEN additive)

Curated from L1 MEMORY.md @S96 (2026-07-01) — first-overflow distillation (L1 hit 26129B > autoinject-cap 25600B, H17-loop strike-1). Older Activity-log war-stories moved here VERBATIM (byte-exact, additive-only — NEVER rewrite existing bytes). Recent 3 (S79/S69×2) + all reference sections (design-system · FD2-rig · component-inventory · lessons) stay in L1. Map → _INDEX.md · 4-field distill → 2026-06.gist.md.

Activity log (archived — moved-set, newest-of-moved on top)

• S66 (2026-06-16) HRM Hồ sơ Nhân sự fe-user REFINE từ eoffice LIVE (3 việc) — layout 3-cột→2-cột + tô màu detail: anh góp ý sau khi xem prod. Việc 1 (layout): 3-cột-ngang [tree 244 | list 352 | detail 1fr] → 2-cột lg:grid-cols-[22rem_1fr] xl:[24rem_1fr]: CỘT TRÁI = <div flex flex-col gap-4> ôm tree (TRÊN, lg:max-h-[44%] lg:shrink-0, overflow-auto) + list+filter (DƯỚI, flex-1, overflow-auto) — mỗi panel cuộn độc lập; CỘT PHẢI = detail (flex-1, rộng hơn nhiều, đỡ chật). <lg vẫn 1-col tree→list→detail + giữ nguyên treeOpenMobile toggle. Việc 2+3 (màu detail): thêm ACCENT map 5 tone (brand/teal/violet/amberx/greenx) → Card prop accent tô icon-chip nền nhạt (--chip-bg/--chip-fg) + heading text-{x}-700 + rail trái pseudo-element; Field label uppercase text-{x}-700 semibold (was slate-400 đơn điệu) + value font-medium text-slate-900; mỗi card/section gán 1 accent → có màu rõ nhưng tinh tế, brand #1F7DC1 + Be Vietnam Pro + avatar gradient brand GIỮ. Strategy chống truncation #53 = ONE atomic Write cả file (1556 LOC) → emit change-list + build status SỚM. 2 self-caught bug TRƯỚC build: (1) text-{teal,violet,greenx}-800 — accent palettes KHÔNG có stop -800 (chỉ 50/100/500/600/700) → Tailwind v4 silent no-class → đổi head sang -700 (all AA on white); (2) rail pseudo thiếu before:content-[''] → ::before không render box → thêm. npm run build (tsc -b strict + vite v8) PASS 0 TS err, 495ms (warning @import-order + chunk-size = pre-existing, không phải mình). 5 satellite CRUD + 15 satellite api endpoint + top-level del + 3 reads + 3 query keys (employees-list/employee-detail/departments-tree-hrm) + cây SOLUTION COMPANY + 5 tab + search/filter preserved VERBATIM (grep: 15 satellite api.post/put/delete + 3 queryKey + 5 form fns; tsc type-checks mọi payload shape = wiring bất biến). FD2 authed-screenshot SKIPPED per task instruction + gotcha #3 (rig chặn authed ProtectedRoute; anh xem qua deploy) → structural verify thay thế. fe-admin + BE NOT touched, no commit (em main commits). Tag [s66, hrm-2col-refine, eoffice-ref, accent-system, atomic-write-antitrunc, crud-preserved, build-pass, tailwind-v4-stop-gotcha].
• S65 (2026-06-16) HRM Hồ sơ Nhân sự fe-user → 3-panel master-detail NamGroup-ref: RESTRUCTURE EmployeesListPage.tsx (1201→~1140 LOC) — 6 <details> → [Org tree | List | Detail 5-tab]. Strategy chống truncation #53 = ONE atomic Write (cả file) thay piecemeal Edit (atomic Write either fully-lands or errors, KHÔNG half-break) → emit change-list TRƯỚC build → DID BOTH Part A (avatar header+5 tab+section→tab redistribution) + Part B (org tree panel) trong 1 pass, không phải defer B. Org tree consume /departments/tree verified BE-side (DepartmentFeatures.cs DepartmentTreeNodeDto, controller [HttpGet("tree")], class-Authorize only). Foundation màu mới DÙNG: .app-gradient-brand header / .icon-chip / accent palette teal/violet/amberx/greenx (avatar tones) — brand #1F7DC1 + Be Vietnam Pro KEPT. 5 satellite CRUD + 16 api endpoint + query keys preserved VERBATIM (grep-verified: 16 api.post/put/delete identical payload shape, 5 form fns intact). npm run build (tsc -b strict + vite) PASS 0 TS err, 6.13s. 1 self-caught bug: typo garbage token 网络Placeholder trong lucide import (mojibake autocomplete) → removed, all 21 icons valid (node-checked). FD2 authed-screenshot SKIPPED per explicit task instruction + gotcha #3 (rig blocks authed; anh xem qua deploy) — did static structural verify instead (grep endpoint/key preservation). fe-admin NOT touched (mirror = separate pass), no commit. Tag [s65, hrm-3panel, namgroup-ref, atomic-write-antitrunc, crud-preserved, build-pass].
• S58 (2026-06-11) fe-user redesign theo UI/UX guide AI_INFRA canonical — KEEP brand [em main proxy — truncated #53 giữa FD2 screenshot, 2nd consecutive]: Mirror design-system fe-admin S55 → 14 file fe-user (index.css heading-ladder+.label-eyebrow / 6 ui primitives — Button gần SHA-identical fe-admin chỉ khác comment / 6 shell DataTable+RowActions-additive·Layout-brand-left-rail·TopBar·PageHeader·PhaseBadge-ring·EmptyState / LoginPage polish). Rubric mới = guide 13 mục D:\Dropbox\CONG_VIEC\AI_INFRA\docs\reference\ui-ux-design-guide.md (density 14px/h32-34/radius-8/thead-sticky/action-luôn-hiện/no-font-bold). BRAND KEPT: #1F7DC1 + Be Vietnam Pro + slate (guide cho plug hue riêng). Chết NGAY TRƯỚC with_server.py screenshot /login → em main recover: build ×2 PASS 0 TS + diff-review key-stability từng file + ship e959f72; authed visual qua deploy prod (rig-gotcha #3 standing). LESSON: 2 lần liên tiếp truncate ở CÙNG điểm (sau khi sửa xong, lúc bắt đầu FD2 rig) → lần sau EMIT file-list verdict TRƯỚC khi vào screenshot loop. Tag [s58, fe-user-redesign, guide-aiinfra, keep-brand, truncated-53-proxy].
• S55 (2026-06-09) Phase-1 fe-admin redesign — density-first NAMGROUP-ref, KEEP brand [em main proxy — truncated #53]: 14 file (index.css density ladder + 6 ui primitive Button h-7/8/10 brand-ring + 6 shell + DashboardPage KPI). Brand #1F7DC1+Be Vietnam Pro KEPT. build 0 TS. Visual loop BLOCKED authed-rig#3 → chỉ /login. → S58 mirror sang fe-user. (detail archive nếu cần). Tag [s55, density-namgroup, keep-brand].
• S47 (2026-06-02) FD2 RIG VERIFIED ✅ — first real spawn. Ran full FD2 loop end-to-end on fe-user /login: read DS (Tailwind v4 CSS-first, corrected stale config-path assumption) → started Vite via with_server.py → Playwright screenshot 375+1440 → Read PNGs → FD4 critique → 1-line contrast fix → re-screenshot confirmed → npm run build 0 TS error. Closes adap-report 2026-06-02-Agent-frontend-designer-floor FD2 runtime proof. 2 Vite gotchas captured above. Loop is REAL, not theoretical.

Moved @S160 (2026-07-29) — verbatim from L1 Activity log (moved-not-cut)

• S69 (2026-06-17) OfficeDashboardPage.tsx fe-user — E-Office landing, PURO HomePage, COMPOSES 3 shared widgets: built pages/office/OfficeDashboardPage.tsx (~400 LOC) over EXISTING data hooks of 4 modules. Read-first: 3 ui widgets (exact prop sigs) + 4 source pages (ProposalsListPage/WorkflowAppsListPage/ItTicketsPage/MeetingCalendarPage) to harvest queryKey+endpoint + types + App.tsx routes. Reused hooks verbatim → shared TanStack cache, ZERO new API/BE: GET /proposals (+inboxOnly query for needs-my-action) · /leave|ot|travel-requests (merged, countByStatus client-side) · /it-tickets · /meeting-bookings (today window). Layout = PageHeader(brand) + lg:grid-cols-3 [LEFT col-span-2 = 4 WidgetCards w/ KpiCard filter-chip bodies | RIGHT col-span-1 = "Công việc của tôi" hero+MetricRows + "Thao tác nhanh" 3 buttons], 1-col <lg. Routing insight (verified App.tsx): đơn-từ + ticket have NO standalone /new route (creation in-page) → quick-actions point at landings /workflow-apps/leave + /it-tickets (only /proposals/new is a real create route) so no link hits the * "chưa build" fallback. Per-widget graceful states: WidgetError(retry)/WidgetSkeleton(pulse, motion-reduce)/empty — never blocks. a11y full (role=button+Enter/Space+focus-ring on clickables, reduced-motion). npm run build (tsc -b strict + vite v8) PASS 0 TS err, 434ms (only pre-existing @import-order + chunk-size + INEFFECTIVE_DYNAMIC_IMPORT warnings — none from new file). Routing/menu NOT wired (next agent; page not yet in App.tsx). fe-admin NOT mirrored. FD2 authed-screenshot SKIP (ProtectedRoute + rig gotcha #3 — verify via deploy). Tag [s69, office-dashboard, compose-3-widgets, reuse-hooks-shared-cache, no-new-be, routing-existing-only, build-pass].
• S69 (2026-06-17) Văn phòng số / Đơn từ fe-user RE-SKIN (PURO + HRM visual lang) — 2 file, CONSUMES shared ui (parallel fan-out, 7 agents same app): surgical re-skin (KHÔNG rewrite) pages/office/WorkflowAppsListPage.tsx + WorkflowAppDetailPage.tsx (:kind-driven leave/ot/travel/vehicle via KIND_CONFIG). LIST: swap @/components/PageHeader(constrained)→@/components/ui/PageHeader(eyebrow "Văn phòng số · Đơn từ" / title từ KIND_CONFIG / icon per-kind / accent teal) + status filter = ROW 4 ui/KpiCard (Tất cả teal / Đã gửi duyệt amberx / Trả lại violet / Đã duyệt greenx, grid-cols-2 sm:grid-cols-4) + slate table chrome (thead uppercase 11px slate-500, hover teal-50). Filter là CLIENT-SIDE view — added useState<StatusFilter> + 2 useMemo (counts + visibleItems) DERIVED over already-fetched items; KHÔNG touch query/endpoint/queryKey/navigation (page chỉ fetch page:1 như cũ, không có filter-state sẵn nên thêm view-layer = thuần presentation; empty-state phân biệt "chưa có data" vs "không có đơn ở trạng thái này"). DETAIL: ui/PageHeader teal + 4 section dùng local Card(accent-rail pseudo before:bg-{x}-500 + icon-chip) + Field(label uppercase text-{x}-700, value text-brand-800) — copy idiom HRM EmployeesListPage (KHÔNG import HRM, helper local riêng). Accent gán: Thông tin=teal · Số dư phép=greenx · Quy trình=violet · Ý kiến=brand. Status badge giữ WORKFLOW_APP_STATUS_BADGE. Drop raw "⚠️" emoji trong over-budget banner→text thuần (anti-slop FD3). ALL data logic VERBATIM (grep-verified): 2 query [endpoint,id]+['approval-workflows-v2',applicableType] (key/endpoint/enabled y nguyên) · 3 mutation pinWorkflow(PUT /workflow)/submit(POST /submit)/action(POST /{k}) body+onSuccess+invalidate identical · 3 state + flags isDraft/isInWorkflow/hasWorkflow + mọi onClick/nav target bất biến. gotcha Tailwind-v4 stop: dùng CHỈ -50/-500/-700 cho teal/violet/amberx/greenx (no -800) — border-l-greenx-500/bg-amberx-50/text-amberx-700 đều stop tồn tại (index.css verified). Self-caught: SendHorizonal (KpiCard "Đã gửi duyệt" icon) export-aggregation-line trong lucide d.ts → đổi Send (proven-safe export) tránh alias-risk. Self-review: mọi import resolve, 0 unused local (noUnusedLocals strict) — Info/Wallet/GitBranch/MessageSquareText đều dùng. KHÔNG run npm build (em main builds central, 7-agent parallel interference) + KHÔNG modify ui/index.css (other agents edit). FD2 authed-screenshot SKIP (ProtectedRoute + rig gotcha #3 — verify via deploy). fe-admin NOT mirrored. Tag [s69, eoffice-donutu-reskin, puro-hrm-visual, consume-ui-pageheader-kpicard, client-side-filter-view, logic-verbatim, no-build-parallel-fanout, lucide-alias-dodge].