Files

T

eomsangdonandClaude Opus 5 eb30b774f8 chore(docs): docs 폴더 git 추적 전환 · PLAN·OWNERS 최상위 이관

- `docs/` 를 .gitignore 에서 빼 git 추적 대상으로 전환 (위키·완료 이력·검증 기록)
- `docs/raw/PLAN.md` · `docs/raw/OWNERS.md` 를 저장소 최상위로 이동 후 .gitignore 에 등록
  — 창끼리 공유하되 저장소에는 안 올리는 장부
- 살아 있는 경로 참조 7개 파일 정정 (아카이브 107건은 그때 사실이라 그대로 둠)
- graphify 날짜별 산출물(`docs/wiki/graphify-out/20*/`) 제외 — `graphify update` 가 다시 만듦

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-09 18:19:07 +09:00

3.3 KiB

Raw Blame History

완료 계획서 — B01 대시보드: 컨테이너 4행 표시 + 스크롤

일자: 2026-08-08
상태: 완료 (검증 완료)

배경

대시보드의 목록형 컨테이너는 자료가 쌓일수록 세로로 계속 길어져 페이지가 늘어난다. 4행까지만 보이고 나머지는 컨테이너 안에서 스크롤하게 바꾼다(2026-08-08 사용자 지시).

대상 6개 컨테이너와 "1행"의 단위:

컨테이너	생성 함수	1행 =
프로젝트	`projectTable()`	표 행
임시 보관함	`buildTempUploadSection()` → `.b01-temp__list`	묶음(그룹)
사용자 관리	`userTable()` / `memberTable()`	표 행
가입 요청	`joinRequestTable()`	표 행
회사 관리	`companyTable()`	표 행
시스템 로그	`auditLogTable()`	표 행

설계 결정

행 높이를 상수로 박지 않는다. 프로젝트 표는 셀 안에 단계 막대가 들어가고 임시 보관함 묶음은 제목이 접혀 높이가 제각각이다. max-height: 4 × 고정값으로는 어긋난다. 대신 4번째 항목의 실제 아래쪽 좌표를 재서 max-height를 정한다 — getBoundingClientRect() 차이라 표·묶음 어느 쪽이든 같은 코드로 맞는다.
공용 헬퍼 1개. ui_template_general_blocks.ts에 limitVisibleRows(host, items, visible)을 둔다. table()에 선택 인자 maxRows를 추가해 표는 자동 적용, 임시 보관함은 목록을 다시 그릴 때 직접 호출한다.
머리행 고정. 스크롤 중 표 머리행이 위에 붙어 있어야 어느 열인지 알 수 있다 — thead th에 position: sticky.
항목이 4개 이하면 스크롤바를 만들지 않는다 — max-height를 지우고 원래대로 둔다.
측정 시점은 DOM 삽입 후 requestAnimationFrame. 창 크기 변경 시 다시 잰다.

구현 체크리스트

ui_template_general_blocks.ts:42 — limitVisibleRows() 추가(재측정 함수를 돌려준다), table()에 maxRows 선택 인자
ui_template_general_layout.css:55 — .ui-general-block__scroll-limit 세로 스크롤, sticky 머리행(+불투명 배경)
B01_Dashboard_UI_Common.ts:5 — DASHBOARD_VISIBLE_ROWS = 4 공용 상수
B01_Dashboard_UI_Projects.ts — projectTable()
B01_Dashboard_UI_Admin.ts — userTable(), auditLogTable()
B01_Dashboard_UI_Company.ts — memberTable(), joinRequestTable(), companyTable()
B01_Dashboard_UI_TempUpload.ts — 묶음 목록 4개까지, 재렌더 후 재측정. 묶음 내부 파일 표는 제외(접혀 있고 별도 맥락)
구현 중 발견한 두 가지 처리:
- 묶음을 펼치면 높이가 달라진다 → 접기/펼치기 핸들러에서 재측정
- 목록을 다시 그릴 때마다 resize 청취자가 쌓인다 → WeakMap으로 이전 것을 걷어내고 다시 등록
prettier + tsc --noEmit 통과 (exit 0)

완료 조건

6개 컨테이너 모두 항목 5개 이상일 때 4행 높이에서 잘리고 안쪽 스크롤이 생긴다. 4개 이하면 지금과 동일. 표 머리행은 스크롤해도 보인다.

미검증 사항

브라우저 실물 확인은 하지 않았다(현재 DB가 비어 있어 5행 이상을 만들 자료가 없다). 프로젝트를 5건 이상 등록한 뒤 육안 확인 필요.

3.3 KiB Raw Blame History Unescape Escape