Files
landing_page/REQUIREMENTS.md
T

113 KiB
Raw Blame History

📐 요구사항 명세서 (Requirements Specification)

경북대학교 AI 에이전트 네트워크 연구실 (ANL) 공식 홈페이지

항목 내용
문서 ID REQ-ANL-WEB-001
버전 1.12
작성일 2026-07-30
작성자 claude (canary-projects-landing-page-creator-claude) · Role: planner
상태 승인 (Approved) — v1.5에서 D-01 확정(A·B안 기각 / intl-conf 폐기 · 3개 카테고리), v1.6에서 D-06 확정(레이아웃 컨테이너 3계층 분리). v1.7에서 §6.1.2 Research Project PageView 신설 — 신규 미결 D-07(🔴 Funder 실데이터 부재)·D-08(🟡 프로젝트 집합 범위)은 각 기본값으로 구현을 차단하지 않는다. 잔여 미결 D-02·D-03·D-05는 🟡 등급으로 각 기본값이 적용되어 승인을 보류하지 않는다. v1.9에서 §8.7 색 토큰 알파 계약(R-8.21R-8.24)을 신설하고 D-09(Publications 인덱스 라우트)를 확정했다. v1.10에서 개발 팀장(Agy) 이의제기를 반영해 D-09를 Overview 뷰로 재확정하고 R-8.25·AC-41을 신설했다. v1.11에서 강조색 교체 커밋(eaddc4f)의 대비 붕괴를 규명해 **§8.7에 R-8.26R-8.28**(강조색 대비 바닥값 · 색값 변경 재측정 의무 · 명암 반전 계약)을 신설하고 D-10을 확정(--cobalt #4A7CE8 유지 + --cobalt-dark #32549E 재조정), AC-43~AC-46(대비 게이트 Gate 10 및 그 폴트 인젝션)을 신설했다. 신규 미결 D-11(🟡 text-vermillion 소형 텍스트 30여 곳)은 현행 유지를 기본값으로 하여 구현을 차단하지 않는다. v1.12에서 개발 팀장(Agy) 이의제기(Job 7f136931)를 반영해 D-10의 배지·칩 전경/배경을 재확정(bg-cobalt text-ink 폐기 → bg-{accent}-dark text-ivory)하고 R-8.29(반전 토큰 쌍의 dark: 불필요 원칙)·AC-47(팔레트 외 색 상한)을 신설했다
대상 독자 General Manager, Developer Team Leader(Agy), Reviewer Team Leader(Cline), 지도교수
선행 문서 README.md, .agents/MULTI_AGENT_RULES.md, refer_landing_page/docs/DESIGN.md
적용 범위 refer_landing_page/ (Next.js 14 App Router 애플리케이션) 전체

본 문서의 성격: 코드를 포함하지 않는 명세 문서입니다. 데이터 스키마와 인터페이스 정의에 한해 TypeScript 타입 표기를 사용하나, 이는 계약(contract) 기술을 위한 것이며 구현 코드가 아닙니다.


1. 원본 요구사항 (사용자 제공 · 정본)

아래는 사용자가 직접 작성한 요구사항 원문이며, 본 명세서 전체의 정본(normative source) 이다. 이하 모든 절은 이 원문을 구체화한 것이며, 원문과 충돌하는 서술이 있다면 원문이 우선한다.

- 홈페이지 상단 탭은 다음과 같음
    - Home: 연구실 소개, 연구실 주요 연구 분야 소개, 오시는길
    - Members: 기존 정보 그대로 보존되어야 함
    - Publications: 기존 정보 그대로 보존되어야 하며, 다음 카테고리로 구분되어야 함
        - International Conference
        - International Journal & Conference
        - Domestic Journal & Conference
        - Patent
    - Lectures: 기존 정보 그대로 보존되어야 함
    - Standardization: 기존 정보 그대로 보존되어야 함

1.1 원문에서 도출되는 최상위 원칙

ID 원칙 근거 문구
PR-01 무손실 보존 (Lossless Preservation) — 레거시 ISL-2026/의 레코드는 한 건도 누락되지 않고, 문구·표기·순서가 임의로 변형되지 않은 채 이관되어야 한다 "기존 정보 그대로 보존되어야 함" (4회 반복)
PR-02 상단 탭 5종 고정 — Home / Members / Publications / Lectures / Standardization "홈페이지 상단 탭은 다음과 같음"
PR-03 Home 3구성 — 연구실 소개 · 주요 연구 분야 소개 · 오시는 길 Home 항목
PR-04 Publications 분류 — 원문에 명시된 4개 카테고리 라벨을 출발점으로 삼는다. (v1.5: 원문 1번 International Conference는 §12.1 D-01 확정에 따라 폐기되어 최종 3분류로 확정. 원문 문구 자체는 §1에 정본 그대로 보존하며, 이 축소는 해당 라벨에 배정된 레코드가 0건이므로 PR-01 무손실 원칙과 충돌하지 않는다) Publications 항목

⚠️ PR-01의 해석: "그대로 보존"은 데이터의 무손실을 의미하며, 레거시의 시각적 표현을 그대로 복제하라는 뜻이 아니다. 표현은 신규 디자인 시스템(§8)을 따르되, 레코드 단위의 정보량은 100% 보존한다. 점진적 노출(더 보기·접기)은 전체 레코드가 접근 가능한 한 허용된다(§9.4 참조).


2. 개요 및 배경 (Overview & Background)

2.1 목적

경북대학교 컴퓨터학부 연구실이 사물인터넷 표준 연구실 (IoT Standards Laboratory, ISL) 에서 AI 에이전트 네트워크 연구실 (AI Agent Networking Laboratory, ANL) 로 연구 정체성을 전환함에 따라, 공식 홈페이지를 다음 두 축으로 재구축한다.

  1. 정체성 전환 (Identity Transformation) — 연구실 명칭·연구 서사·시각 언어를 ANL 및 5대 핵심 연구 기둥 기준으로 전면 교체한다.
  2. 실데이터 마이그레이션 (Data Migration) — 레거시 사이트 ISL-2026/에 축적된 실측 연구 실적 총 223건(국제 논문 68 · 국내 논문 80 · 특허 75)과 표준화 문서 약 55건을 신규 애플리케이션의 타입 안전한 데이터 구조로 무손실 이관한다(PR-01).

2.2 현재 상태 (As-Is)

자산 경로 상태
레거시 공식 홈페이지 ISL-2026/ 정적 HTML. 실데이터 원본(Single Source of Truth)
신규 프로토타입 refer_landing_page/ Next.js 14.2.35 / React 18 / TS 5 / Tailwind 3. 라우트 5종 구현, 콘텐츠는 대부분 placeholder
연구 자산 multi-agent-orchestration/ 5대 연구 기둥의 근거 자료 (SLIDE.md, chapters/, lecture_summary.md)

완료된 선행 작업 (커밋 e35b46d315ba9ecdd0db3, 3차 교차 리뷰 [VERDICT: PASS])

  • 연구실 명칭 ANL 전환: Header / Footer / metadata / package.json(anl-landing) / docs/DESIGN.md / tailwind.config.ts
  • /intro 커버 스프레드를 5대 연구 기둥 3+2 매거진 조판으로 재구성
  • 강조색 시맨틱 계약 재정의: vermillion = Agent Eng / Orchestration (홀수), cobalt = MCP / A2A Protocol (짝수)
  • 빌드 게이트 정비: .eslintrc.json 도입, lint / tsc / build 3종 통과

미해결 상태

  • /(루트) 라우트 부재app/page.tsx가 없어 사이트 루트 직접 접근 시 404. PR-02의 Home 탭이 존재하지 않는다.
  • /members, /publications, /lectures, /standardization 본문이 전부 가상의 placeholder (연구원 A (placeholder), 가상 논문, 실재하지 않는 oneM2M/OMA LwM2M 기여 내역)
  • 레거시 실데이터 223건 + 표준 문서 약 55건 전량 미이관 — PR-01 미충족

3. 이해관계자 및 역할 (Stakeholders & Roles)

주체 역할 본 명세서에 대한 책임
지도교수 (고석주 교수) 콘텐츠 소유자 실데이터 정확성 최종 확인, §12 D-02·D-03·D-05 결정 (D-01은 v1.5에서 확정)
General Manager 오케스트레이터 잡 분배, 마일스톤 게이팅, 미결 결정 에스컬레이션
Agy (creator) 개발 팀장 §6·§7 구현, 데이터 추출·이관, 컴포넌트 개발
Cline (reviewer) 리뷰어 팀장 §9 비기능 요구사항 검수 (UI/UX 반응형, SEO, 접근성)
Claude (planner and reviewer) 기획·리뷰어 팀장 본 명세서 작성·유지, 데이터 무결성 교차 검증, 최종 Verdict

4. 정보 구조 (Information Architecture)

4.1 사이트맵

/                        Home            [🆕 신규] 연구실 소개 · 주요 연구 분야(5대 기둥) · 오시는 길
├── /members             Members         지도교수 · 재학 연구원 16명 · 졸업생 60명
├── /publications        Publications    개요 · 카테고리 분류 · Top 10 (총 223건)
│   ├── /publications/intl-journal-conf      International Journal & Conference (68)
│   ├── /publications/domestic-journal-conf  Domestic Journal & Conference (80)
│   └── /publications/patent                 Patent (75)
├── /lectures            Lectures        2004 Spring ~ 2026 Spring, 45개 학기
└── /standardization     Standardization 표준화 기구 6곳 · 표준 문서 44건

4.2 IA 설계 결정

ID 결정 근거
IA-01 현행 /intro의 커버 스프레드를 /(Home)으로 승격한다 PR-02가 상단 탭에 Intro를 포함하지 않으며, PR-03의 "연구실 소개"가 Home의 구성 요소로 명시되어 있다. /intro를 별도 유지하면 Home과 콘텐츠가 중복된다. 부수 효과로 기존 / 404 결함이 해소된다.
IA-02 /intro/로 308 영구 리다이렉트한다 3차에 걸친 리뷰 리포트·문서가 /intro를 참조하고 있어 링크 안정성이 필요하다. next.config.jsredirects()로 처리하며 별도 페이지 파일을 남기지 않는다.
IA-03 (v1.1 개정 · v1.5 수치 갱신 · v1.9 개정 · v1.10 재개정) Publications 카테고리는 라우트 세그먼트 /publications/[category] + generateStaticParams() 로 구현한다. /publicationsredirect()가 아니라 자체 콘텐츠를 렌더하는 실체 라우트로 유지하며, 그 콘텐츠는 하위 카테고리 어느 것과도 중복되지 않는 Overview 뷰(카테고리별 집계 + 최신 실적 하이라이트)로 한다 — D-09 재확정(v1.10). redirect() 전용 라우트는 산출 HTML에 <main>·container-content가 존재하지 않아 AC-25를 구조적으로 위반하므로 금지하고, 첫 카테고리 본문을 그대로 재렌더하는 방식은 동일 DOM 정적 HTML 2본을 생성해 R-8.25를 위반하므로 금지한다. 상단 CategoryNav3개 카테고리 탭만 노출하며 All/전체 탭을 두지 않는다(commit 22a31ff 결정 존중) — Overview에서는 활성 탭이 없는 것이 정상 상태다 v1.0에서 "단일 라우트 + ?cat= 쿼리"였으나 §8.5의 실측 검증 결과에 따라 개정. 세그먼트 방식은 카테고리별 완전한 정적 HTML 3개(D-01 확정 전 4개)를 빌드 타임에 생성해 공유 링크가 필터 상태를 포함한 문서를 그대로 제공하며(AC-05 취지 충족), 뒤로/앞으로 가기·프리페치·스크롤 복원이 Next 라우터에서 기본 제공된다. 슬러그를 카테고리 레지스트리에서 도출하므로 라벨 변경이 레지스트리 한 곳 수정으로 끝난다는 v1.0의 근거는 그대로 유지된다(→ D-01 리스크 완화 불변). 상단 탭은 5종 그대로이므로 PR-02와 충돌하지 않는다(하위 라우트일 뿐 최상위 탭이 아니다).
IA-04 내비게이션 항목은 PR-02의 5개로 고정한다 components/Header.tsx의 데스크톱 내비가 5개 항목 기준으로 조판되어 있다. 항목 증감 시 헤더 레이아웃 재설계가 선행되어야 한다.

5. 콘텐츠 정본: 핵심 연구 분야

PR-03의 "연구실 주요 연구 분야 소개"에 해당하는 콘텐츠다. README.md §2를 정본(canonical) 으로 하며, UI의 모든 연구 서술은 여기서 파생되어야 한다. 어휘를 임의로 변형하지 않는다.

# 분야 (KO) 분야 (EN) 핵심 키워드 강조색
1 AI Agent 기능 확장 프로토콜 Extensibility & Protocol MCP, SKILL, CLI 코딩 에이전트 vermillion
2 멀티 에이전트 협업 및 오케스트레이션 Multi-Agent Systems HERDR, crewAI, LangGraph cobalt
3 에이전트 상호운용성 개방형 표준 Interoperability Standards A2A, ACP, Agent Card vermillion
4 AIoT & 고성능 통신 백본 High-Performance Backbone gRPC/QUIC, Protobuf, MQTT/CoAP cobalt

R-5.1 강조색은 §8.3의 홀수/짝수 규칙을 따른다. 분야 순서를 변경하면 색 배정도 함께 갱신해야 한다. R-5.2 핵심 연구 분야 서술 전문(全文)은 Home에만 두고, 타 페이지에는 요약 키워드만 노출한다. 동일 문장을 여러 페이지에 중복 하드코딩하지 않는다. R-5.3 레거시 introduction.html의 구 연구 분야(QUIC, CoAP, IVI, VLC/OWC, mSCTP, SCTP, Mobility Management, Tabu Search 등)는 Home의 연구 분야 소개에서 제외한다. 단, 이들 주제로 산출된 논문·특허·표준은 PR-01에 따라 실적 페이지에 전량 보존된다.


6. 페이지별 상세 요구사항

각 항목의 [MUST] / [SHOULD] / [MAY]는 RFC 2119 수준을 따른다.

6.1 Home (/) — 🆕 신규 라우트

PR-03에 따라 연구실 소개 · 주요 연구 분야 소개 · 오시는 길 3개 블록을 필수 포함한다.

ID 요구사항 수준
H-01 app/page.tsx를 신규 생성하고, 현행 app/intro/page.tsx의 섹션 구성(커버 스프레드 → 지표 카운터 → Mission 풀쿼트 → 핵심 연구 분야 → Focus Areas)을 이관한다 MUST
H-02 (v1.7 개정) 킥커 경북대학교 컴퓨터학부 · AI Agent Networking Lab (ANL)는 유지한다. 슬로건 헤드라인(에이전트 네트워크의 / 미래를 짓다, 디스플레이 Agents / in Motion)은 §6.1.2 Research Project PageView로 교체할 수 있다. 단 교체 시에도 H-03(연구실 소개 서술 블록) · H-04(주요 연구 분야 그리드) · H-05(오시는 길) · H-06·H-07(지표 카운터) · H-10(HeroComposition)은 반드시 존속한다 — 히어로 재구성 중 이들이 유실되면 AC-02가 즉시 실패한다 MUST
H-03 [연구실 소개] 연구실 개요·지도교수·비전을 서술하는 블록을 배치하고, 상세는 /members로 연결한다 MUST
H-04 [주요 연구 분야] §5의 핵심 연구 분야 전문을 매거진 조판으로 노출한다 MUST
H-05 [오시는 길] 아래 §6.1.1 요구사항을 충족하는 블록을 배치한다 MUST
H-06 지표 카운터는 데이터 배열에서 도출된 값만 사용한다. 근거 없는 홍보성 수치(가동률·만족도 등) 게시 금지 MUST
H-07 H-06의 권장 지표: 연구 분야 = 4, 누적 연구 실적 = 논문+특허 합계(223), Issue · 발행 = 2026(static) SHOULD
H-08 대표 실적 하이라이트 — 최신 국제 저널 3건을 /publications로 연결 SHOULD
H-09 표준화 기여 요약 밴드 — 기구 6곳 약칭 Marquee + /standardization 연결 SHOULD
H-10 HeroComposition SVG는 현행(A2A 노드 메시 × QUIC/gRPC 스트림)을 그대로 재사용한다 MUST
H-11 /intro/ 308 리다이렉트를 next.config.js에 등록한다 (IA-02) MUST
H-12 components/Header.tsx의 브랜드 링크 href/intro/로 바꾸고, 내비 배열 첫 항목을 Home(/)으로 교체한다 MUST

6.1.1 오시는 길 (Directions) 세부 요구사항

레거시 index.html에 주소가 HTML 주석 처리된 상태로 존재한다. 이를 복원해 사용한다.

ID 요구사항 수준
H-13 소재지를 표기한다: 경북대학교 IT대학 5호관(415동) 527호 / School of Computer Science and Engineering, Kyungpook National University MUST
H-14 연락처를 표기한다: sjkoh@knu.ac.kr (지도교수). 전화·팩스는 레거시에 존재하지 않으므로 창작하지 않는다 MUST
H-15 소속 기관 링크를 제공한다: KNU(knu.ac.kr), 컴퓨터학부(cse.knu.ac.kr), IT대학(it.knu.ac.kr) MUST
H-16 지도 표현 방식은 §12 D-03의 결정을 따른다. 외부 지도 스크립트를 임의로 도입하지 않는다(R-9.13 최소 의존성 원칙과 충돌) MUST
H-17 주소는 시맨틱 <address> 요소로 마크업한다 MUST
H-18 대중교통·주차 안내는 레거시에 데이터가 없으므로 이번 범위에서 제외한다. 필요 시 지도교수 확인 후 별도 잡으로 추가 MUST

6.1.2 Research Project PageView (v1.7 신설)

Home의 슬로건 히어로를 실제 연구 프로젝트 카드 뷰로 전환한다(H-02 개정).

레거시 실측 — 실재하는 프로젝트 3건: ISL-2026/index.html <section class="portfolio-block skills">card-title/card-text 및 이어지는 확장 섹션 2개가 유일한 원본이다. (projects-cards 클래스는 표준화 기구 로고 그리드이며 연구 프로젝트가 아니다 — 오독 주의.)

# Title 확장 정보
1 IoT Standards
2 CCIS "This project is developing a series of standards in IEC/TC 100/TA 17"
3 VLC-IoT "This project is purposed to develop a series of standards in ITU-T SG20."
ID 요구사항 수준
PJ-01 데이터는 content/projects.ts에 두고, 타입은 ResearchProject 로 명명한다. StandardsBody.projects(WG 단위 표준화 프로젝트)와 의미가 다르므로 이름을 재사용하지 않는다 MUST
PJ-02 content/projects.tsscripts/extract/generate_all.pyparse_projects()로 자동 생성한다. 수작업 편집 금지(기존 AUTO-GENERATED 규약 · AC-24) MUST
PJ-03 abstract는 레거시 원문을 바이트 동일하게 보존한다(PR-01). 요약·재작성·line-clamp로 인한 정보 손실 금지 MUST
PJ-04 periodcontent/standards.ts standardsBodies[].period조인해 도출한다. 교차 검증 출처는 ISL-2026/sjkoh/index.html의 Project Editor 이력이다 MUST
PJ-05 deliverablescontent/standards.ts projects[].documents[]조인해 도출한다. 임의 생성 금지 MUST
PJ-06 keywords[]모든 원소는 해당 프로젝트 abstract 원문에 부분문자열로 실제 등장해야 한다. 키워드 창작을 기계적으로 차단하기 위한 규칙이다 (→ AC-30) MUST
PJ-07 funder옵셔널이며 현재 전건 미확보다(§12.1 D-07). 값이 없으면 UI에 해당 행·라벨·자리표시자를 렌더하지 않는다(R-9.18). 레거시가 실제로 명시하는 표준화 트랙은 Funder가 아닌 Standards Track 라벨로 노출한다 MUST
PJ-08 [금지] 활성 슬라이드만 마운트하는 캐러셀을 구현하지 않는다. 프로젝트 전건이 항상 DOM에 존재해 정적 HTML에 포함되어야 한다(R-8.15 · AC-27) MUST
PJ-09 [금지] 슬라이드·페이지 상태를 URL에 동기화하지 않는다. searchParams prop은 라우트를 ƒ Dynamic으로 전환시키고(R-8.11), useSearchParams()<Suspense> 경계를 요구하며 경계 안쪽 콘텐츠가 정적 HTML에서 누락된다(R-8.12·R-8.13). 상태는 컴포넌트 로컬로 유지한다 MUST
PJ-10 [금지] 캐러셀·슬라이더 외부 라이브러리를 도입하지 않는다(swiper·embla 등). 현행 런타임 의존성 3종(next/react/react-dom)을 유지한다(R-9.13) MUST
PJ-11 트랙은 CSS scroll-snap + 컨테이너 내부 overflow-x-auto 로 구현해 JS 비활성 상태에서도 전건 열람이 가능해야 한다. 페이지 레벨 가로 스크롤을 유발해서는 안 되며(R-9.15·AC-19), full-bleed를 위해 w-screen을 쓰지 않는다(R-8.18) MUST
PJ-12 데이터 렌더는 서버 컴포넌트, 인터랙션(버튼·인디케이터)만 "use client" 로 분리한다. 페이지네이션 인디케이터는 <a href="#project-…"> 앵커로 두어 JS 없이도 동작하게 한다. 스크롤 애니메이션은 prefers-reduced-motion 존중(components/Counter.tsx·globals.css 선례) MUST
PJ-13 (v1.8 개정) 반응형 카드 노출: 360 px 1장 / md 2장(w-[calc(50%-12px)]2×(50%12px)+24px = 100%대수적 정확값) / desktop(1240 px)에서는 스크롤 트랙이 아니라 desktop:grid desktop:grid-cols-3 desktop:overflow-visible 정적 3열로 전환하고 카드는 desktop:w-full로 둔다. 데스크톱 카드 폭에 퍼센트 연산을 사용하지 않는다. 근거: Tailwind grid-cols-3repeat(3, minmax(0, 1fr))로 전개되어 min-content 넘침을 구조적으로 차단하며, overflow-visible이 해당 요소를 스크롤 컨테이너에서 해제해 스크롤 잔재·불필요한 포커스 가능 스크롤 영역을 함께 제거한다(→ AC-34). 브레이크포인트는 desktop 토큰만 사용한다(R-8.20 · AC-26) MUST
PJ-14 접근성: 트랙 role="group" + aria-roledescription="carousel", 카드 aria-roledescription="slide" + aria-label="N개 중 M번째", 버튼 aria-labelaria-controls, 카드 제목은 <h3> MUST
PJ-15 (v1.8 신설) 카드에 min-w-0 과 텍스트 줄바꿈(break-words, 국문은 R-9.16 break-keep)을 적용한다. flex-shrink: 0인 플렉스 아이템은 콘텐츠의 min-content 폭 이하로 줄지 않으므로, standardsTrack(IEC/TC 100/TA 17deliverables[].ref(ISO/IEC TR 30189)처럼 /를 포함해 기본 줄바꿈 기회가 없는 문자열이 폭 수식과 무관하게 트랙을 넘치게 할 수 있다. PJ-13의 그리드 전환은 데스크톱만 보호하므로, 모바일·태블릿 구간은 이 규칙으로 보호한다 MUST
PJ-16 (v1.8 신설) 스크롤바를 숨기는 경우([scrollbar-width:none] 등) 잔여 넘침이 시각적 단서 없이 은폐되므로, AC-34 검증을 반드시 동반한다 MUST

6.2 Members (/members) — PR-01 적용

레거시 실측: 재학 16명(교수 1 · Ph.D. 1 · Ph.D. Candidate 4 · Ph.D. Student 5 · M.S. Candidate 3 · M.S. Student 2), 졸업생 60명(2007~2026).

ID 요구사항 수준
M-01 현행 placeholder(연구원 A~G) 전량을 ISL-2026/member.html 실데이터로 교체한다. 재학 16명 + 졸업생 60명 = 76명 전원 보존 MUST
M-02 지도교수 피처 스프레드: 고석주 교수 / Prof. Seok-Joo Koh, 이메일 sjkoh@knu.ac.kr, 개인 홈페이지(ISL-2026/sjkoh/) 및 GitHub(github.com/sjkoh12) 링크 MUST
M-03 재학 연구원을 학위 과정별로 그룹핑하고, 레거시의 Candidate/Student 구분을 보존한다 MUST
M-04 소속 학과가 컴퓨터학부와 다른 연구원(정보보호학과·정보과학과·과학기술학과·ICT융합학과·컴퓨터학부 등 8명)은 소속 표기를 함께 노출한다 MUST
M-05 졸업생 60명을 졸업 연도 역순으로 게시하고, 학위·졸업시점·전공·현 소속을 표기한다 MUST
M-06 졸업생 목록은 최근 3년을 기본 노출하고 나머지는 더 보기로 확장한다. 확장 시 60명 전원이 노출되어야 한다 (PR-01) SHOULD
M-07 이름 표기 형식을 통일한다: 한글명 (Romanized Name). 외국인 연구원(Hoang Anh Dang 등)은 원문 그대로 표기 MUST
M-08 인원 통계 카운터는 배열 길이에서 도출한다 (H-06 원칙 동일 적용) MUST
M-09 개인 이메일·연락처는 지도교수 외 게시하지 않는다 MUST
M-10 졸업생의 현 소속 문구(He is now with ...)는 레거시 원문 정보를 보존하되, 국문 페이지 맥락에 맞게 소속명만 추출해 표기해도 무방하다 SHOULD

6.3 Publications (/publications) — PR-01 + PR-04 적용

레거시 실측: paper-international.html 68건(저널 67 + 학술대회 1) · paper-domestic.html 80건(KCI 등재 48) · patent.html 75건 = 총 223건.

ID 요구사항 수준
P-01 (v1.5 개정) 3개 카테고리를 사용한다: International Journal & Conference / Domestic Journal & Conference / Patent. D-01 확정(v1.5): PR-04의 1번 라벨 International Conference는 대응 레거시 원본이 없어 실측 0건이었고, 2번 라벨의 부분집합으로 범위가 중첩되므로 단독 카테고리를 폐기한다. 국제 학술대회 논문(실측 1건)은 International Journal & Conference에 포함해 보존한다 MUST
P-02 카테고리는 레지스트리 상수 1곳에 정의하고, 개별 레코드는 category 판별 필드만 갖는다. 라벨 변경·교체가 레지스트리 수정만으로 완결되어야 한다 MUST
P-03 223건 전량 보존 — 어떤 카테고리에도 배정되지 않아 누락되는 레코드가 있어서는 안 된다. (v1.5 확인: D-01 확정으로 카테고리가 3개로 축소되었으나 intl-conf 배정 레코드가 0건이었으므로 축소는 무손실이다. 실측 68 + 80 + 75 = 223) MUST
P-04 레거시 paper-international.html은 저널과 학술대회 논문이 혼재되어 있다(학술대회 1건 확인: International Conference on ICTC, 2023). 이관 시 게재처 문자열로 판별해 분류한다 MUST
P-05 기본 정렬은 발행 연월 내림차순, 동일 연월 내에서는 레거시 게시 순서를 보존한다 MUST
P-06 (v1.1 개정) 카테고리 필터 UI를 제공한다. 필터 상태는 URL 경로(/publications/<slug>)에 반영되어 공유 가능한 링크가 되어야 한다. 슬러그는 §7.2 PubCategory 값을 그대로 사용한다. 구현 방식은 §8.5의 렌더링 제약을 반드시 따른다 MUST
P-06a (v1.1 신설) 카테고리 내비게이션은 next/link<Link>로 구현한다. window.history.pushState 직접 호출·useSearchParams() 사용 금지 (§8.5 R-8.11~8.14) MUST
P-07 전체 223건을 단일 화면에 일괄 렌더하지 않는다. 연도별 그룹 헤더 + 지연 확장 또는 페이지네이션으로 초기 렌더 부하를 제한하되, 전 레코드가 접근 가능해야 한다 (§9.4) MUST
P-07a (v1.1 신설) 레코드 목록 자체는 서버 컴포넌트에서 정적 HTML로 렌더되어야 한다. 목록 데이터를 클라이언트 컴포넌트 내부나 <Suspense> 경계 안쪽에 두어 정적 문서에서 누락시켜서는 안 된다 (§8.5 R-8.15). 근거: JS 미실행 환경·크롤러에서도 PR-01의 전 레코드가 문서에 존재해야 한다 MUST
P-08 국내 논문의 (KCI) 등재 표시를 배지로 보존한다 (48건) MUST
P-09 특허 레코드는 다음을 모두 보존한다: 발명자 목록, 출원번호·출원일, 등록번호·등록일(있는 경우), 국가(한국/US). 출원/등록 상태를 구분 표기한다 MUST
P-10 파생 통계 카운터: 카테고리별 건수를 배열에서 도출해 표기 SHOULD
P-11 DOI·원문 링크는 레거시에 존재하지 않으므로 이번 범위에서 제외한다. 스키마에 선택 필드로 예약만 한다 MUST
P-12 저자명·논문 제목·게재처 표기는 레거시 원문을 그대로 보존한다. 임의 축약·재배열·번역 금지 (PR-01) MUST
P-13 국문·영문 제목이 혼재하는 국내 논문 목록에서 언어를 통일하지 않는다 (PR-01) MUST

6.4 Lectures (/lectures) — PR-01 적용

레거시 실측: 2016 Fall ~ 2026 Spring, 약 20개 학기, 과목명 + 학수번호 형식.

ID 요구사항 수준
L-01 현행 placeholder 3건(사물인터넷 개론, 메타버스 상호운용성과 표준 등)을 실제 강의 이력으로 교체한다. 전 학기 전 과목 보존 MUST
L-02 학기별(Spring/Fall + 연도) 그룹핑을 레거시 구조 그대로 보존한다 MUST
L-03 최근 3개 학기를 기본 노출하고 이전 이력은 전체 이력 보기로 확장한다. 확장 시 전 학기가 노출되어야 한다 (PR-01) SHOULD
L-04 과목 레코드: 학수번호(COMP 0414 등), 과목명(EN), 학부/대학원 구분 MUST
L-05 과목명 한글 번역은 레거시에 없으므로 신규 창작하지 않는다. 영문 원문을 정본으로 노출한다 (→ §12 D-02) MUST
L-06 Fall 2023 — No Class (Sabbatical)과 같은 비강의 학기도 이력에 보존한다 (PR-01) MUST
L-07 동일 과목이 여러 분반(ITEC 401003, ITEC 401004)으로 개설된 경우 분반을 합치지 않고 보존한다 (PR-01) MUST

6.5 Standardization (/standardization) — PR-01 적용

레거시 실측: 기구 6곳 / 표준 문서 약 55건 / 활동 기간 2000~현재.

기구 활동 기간 주요 산출물 구분
IEC TC100 (Multimedia Systems and Equipment) 2018 ~ 현재 IEC 63614(Metaverse) 4건, IEC 63478(QoE, WG11 Convenor) 3건, IEC 63479(Infotainment) 3건, IEC 63246(CCIS) 4건 국제
ISO/IEC JTC1/SC41 (IoT and Digital Twin) 2020 ~ 현재 ISO/IEC TR 30189 2건 국제
ITU-T SG20 (IoT Services based on VLC) 2018 ~ 2020 Y.4465, Y.4474 국제
ITU-T SG13 (Mobility Management) 2002 ~ 2012 Q.Sup52, Q.1706~1709, Y.2052, Y.2809 등 7건 국제
ISO/IEC JTC1/SC6 WG7 (Network and Transport) 2000 ~ 2014 ECTP(14476), RMCP(16512), MMC(24793), FN-PSR(29181) 계열 다수 국제
TTA/PG425 (가시광 통신 기반 사물인터넷) 2018 ~ 2020 TTAK.KO-10.1158 part1~3 국내
ID 요구사항 수준
S-01 현행 4개 기구(oneM2M, W3C WoT, IETF QUIC, OMA LwM2M)는 실제 기여 이력이 아닌 placeholder이므로 전량 교체한다 MUST
S-02 국제 표준화 / 국내 표준화 2개 섹션으로 구분한다 (레거시 구조 보존) MUST
S-03 기구별 카드에 활동 기간과 역할(예: WG11 Convenor, WG30(TA17))을 명시한다 MUST
S-04 표준 문서는 기구 → 워킹그룹/프로젝트 → 문서의 3단 계층으로 표현하고, 문서 55건 전량을 보존한다 MUST
S-05 문서 상태(IS / TS / TR / CDV / WDTR / In Progress)를 배지로 구분 노출한다 MUST
S-06 In Progress 문서(IEC WDTR 63614-4, IEC CDV 63478-3, ISO/IEC CDTR 30189-2)는 진행 중임이 시각적으로 명확해야 한다 MUST
S-07 기구 카드 강조색은 §8.3 홀수/짝수 교차 규칙을 따른다 MUST
S-08 카운터는 기구 수·문서 수를 배열에서 도출한다 MUST
S-09 5대 연구 기둥 중 기둥 4(A2A/ACP 개방형 표준) 와의 연결 서술을 도입부에 배치해, 과거 표준화 역량이 신규 연구 방향으로 이어짐을 드러낸다 SHOULD

7. 데이터 모델 및 마이그레이션 명세

7.1 데이터 배치 원칙

ID 요구사항 수준
DM-01 콘텐츠 데이터는 페이지 컴포넌트에서 분리해 content/ 디렉터리의 타입 지정 모듈로 이관한다 (content/members.ts, content/publications.ts, content/lectures.ts, content/standards.ts) MUST
DM-02 각 모듈은 명시적 TypeScript 인터페이스를 export 한다. any 사용 금지 MUST
DM-03 (v1.1 문구 정정) 데이터는 빌드 타임 정적 상수로 유지한다. 런타임 fetch·외부 API·DB를 도입하지 않는다. 전 라우트가 빌드 타임 정적 프리렌더(○ Static 또는 ● SSG)를 유지해야 하며, ƒ Dynamic 라우트가 발생해서는 안 된다 (§8.5 R-8.16) MUST
DM-04 각 페이지 상단의 // CUSTOMIZATION HOOK 주석 규약(DESIGN.md "콘텐츠 우선" 원칙)은 content/ 모듈로 이전하되 규약 자체는 유지한다 MUST

7.2 스키마 정의 (계약)

// content/members.ts
type Degree = "Professor" | "PhD" | "PhDCandidate" | "PhDStudent" | "MSCandidate" | "MSStudent";

interface Member {
  ko: string;                 // "최동규"  (외국인 연구원은 원문 표기)
  en: string;                 // "Dong-Kyu Choi"
  degree: Degree;
  affiliation?: string;       // 컴퓨터학부 외 소속일 때만 (M-04)
}

interface Alumnus {
  ko: string;
  en: string;
  degree: "PhD" | "MS";
  graduatedAt: string;        // "2026-08"  (ISO 8601 부분 표기)
  major?: string;             // "Computer Science and Engineering"
  currentPosition?: string;   // "Daegu Catholic University (대구가톨릭대학교) as Professor"
}

// content/publications.ts
//   D-01 확정(v1.5) 후 3개 카테고리. 라벨 문자열은 레지스트리에서만 정의한다 (P-02).
type PubCategory =
  | "intl-journal-conf"      // International Journal & Conference
  | "domestic-journal-conf"  // Domestic Journal & Conference
  | "patent";                // Patent

interface Publication {
  category: PubCategory;      // P-02: 판별 필드
  title: string;              // P-12: 원문 보존
  authors?: string;           // P-12: 원문 보존
  venue?: string;             // 저널/학술대회명
  volume?: string;            // "Vol. 23, pp. 4490~4505"
  publishedAt: string;        // "2026-04"  (P-05 정렬 키)
  kci?: boolean;              // P-08
  doi?: string;               // P-11: 예약 필드, 현재 미사용
}

interface Patent {
  category: "patent";
  title: string;
  inventors: string;          // "고석주, 정중화, 남혜빈, 최동규"
  applicationNo: string;      // "2023-0180751"
  applicationAt: string;      // "2023-12-13"
  registrationNo?: string;    // "2963109"
  registrationAt?: string;    // "2026-05-06"
  country: string;            // "한국" | "US"
  publishedAt: string;        // 정렬 키 (= applicationAt 의 연월)
}

// content/lectures.ts
interface Semester {
  term: "Spring" | "Fall";
  year: number;
  courses: { code: string; en: string; note?: string }[];  // L-05, L-06, L-07
}

// content/standards.ts
type DocStatus = "IS" | "TS" | "TR" | "CDV" | "WDTR" | "InProgress";

interface StandardsBody {
  org: string;                // "IEC TC100"
  full: string;               // "Multimedia Systems and Equipment"
  scope: "international" | "domestic";   // S-02
  period: string;             // "2018 ~ Present"
  role?: string;              // "WG11 Convenor"
  projects: {
    wg: string;               // "WG12"
    name: string;             // "Multimedia Systems and Equipment for Metaverse (IEC 63614)"
    documents: { title: string; ref: string; status: DocStatus; publishedAt?: string }[];
  }[];
}

// content/projects.ts  (v1.7 신설 · §6.1.2)
//   ⚠️ StandardsBody.projects(WG 단위 표준화 프로젝트)와 의미가 다르다. 이름 재사용 금지 (PJ-01).
interface ProjectDeliverable {
  title: string;              // standards.ts 문서 제목 원문
  ref: string;                // "IEC 63246" / "ISO/IEC TR 30189"
  status: DocStatus;          // 기존 유니온 재사용
}

interface ResearchProject {
  slug: string;               // "iot-standards" | "ccis" | "vlc-iot"
  title: string;              // 레거시 card-title 원문
  abstract: string;           // 레거시 card-text 원문 — 바이트 동일 보존 (PJ-03)
  keywords: string[];         // 전 원소가 abstract 부분문자열이어야 함 (PJ-06)
  standardsTrack?: string;    // "IEC/TC 100/TA 17" — 레거시 확장 섹션 원문
  standardsOrg?: string;      // standards.ts `org` 조인 키
  period?: string;            // standards.ts `period` 에서 도출 (PJ-04)
  deliverables: ProjectDeliverable[];  // standards.ts documents 에서 도출 (PJ-05)
  funder?: string;            // 현재 전건 미확보(D-07). 값 없으면 UI 미렌더 (PJ-07)
}

7.3 마이그레이션 절차

ID 요구사항 수준
MG-01 추출은 재현 가능한 스크립트로 수행하고, 스크립트를 scripts/ 하위에 커밋한다. 수작업 복사·붙여넣기 금지 MUST
MG-02 추출 후 건수 대조 검증을 수행한다. 기대값: 국제 68 / 국내 80 / 특허 75 / 표준 문서 55 / 재학 16 / 졸업생 60 / 학기 약 20 MUST
MG-03 한글·특수문자(~, ·, , o, 전각 기호) 인코딩 손실이 없어야 한다. 레거시 파일에 BOM()이 존재하므로 제거한다 MUST
MG-04 날짜는 전부 ISO 8601로 정규화한다 (2026년 6월2026-06, April 20262026-04, 2023.12.132023-12-13) MUST
MG-05 레거시에 없는 정보를 추정·창작하지 않는다. 누락 필드는 optional로 두고 UI에서 조건부 렌더한다 (PR-01) MUST
MG-06 이미지 자산은 실제 사용분만 public/으로 이관한다. 원본 총량 11.6MB(image/ 3.4MB + assets/ 8.2MB)를 무조건 복사하지 않는다 MUST
MG-07 이관 이미지는 WebP 변환 및 next/image 적용 SHOULD
MG-08 마이그레이션 완료 후 렌더 HTML 전수 스캔으로 구 정체성 잔재 0건을 확인한다 (검사어: 사물인터넷 표준, IoT Standards, MCM, 메타버스 상호운용성, 홍길동, placeholder). 단, 논문·특허 제목에 포함된 도메인 용어는 실데이터이므로 예외로 취급한다 MUST

⚠️ MG-08의 중요한 예외: 레거시 실적에는 사물인터넷, 메타버스, oneM2M 등이 논문 제목·표준 문서명으로 실재한다(예: IEC 63614 Multimedia Systems and Equipment for Metaverse). 이는 구 정체성 잔재가 아니라 보존해야 할 실데이터다(PR-01). 잔재 검사는 연구실 정체성 서술 영역(Header/Footer/metadata/Home 소개문)에 한정해 적용한다.


8. 디자인 시스템 준수 규격

정본은 refer_landing_page/docs/DESIGN.md("Issue 01")이며, 본 절은 위반 시 리뷰에서 반려되는 항목만 발췌한다.

8.1 색상 토큰 (변경 금지)

토큰 용도
ink / ink-soft / ink-mute #0A0A0A / #262420 / #6B655B 본문·괘선
ivory / paper / line #F5F1E8 / #ECE6D6 / #D8D1C0 종이 배경 / 인셋 / 헤어라인
vermillion / vermillion-dark #D9342B / #A8231C 강조 (Hot) — 최초 커밋 이래 불변
cobalt / cobalt-dark #4A7CE8 / #32549E (v1.11 갱신) 강조 (Cool)

v1.11 갱신 근거: 커밋 eaddc4fcobalt#1B3A8A#4A7CE8, cobalt-dark#122863#3462CC로 변경했다. #4A7CE8은 사용자 지정 값이므로 유지하되, cobalt-darkpaper 배경에서 4.48:1로 미달하므로 D-10 결정에 따라 #32549E(paper 5.82:1)로 재조정한다. vermillion(#D9342B)은 변경된 적이 없다 — eaddc4f의 커밋 메시지 …and secondary to #D9342B는 현상 유지의 서술이다(→ §12.1 D-10 상세). v1.12: 두 강조색의 -dark 변형(#A8231C / #32549E)은 소형 텍스트 전경뿐 아니라 text-[0.65rem] 상태 칩의 배경으로도 사용된다 — ivory 전경만으로 6.386.43(라이트) / 6.576.72(다크)를 확보한다(→ R-8.26 · R-8.29 · §12.1 D-10 보론).

R-8.1 신규 색 토큰 추가 금지. 색상 값 변경 시 tailwind.config.tsapp/globals.css:root CSS 변수를 반드시 함께 수정하며, R-8.26~R-8.28의 대비·반전 제약을 재산정해 첨부한다. R-8.2 brand / accent 별칭은 레거시 호환 전용이며 신규 코드에서 사용 금지.

8.2 타이포그래피 · 유틸리티 클래스

R-8.3 지정 서체만 사용한다 — 영문 디스플레이 Fraunces(font-display), 국문 헤드라인 Noto Serif KR(headline-ko), 본문 산세리프 Pretendard/Inter(font-sans). R-8.4 기존 유틸리티 클래스를 우선 사용한다: .container-content, .display, .display-sm, .headline-ko, .kicker, .pull-quote, .reveal. 동등 기능의 임의 클래스 신설 금지.

8.3 강조색 시맨틱 계약

R-8.5 vermillion = Agent Engineering / Orchestration(홀수 항목), cobalt = MCP / A2A Protocol(짝수 항목). 목록 렌더 시 인덱스 기반 교차 배정을 따른다.

8.4 컴포넌트 재사용

R-8.6 기존 7종을 우선 재사용한다: Header, Footer, PageHeader, SectionLabel, Reveal, Counter, Marquee. 신규 컴포넌트는 기존 조합으로 구현 불가함을 리뷰에서 입증한 경우에만 추가한다. R-8.7 PageHeaderindex prop은 IA 순서를 따른다 — Home 1 / Members 2 / Publications 3 / Lectures 4 / Standardization 5. R-8.8 [중요 제약] Counter정수 전용이다. 내부에서 Math.round()로 표시값을 산출하므로 소수를 넘기면 반올림된 값이 표시되고, prefers-reduced-motion 경로에서는 반올림이 적용되지 않아 모션 설정에 따라 값이 달라진다. 소수 지표가 필요하면 Counter의 소수 대응 확장을 선행 과제로 처리한다. R-8.9 그리드에서 gap-px bg-line 헤어라인 기법은 테두리 없는 카드 전용이다. border border-ink를 가진 카드에는 bg-line을 함께 걸지 않는다. R-8.10 항목 수가 열 수로 나누어떨어지지 않는 그리드는 col-span으로 마지막 행을 채운다. 빈 트랙이 배경색 블록으로 노출되어서는 안 된다 (5개 항목 → lg:grid-cols-6 기준 2/2/2 · 3/3 조판이 확립된 패턴).

8.5 Next.js 렌더링 제약 (v1.1 신설)

출처: 개발 팀장(Agy)의 기술 이의제기(Job 175860e4)를 계기로, 본 프로젝트의 실제 환경(Next.js 14.2.35, refer_landing_page/)에서 4가지 구현 방식을 직접 빌드해 실측한 결과다. 추정이 아닌 재현된 관측치이며, 프로브 라우트는 검증 후 전량 삭제해 저장소에 남기지 않았다.

실측 결과표

# 구현 방식 빌드 결과 정적 HTML에 담기는 내용
1 Client Component에서 useSearchParams()<Suspense> 없음 빌드 실패
useSearchParams() should be wrapped in a suspense boundary at page "/…"Export encountered errors
2 useSearchParams()<Suspense> 있음 ○ (Static) 경계 안쪽은 fallback만 저장됨.
경계 바깥의 서버 렌더 콘텐츠는 정상 프리렌더됨
3 Client useState + window.history.pushState ○ (Static) 클라이언트 초기 상태만 저장됨 (cat=all). 공유 링크 진입 시 마운트 후 보정 → 비필터 상태가 먼저 표시됨
4 Server Component의 searchParams prop 사용 ⚠️ ƒ (Dynamic) — 정적 생성 탈락 매 요청 서버 렌더
5 [category] 세그먼트 + generateStaticParams() ● (SSG) — 카테고리별 HTML 4개 생성 카테고리 값이 HTML에 그대로 포함됨 (cat=patent)

도출 규칙

R-8.11 [금지] Server Component 페이지에서 searchParams prop을 사용하지 않는다. 실측 #4에서 확인된 대로 해당 라우트가 ƒ (Dynamic)으로 전환되어 DM-03·NF-03을 직접 위반한다. 본 프로젝트에서 정적 생성을 깨뜨리는 유일하게 확인된 경로다.

R-8.12 [금지] useSearchParams()<Suspense> 경계 없이 호출하지 않는다. 실측 #1에서 프로덕션 빌드가 중단됨을 확인했다.

R-8.13 [제한적 허용] useSearchParams() + <Suspense> 조합은 정적 생성을 깨뜨리지 않는다(실측 #2에서 ○ Static 유지 확인). 다만 경계 안쪽 콘텐츠가 정적 HTML에서 누락되므로, 필터 컨트롤 등 소규모 UI에 한해 사용하고 레코드 목록에는 사용하지 않는다(R-8.15).

R-8.14 [금지] 라우팅 목적의 window.history.pushState 직접 호출을 하지 않는다. Next 라우터를 우회하므로 뒤로/앞으로 가기 시 URL만 바뀌고 UI가 갱신되지 않으며, 이를 보정하려면 popstate 리스너를 직접 등록·해제해야 한다. 카테고리 이동은 next/link로 처리한다(P-06a).

R-8.15 [필수] 대량 레코드(Publications 223건, Alumni 60명, 표준 문서 44건)는 서버 컴포넌트에서 정적 HTML로 렌더한다. 클라이언트 상태나 <Suspense> 경계 안쪽에 넣어 정적 문서에서 누락시키지 않는다. 실측 #2에서 경계 바깥 서버 렌더 콘텐츠는 프리렌더된다는 점이 확인되었으므로, 목록은 바깥에 두고 인터랙션만 안쪽에 두는 분리가 가능하다.

R-8.16 [표기] generateStaticParams()를 사용하는 라우트는 빌드 리포트에서 ○ (Static)이 아니라 ● (SSG) 로 표기된다. 두 표기 모두 "빌드 타임 정적 프리렌더"이며 요구사항을 충족한다. 수용 기준의 판정은 §10 AC-17의 개정된 문구를 따른다.

8.6 레이아웃 컨테이너 아키텍처 · 브레이크포인트 토큰 (v1.6 신설)

Job 343b5808 검증에서 본문 좌우 여백·최대 폭 미적용(B1)이, 개발 팀장 이의제기(Job 2560771b)에서 그 수정 방식의 확장성 제약이 각각 확인되었다. 아래 규칙은 D-06 확정 사항이다.

R-8.17 [계층 분리 · 필수] 레이아웃은 3계층으로 분리한다.

  1. <main> (app/layout.tsx) — 뷰포트 전체 폭을 유지한다. max-w-* / px-* / container-content부여하지 않는다.
  2. 라우트 최상위 래퍼 — 각 페이지 파일의 루트 <div>container-content를 부여해 본문 여백(24/40/48/64 px)과 최대 폭(78 rem = 1248 px) 중앙 정렬을 확보한다.
  3. Full-bleed 밴드 — 전체 폭 배경 밴드·구획선·마퀴 티커는 2계층 래퍼 바깥(즉 <main> 직속)에 배치한다.

R-8.18 [금지] Full-bleed 연출을 위해 container-content 자식에서 w-screen 또는 -mx-[50vw] 계열 탈출 기법을 사용하지 않는다. 현재 html·bodyoverflow-x 가드가 전무하므로(실측 확인), 폭 제한 컨테이너 내부의 w-screen은 좌측 기준점이 부모 콘텐츠 박스여서 우측으로 넘쳐 가로 스크롤을 유발하고 R-9.15/AC-19를 위반한다. Full-bleed가 필요하면 R-8.17의 3계층으로 올린다.

R-8.19 [필수] 라우트 래퍼 방식은 신규 라우트 추가 시 누락될 수 있으므로, 빌드 산출 HTML의 모든 라우트에서 <main> 하위에 container-content가 존재함을 자동 게이트로 검증한다(→ AC-25). 이 게이트 없이는 본 아키텍처를 채택하지 않는다.

R-8.20 [토큰] 데스크톱 내비 전환 임계값은 tailwind.config.tstheme.extend.screensdesktop: "1240px" 단일 토큰으로 등록하고 desktop: 변형으로만 사용한다. 임의값 클래스(min-[1240px]:)를 소스에 직접 쓰지 않는다.

  • 실측 확인: Tailwind v3는 extend로 추가한 스크린도 min-width 값 기준으로 정렬해 출력하므로(1024 → 1240 → 1280 → 1536 순서 확인), 2xl 등 상위 브레이크포인트를 덮어쓰는 캐스케이드 사고는 발생하지 않는다. screens 전체를 재정의할 필요가 없다.
  • 주의: lg(1024px)와 desktop(1240px)이 공존하므로, 헤더 내 데스크톱/모바일 전환은 desktop:으로만 통일한다. 동일 속성에 lg:desktop:을 혼용하면 1024–1239 px 구간에 의도치 않은 중간 상태가 생긴다(B2가 정확히 이 사고였다).

8.7 색 토큰 알파 계약 (Color Token Alpha Contract) (v1.9 신설)

디자인 토큰은 app/globals.css의 CSS 커스텀 프로퍼티와 tailwind.config.tstheme.extend.colors한 쌍으로 동작한다. 이 쌍의 계약이 깨지면 lint·tsc·빌드가 모두 통과하는 채로 화면만 무너진다 — 실제로 그 사고가 발생했으므로(§12.1 D-09 상세) 계약을 명문화한다.

R-8.21 [필수 · 공백 구분] --*-rgb 커스텀 프로퍼티의 값은 반드시 공백 구분 3-숫자로 정의한다(--ink-rgb: 10 10 10;). 쉼표 구분(10, 10, 10)을 금지한다.

  • 근거: Tailwind는 <alpha-value>를 포함한 색을 rgb(var(--ink-rgb) / var(--tw-text-opacity, 1)) 형태로 전개한다. 값이 쉼표 구분이면 치환 결과가 rgb(10, 10, 10 / 1)이 되는데, 이는 CSS Color 4의 현대 문법(공백+슬래시)도 레거시 문법(전량 쉼표)도 아니어서 무효다. 무효 선언은 invalid at computed-value time 으로 처리되어 해당 속성이 통째로 적용되지 않는다. 빌드는 성공하고 CSS 파일에도 규칙이 남으므로 어떤 정적 게이트도 이를 잡지 못한다.
  • --ink: rgb(var(--ink-rgb)); 형태의 파생 변수는 공백 구분에서도 그대로 유효하므로 함께 유지한다.

R-8.22 [필수 · <alpha-value> 보존] theme.extend.colors의 모든 토큰은 rgb(var(--*-rgb) / <alpha-value>) 형태로 선언한다. var(--ink)처럼 알파 자리표시자가 없는 형태로 축약하지 않는다.

  • 근거(실측): 알파 자리표시자가 없으면 Tailwind는 슬래시 수식자 유틸리티를 오류 없이 조용히 생략한다. 독립 프로브 결과 — colors.ivory = "var(--ivory)"일 때 bg-ivory/85·text-ivory/50·border-ivory/15출력 CSS에 단 한 줄도 생성되지 않았고, colors.old = "rgb(var(--ivory-rgb) / <alpha-value>)"일 때는 rgb(var(--ivory-rgb) / 0.85)로 정상 생성되었다.
  • 유틸리티가 생성되지 않으면 배경은 투명, 테두리는 Preflight 기본색 #e5e7eb(팔레트 외 회색), 텍스트는 부모 색 상속으로 대체되어 팔레트를 벗어난 화면이 된다.

R-8.23 [금지 · 토큰 우회] 디자인 토큰으로 표현 가능한 색을 컴포넌트의 인라인 style 속성이나 리터럴 색값(#ffffff 등)으로 우회 지정하지 않는다. 인라인 style은 다크 모드 변형(dark:)보다 항상 우선하므로 테마 반전이 무력화되고 대비 요구(R-9.6)가 조용히 깨진다.

  • 활성 내비 배지처럼 대비가 임계에 가까운 요소에는 opacity-* 유틸리티를 사용하지 않는다. 요소 불투명도는 전경·배경을 함께 합성해 대비를 낮추며, 실측상 opacity-90만으로 4.69:1 → 4.05:1(라이트)로 떨어져 AA 미달이 된다.

R-8.24 [필수 · 헤더 가로 예산] 데스크톱 헤더(브랜드 + 내비 + 토글)의 소요 폭은 1240 px 뷰포트의 가용 폭 1112 px과 최대 폭 상한(78 rem) 적용 시의 가용 폭 1120 px을 모두 초과하지 않아야 한다. 헤더에 좌우 패딩·간격·마진을 추가하는 변경은 예산 재계산을 동반해야 하며, 예산 초과 시 내비 라벨이 2줄로 접히는 회귀(§8.6 B2)가 재발한다.

  • 실측 기준선(commit 43c75da): 소요 1057.6 px / 가용 1112 px / 여유 +54.4 px, 내비 전량 font-bold 보정 시 +22.7 px.
  • container-content의 최대 폭이 78 rem(1248 px)로 상한이므로, 1280 px 이상에서도 가용 폭은 1120 px에서 고정된다. 즉 뷰포트를 넓혀도 헤더 넘침은 해소되지 않는다 — 넓은 화면 전용 마진(xl:mr-16 등)은 예산을 악화시키기만 한다.

R-8.25 [금지 · 콘텐츠 중복] (v1.10 신설) 서로 다른 두 라우트가 실질적으로 동일한 <main> 콘텐츠를 정적 HTML로 생성해서는 안 된다.

  • 근거: 검색 엔진은 중복을 벌점 처리하지는 않으나 어느 URL을 정본으로 삼을지 스스로 선택하므로, 내부 링크·사이트맵이 가리키는 URL과 색인되는 URL이 어긋날 수 있다. 또한 산출물 크기가 이유 없이 늘고, 한쪽만 수정되는 표류(drift) 결함이 구조적으로 가능해진다.
  • 인덱스 라우트는 하위 라우트의 본문을 재사용하는 대신 고유한 집계·요약 콘텐츠를 갖는다(→ IA-03).
  • 불가피하게 동일 콘텐츠를 두 URL에 노출해야 한다면 metadata.alternates.canonical 지정을 필수로 하며, 그 경우에도 R-8.25의 예외임을 §12.1에 결정 항목으로 기록한다.
  • 자동 검증: AC-41.

R-8.26 [필수 · 강조색 대비 바닥값] (v1.11 신설) 강조 토큰(vermillion·cobalt)의 DEFAULT 변형은 대형 텍스트(≥24 px, 굵게 ≥18.66 px)·도형·테두리·아이콘 전용이며 3:1 이상을 만족한다. 소형 텍스트에는 -dark 변형만 사용하고, -darkivory·paper 양 배경에서 4.5:1 이상이어야 한다.

  • paper(#ECE6D6)가 ivory(#F5F1E8)보다 어두워 항상 더 엄격한 제약이므로 바닥값 산정은 paper 기준으로 한다. 실측 차이는 약 0.3~0.5 이며, ivory만 보고 통과 판정하면 bg-paper 카드 내부에서 미달한다.
  • 실측 근거: --cobalt: #4A7CE8ivory 3.49 / paper 3.16으로 대형 텍스트 기준(3:1)은 충족하나 소형 텍스트 기준은 미달한다. 반면 --cobalt-dark: #32549E는 6.43 / 5.82로 양 기준을 충족하며, --vermillion-dark: #A8231C(6.38 / 5.77)와 동일 등급이 되어 두 강조색의 -dark 슬롯이 대칭을 이룬다.
  • [v1.12 추가 · 배지·칩 라우팅] 강조색을 배경으로 쓰는 비인터랙티브 상태 칩(text-[0.65rem] 등급)은 bg-{accent}-dark + text-ivory 를 사용한다. DEFAULT 배경 위에서는 팔레트 내 전경 중 통과 후보가 0~1개뿐이라 설계 여유가 없다 — 실측상 bg-cobalt(#4A7CE8) 위 4개 후보(ivory 3.49 · white 3.93 · ink-soft 3.94 · ink 5.03) 중 통과는 ink 1개뿐이고, bg-vermillion(#D9342B) 위 ivory4.16으로 미달한다. -dark 배경은 ivory 전경만으로 6.386.43(라이트) / 6.576.72(다크) 를 확보한다.
  • [v1.12 추가 · 짝 칩 등급 일치] 같은 컴포넌트에서 짝을 이루는 강조색 칩은 동일 변형 등급을 사용한다. 한쪽만 -dark로 내리면 두 칩의 상대휘도 대비가 1.19 → 1.54로 악화된다(실측: vermillion L=0.1738 ↔ cobalt-dark L=0.0949). 양쪽을 -dark로 통일하면 1.01로 균형이 잡힌다(vermillion-dark L=0.0961 ↔ cobalt-dark L=0.0949) — 두 강조색의 -dark 변형이 접근성 등급뿐 아니라 휘도까지 대칭이기 때문이다.
  • 인터랙티브 내비·토글 요소는 예외로 DEFAULT 배경 + text-white dark:text-ivory(4.69 / 5.01)를 유지한다. 근거는 §12.1 D-10 상세(부류 A/B 구분) 참조.
  • 자동 검증: AC-42 · AC-43 · AC-44.

R-8.27 [필수 · 색값 변경 시 재측정 의무] (v1.11 신설) --*-rgb 값을 변경하는 모든 커밋은 해당 토큰이 참여하는 전 전경/배경 조합의 대비를 재산정하고 그 표를 커밋 메시지 또는 리뷰 리포트에 첨부한다.

  • docs/DESIGN.md의 강조색 교체 안내(커스터마이즈 훅)에 이 제약을 명문화한다. 현행 안내는 "강조색 2개와 -dark 변형만 교체하면 됩니다"라고 교체 방법만 적고 지켜야 할 대비 제약을 적지 않아, 안내를 그대로 따른 커밋 eaddc4f가 라이트 테마 대비를 9.23 → 3.49로 붕괴시켰다. 문서가 사고의 직접 원인이므로 문서 교정이 재발 방지의 일부다.
  • 색값 변경은 lint·tsc·빌드·기존 게이트 전량을 통과한 채로 화면 접근성만 무너뜨린다 — §12.1 D-09 상세의 알파 계약 사고와 동일한 무성(silent) 실패 유형이며, 이번이 두 번째 발현이다.

R-8.28 [필수 · 명암 반전 계약] (v1.11 신설) html.dark에서 반전되는 모든 토큰은 라이트 값과 다크 값의 상대휘도가 유의미하게 달라야 한다 — 두 값 사이의 대비가 2.0 이상이어야 한다.

  • 근거(실측): 변경 전 cobalt는 라이트 L=0.0509(#1B3A8A) ↔ 다크 L=0.2199(#4D77FF)로 대비 3.13이었으나, eaddc4f 이후 라이트 L=0.2170(#4A7CE8) ↔ 다크 L=0.2199로 대비 1.01이 되었다. 즉 라이트 테마가 다크 테마용 밝기를 그대로 반입했고, 이것이 R-8.26 미달의 직접 원인이다.
  • 한 토큰만 반전 계약에서 이탈하면 그 시점에는 반대 테마가 우연히 무사할 수 있으나, 반대 테마 값을 조정하는 순간 양 테마가 동시에 무너진다.
  • 자동 검증: AC-45.

R-8.29 [필수 · 반전 토큰 쌍의 dark: 불필요 원칙] (v1.12 신설) 전경과 배경이 모두 반전 토큰(--*-rgb로 정의되어 html.dark에서 값이 바뀌는 토큰)이면 dark: 변형 없이 양 테마가 성립해야 한다. 어떤 조합에 dark: 변형이 필요하다면 그것은 반전하지 않는 색(white·리터럴 hex 등)이 섞였다는 신호이므로, 팔레트 외 색을 제거할 수 있는지 먼저 검토한다.

  • 실측 대조: bg-cobalt-dark text-ivory는 라이트 6.43 / 다크 6.57dark: 없이 통과한다. 반면 bg-cobalt text-ink는 다크에서 --ink-rgb245 241 232로 반전되어 3.49로 미달하므로 dark:text-ivory를 수동으로 덧대야 한다 — 반전 계약을 손으로 우회하는 구조이며 R-8.28의 취지에 역행한다.
  • white가 불가피한 경우(bg-vermillionivory가 4.16으로 미달하는 인터랙티브 요소)는 AC-47 화이트리스트로 상한을 관리한다. 화이트리스트는 상한이지 허가가 아니다 — 신규 사용처는 먼저 -dark 배경으로 대체 가능한지 검토한다.
  • 자동 검증: AC-47.

9. 비기능 요구사항 (Non-Functional Requirements)

9.1 빌드 품질 게이트 — 병합 필수 조건

ID 요구사항 검증 명령
NF-01 ESLint 경고·오류 0건 npm run lint
NF-02 TypeScript 오류 0건 npx tsc --noEmit
NF-03 (v1.1 문구 정정) 프로덕션 빌드 성공. 전 라우트가 빌드 타임 정적 프리렌더(○ Static 또는 ● SSG)이며 ƒ Dynamic 라우트가 0건이어야 한다 npm run build
NF-04 package.jsonpackage-lock.json 정합. 의존성 추가 시 lockfile 동시 커밋 npm install --package-lock-only 후 diff 확인

9.2 SEO

R-9.1 전 라우트에 고유한 metadata.title / metadata.description을 정의한다. 타이틀 템플릿은 현행 %s | ANL · 경북대학교를 유지한다. R-9.2 Open Graph(og:title, og:description, og:image, og:type, og:locale=ko_KR) 및 Twitter Card 메타를 추가한다. R-9.3 시맨틱 HTML5 요소(<main>, <article>, <section>, <nav>, <address>, <time>)를 사용한다. 논문·특허 날짜는 <time dateTime>으로 표기한다. R-9.4 app/sitemap.tsapp/robots.ts를 추가한다. R-9.5 지도교수 및 연구실 정보에 Person / ResearchOrganization JSON-LD 구조화 데이터를 삽입한다. (SHOULD)

9.3 접근성 (Accessibility)

R-9.6 WCAG 2.1 AA 색 대비를 충족한다. 특히 ink-mute(#6B655B) on ivory(#F5F1E8) 조합은 소형 텍스트 사용 시 대비 실측 후 적용한다. R-9.7 장식용 SVG·요소는 aria-hidden, 의미 전달 SVG는 role="img" + aria-label을 갖는다. R-9.8 prefers-reduced-motion: reduce에서 Reveal·Counter·Marquee의 모션이 비활성화되어야 한다(현행 구현 유지). R-9.9 키보드 내비게이션으로 전 인터랙티브 요소(필터, 확장 토글, 링크)에 도달 가능하고 포커스 링이 보여야 한다. R-9.10 필터·확장 토글은 aria-expanded / aria-controls를 갖는다.

9.4 성능

R-9.11 초기 렌더 DOM 노드 수를 제한한다. Publications 223건, Alumni 60명, Lectures 약 20학기는 전량 즉시 렌더 금지(P-07, M-06, L-03). 단 PR-01에 따라 전 레코드가 사용자 조작으로 도달 가능해야 한다. R-9.12 라우트별 First Load JS는 현행 수준(공유 87.3 kB + 라우트별 1 kB 내외)에서 +30 kB를 초과하지 않는다. R-9.13 신규 런타임 의존성 추가 시 사전 승인을 받는다. 현행 의존성은 next / react / react-dom 3종뿐이며 이 최소 구성을 유지한다.

9.5 반응형

R-9.14 (v1.6 개정) 지원 브레이크포인트는 Tailwind 기본값 sm(640px) / md(768px) / lg(1024px)에 커스텀 토큰 desktop(1240px) 을 더한 구성이다(R-8.20). 검수 기준 뷰포트는 360 / 768 / 1024 / 1440 px 4종에 1239 px과 1240 px을 추가한 6종이다 — 데스크톱 내비 전환 경계의 양쪽을 반드시 확인해야 한다. R-9.15 어느 뷰포트에서도 가로 스크롤이 발생하지 않아야 한다. R-9.16 긴 국문 제목의 줄바꿈은 break-keep을 적용한다.

9.6 콘텐츠 무결성

R-9.17 [최우선] 사이트에 게시되는 모든 수치·실적·인물 정보는 ISL-2026/ 실데이터 또는 README.md 정본에서 출처를 추적할 수 있어야 한다. 근거 없는 홍보성 지표 게시를 금지한다. R-9.18 실명·실제 이메일이 게시되는 페이지이므로, 추정 정보를 사실처럼 표기하지 않는다. 불확실한 항목은 노출하지 않는다. R-9.19 문서(README.md, docs/DESIGN.md)와 코드의 서술이 어긋나서는 안 된다. 마이그레이션이 미완인 영역은 문서에 미완임을 명시한다(문서가 코드보다 앞서 나가지 않는다).


10. 수용 기준 (Acceptance Criteria)

병합 승인은 아래 전 항목 충족 시에만 이루어진다.

기능 (PR-02·PR-03)

  • AC-01 / 접근 시 Home이 정상 렌더되고 404가 발생하지 않는다
  • AC-02 Home에 연구실 소개 · 주요 연구 분야 · 오시는 길 3개 블록이 모두 존재한다
  • AC-03 /intro 접근 시 /로 308 리다이렉트된다
  • AC-04 상단 탭 5종(Home/Members/Publications/Lectures/Standardization)이 전부 정상 라우팅된다
  • AC-05 (v1.1 개정 · v1.5 수치 갱신) Publications 3개 카테고리가 각각 고유 URL(/publications/<slug>)을 가지며, 해당 URL로 직접 진입했을 때 정적 HTML이 이미 해당 카테고리 상태를 담고 있다(비필터 상태가 먼저 보였다가 바뀌는 현상이 없어야 한다)
  • AC-06 Lectures가 학기별 그룹으로 렌더되고 최근 3개 학기가 기본 노출된다

데이터 무손실 (PR-01)

  • AC-07 건수 대조 통과: 국제 68 / 국내 80 / 특허 75 / 표준 문서 44 / 재학 16 / 졸업 60 / 강의 45학기
  • AC-08 Publications 223건 중 어느 카테고리에도 배정되지 않은 레코드가 0건이다
  • AC-09 확장 UI 조작 시 졸업생 60명·전 학기 강의·전 논문이 모두 도달 가능하다
  • AC-10 한글·특수문자 인코딩 손실 0건, BOM 제거 확인
  • AC-11 날짜 전 항목 ISO 8601 정규화 확인
  • AC-12 연구실 정체성 서술 영역에서 금지어 0건 (사물인터넷 표준, IoT Standards, MCM, 메타버스 상호운용성, placeholder) — 논문·표준 제목의 도메인 용어는 예외(MG-08)
  • AC-13 전 카운터 수치가 데이터 배열에서 도출됨을 코드로 확인
  • AC-14 (v1.1 신설) JS를 비활성화한 상태에서 /publications/<slug> 문서에 해당 카테고리 레코드가 전부 포함되어 있다 (R-8.15 · PR-01)

품질 게이트

  • AC-15 npm run lint 통과 (경고 0)
  • AC-16 npx tsc --noEmit 통과
  • AC-17 (v1.1 개정) npm run build 성공. 빌드 리포트에 ƒ (Dynamic) 라우트가 0건이고 전 라우트가 ○ (Static) 또는 ● (SSG)이다 — 도 빌드 타임 정적 프리렌더이므로 충족으로 판정한다 (§8.5 R-8.16)
  • AC-18 First Load JS 증가분 ≤ 30 kB
  • AC-19 4종 뷰포트에서 가로 스크롤 없음
  • AC-20 신규 Tailwind 반응형 유틸리티가 빌드 CSS에 실제 생성됨을 확인 (JIT 누락 시 빌드는 성공하나 조판이 무너짐)
  • AC-21 (v1.1 신설) generateStaticParams()로 카테고리별 정적 HTML 3개가 실제 생성됨을 .next/server/app/publications/ 파일 목록으로 확인
  • AC-22 (v1.1 신설) 소스 전역에 searchParams prop 사용·useSearchParams() 호출·라우팅 목적 pushState 호출이 0건임을 grep으로 확인 (§8.5 R-8.11·8.12·8.14)

문서

  • AC-23 README.md·docs/DESIGN.md 서술이 구현 결과와 일치
  • AC-24 마이그레이션 스크립트가 scripts/에 커밋됨
  • AC-25 (v1.6 신설 · R-8.19) 빌드 산출 .next/server/app/**/*.html모든 라우트에서 <main> 하위에 container-content가 존재함을 자동 게이트로 확인. <main>에는 max-w-*/px-*부여되지 않았음을 함께 확인 (R-8.17)
  • AC-26 (v1.6 신설 · R-8.18·R-8.20) 소스 전역에 w-screen·-mx-[50vw] 계열 탈출 기법과 임의값 클래스 min-[1240px]: 사용이 0건임을 grep으로 확인

Research Project PageView (v1.7 신설 · §6.1.2)

  • AC-27 (PJ-08 · R-8.15) content/projects.ts 전건title·abstract.next/server/app/index.html 정적 HTML에 존재함을 확인
  • AC-28 (PJ-09) Home 라우트가 여전히 ○ (Static)이며 빌드 전체에 ƒ (Dynamic)0건
  • AC-29 (PJ-03 · PR-01)abstract가 레거시 원문과 바이트 동일함을 파서 재실행으로 확인
  • AC-30 (PJ-06) 모든 keywords[] 원소가 해당 abstract부분문자열임을 verify_counts.py로 확인 (창작 차단)
  • AC-31 (PJ-07 · R-9.18) funderundefined인 프로젝트에 대해 산출 HTML에 Funder 라벨·자리표시자가 렌더되지 않음을 확인
  • AC-32 (PJ-05) 모든 deliverables[].refcontent/standards.ts에 실재하는 문서 참조와 일치함을 조인 검증
  • AC-33 (H-02 개정 · AC-02 회귀 방어) 히어로 재구성 후에도 연구실 소개 서술 블록 · 주요 연구 분야 그리드 · 오시는 길 · 지표 카운터 3종 · HeroComposition 이 Home 정적 HTML에 전부 존속함을 확인
  • AC-34 (v1.8 신설 · PJ-13·PJ-15·PJ-16) 프로젝트 트랙의 넘침을 브라우저 실측 수치로 판정한다 — 데스크톱(≥1240 px)에서 track.scrollWidth === track.clientWidth(스크롤 잔재 0), 모바일·태블릿에서는 scrollWidth > clientWidth정상 동작이다. 어느 뷰포트에서도 문서 레벨 가로 스크롤은 0이어야 한다(AC-19 · R-9.15). 데스크톱 3카드 폭의 서브픽셀 거동은 브라우저 없이는 확정할 수 없으므로 이 단정으로 판정을 이관한다
  • AC-35 (v1.9 신설 · R-8.21·R-8.22) 슬래시 수식자 실효성 게이트 — 소스(app/**·components/**.tsx·.css)에서 토큰/불투명도 형태로 사용된 모든 색 유틸리티를 추출하고, 각각에 대응하는 규칙이 산출 CSS(.next/static/css/*.css)에 실제로 존재함을 자동 게이트로 확인한다. 1건이라도 누락되면 실패한다. (현행 실측: 사용 26건 / 생성 0건)
  • AC-36 (v1.9 신설 · R-8.21) app/globals.css의 모든 --*-rgb 정의가 공백 구분임을 grep 게이트로 확인한다(쉼표 포함 시 실패). 아울러 산출 CSS에 rgb(<쉼표 목록> / …) 패턴이 0건임을 확인한다
  • AC-37 (v1.9 신설 · R-8.23 · R-9.6) components/Header.tsx인라인 style 속성과 리터럴 색값이 0건이며, 활성 배지 계열 요소에 opacity-* 유틸리티가 0건임을 grep으로 확인한다
  • AC-38 (v1.9 신설 · R-9.6) 활성 내비 배지의 전 텍스트 상태(데스크톱 라벨·번호 / 모바일 ko·en·번호)라이트·다크 양 테마에서 4.5:1 이상임을 실측 색값으로 계산해 확인한다. 다크 모드 배경은 --vermillion-rgb: 235 75 66으로 반전되므로 흰색 전경은 3.74:1로 미달한다 — 다크 모드 전경은 ivory(반전 시 18 18 18, 실측 5.01:1)를 사용한다
  • AC-39 (v1.9 신설 · R-8.24 · AC-19) 헤더 가로 예산을 1240 / 1280 / 1440 px 에서 확인한다 — header.scrollWidth <= header.clientWidth이고 내비 항목이 2줄로 접히지 않아야 한다(브라우저 실측 판정)
  • AC-40 (v1.9 신설 · IA-03 · AC-25) 사이트맵에 등재된 모든 URL의 산출 HTML이 redirect() 전용이 아니라 <main> + container-content 를 포함한 실체 문서임을 확인한다
  • AC-41 (v1.10 신설 · R-8.25) 산출 정적 HTML 전 라우트의 <main> 내부 콘텐츠를 정규화 해시동일 해시가 2건 이상 존재하지 않음을 자동 게이트로 확인한다. canonical이 명시된 예외 쌍만 화이트리스트로 허용한다
  • AC-42 (v1.10 신설 · v1.11 개정 · R-9.6 · AC-38 확장) vermillion 배경 위 텍스트 전량이 라이트·다크 양 테마에서 4.5:1 이상임을 확인한다. "전량"은 Header·CategoryNav에 한정되지 않으며, group-open:·hover: 등 상태 변형으로 적용되는 배경도 포함한다. 검증 대상은 두 부류로 나누어 각각의 기대 패턴과 기대 대비를 판정한다*(v1.12 개정)*.
    • 부류 A — text-[0.65rem] 비인터랙티브 상태 칩: app/standardization/page.tsx:40·:88bg-vermillion-dark text-ivory(라이트 6.38 / 다크 6.72, dark: 변형 없음). R-8.26 배지·칩 라우팅 조항 적용
    • 부류 B — 인터랙티브 내비·토글: components/Header.tsx:69,129(교정 완료), CategoryNav.tsx:22(교정 완료), app/lectures/page.tsx:89·app/members/page.tsx:177(미교정) → text-white dark:text-ivory(라이트 4.69 / 다크 5.01). Header·CategoryNav 2곳은 02247a0에서 교정되어 재작업 대상이 아니다
    • v1.10 기재 정정: text-white on #D9342B의 실측은 4.69:1이다(직전 수렴 리포트의 4.58:1은 오기 — 판정은 동일하게 통과)
    • 현행 미교정 4곳의 실측은 모두 4.16:1이며, lectures:89·members:177group-open: 상태 변형으로 배경이 적용되어 육안 리뷰에서 누락되기 쉽다
  • AC-43 (v1.11 신설 · R-8.26·R-8.27·R-9.6) 대비 자동 게이트(Gate 10)app/globals.css:root·html.dark --*-rgb 정의를 파싱해 양 테마 전 조합의 대비를 계산하고 정책 표의 바닥값 미만이면 실패한다. 최소 대상: {ink, ink-soft, ink-mute, vermillion, vermillion-dark, cobalt, cobalt-dark} × {ivory, paper}{ink, ivory, white} × {vermillion, vermillion-dark, cobalt, cobalt-dark}. -dark 변형이 배경으로 쓰이는 경우({ivory, white} × {cobalt-dark, vermillion-dark}, 양 테마)를 반드시 포함한다 — v1.11 목록은 -dark를 전경으로만 다루어 상태 칩 배경을 검사하지 못했다*(v1.12 개정)*. 정책 표는 스크립트 상단 상수 블록에 두어 규격 변경 시 1곳만 수정되게 한다. (현행 실측: cobaltivory 3.49 / paper 3.16, cobalt-darkpaper 4.48로 실패해야 한다)
  • AC-44 (v1.11 신설 · R-8.26) 소형 텍스트 라우팅 게이트app/**·components/**에서 text-cobalt·text-vermillion(DEFAULT 변형)이 소형 텍스트 크기 클래스와 동일 요소에 공존하지 않음을 확인한다. 부모로부터 크기를 상속받아 정적 판정이 불가능한 케이스는 화이트리스트에 사유와 함께 등재한다. (현행 실측: text-cobalt 소형 텍스트 사용처 12건 + bg-cobalt 소형 배지 2건 미달)
  • AC-45 (v1.11 신설 · R-8.28) 반전 계약 게이트:roothtml.dark의 동일 토큰 쌍에 대해 라이트↔다크 상대휘도 대비가 2.0 이상임을 확인한다. (현행 실측: cobalt1.01로 실패해야 한다)
  • AC-46 (v1.11 신설 · AC-43·AC-44·AC-45 유효성) 폴트 인젝션으로 Gate 10의 실효성을 증명한다 — ① --cobalt-dark-rgb52 98 204로 되돌리면 AC-43 실패, ② 소형 텍스트를 text-cobalt(DEFAULT)로 되돌리면 AC-44 실패, ③ html.dark--cobalt-rgb를 라이트 값과 동일하게 두면 AC-45 실패, ④ standardization/page.tsx:40bg-vermillion text-ivory로 되돌리면 AC-42 실패, ⑤ 상태 칩을 bg-cobalt text-ivory(v1.11 §6.5 폐기안)로 되돌리면 AC-43 실패(3.49), ⑥ 임의 위치에 text-white를 1건 추가하면 AC-47 실패(9 > 8) (⑤·⑥은 v1.12 신설). 6건 모두 실패를 재현하지 못하면 Gate 10을 채택하지 않는다 — 통과만으로는 게이트가 결함을 검출한다는 증명이 되지 않는다
    • ⑤는 기각·교체된 설계를 게이트가 실제로 잡는지 확인한다. v1.10에서 기각한 D-09 C안을 주입해 AC-41을 검증한 것과 같은 방식이며, 교체된 설계는 반드시 게이트의 검출 대상이 되어야 한다
  • AC-47 (v1.12 신설 · R-8.29) 팔레트 외 색 상한 게이트app/**·components/**에서 text-white·bg-white팔레트 외 색 유틸리티의 출현 횟수가 화이트리스트 등재 건수를 초과하지 않음을 확인한다.
    • 화이트리스트(부류 B 한정, 총 8건): components/Header.tsx:69,75,129,136,145(5) · CategoryNav.tsx:22(1) · lectures/page.tsx:89(1) · members/page.tsx:177(1)
    • 각 항목에 사유(해당 위치에서 ivory 전경이 4.16으로 미달)를 함께 기재한다. 화이트리스트는 상한이지 허가가 아니며, 신규 사용처는 -dark 배경으로 대체 가능한지 먼저 검토한 뒤에만 등재한다
    • 근거: docs/DESIGN.md는 "토큰만 사용 — 임의 회색·팔레트 밖 hex 금지"를 규정한다. white는 Issue 01 팔레트(ink/ivory/paper/line/vermillion/cobalt) 밖의 색으로, 02247a0에서 불가피성 때문에 도입되었다. 상한을 두지 않으면 그 불가피성이 관행으로 굳는다

11. 구현 계획 (Implementation Plan)

11.1 단계별 작업 분해

Phase 작업 산출물 담당 선행 조건
P0 D-01(Publications 카테고리 1·2 중첩) 확정 결정 기록 GM ← 지도교수 완료 (v1.5 · 51aae14)
P1 레거시 데이터 추출 스크립트 작성 및 content/*.ts 생성 4개 데이터 모듈 + 추출 스크립트 Agy P0
P1-R 건수·인코딩·날짜 정규화 교차 검증 (AC-07~11) 검증 리포트 Claude P1
P2 Home 신설(소개·연구 분야·오시는 길) + /intro 리다이렉트 + Header 내비 갱신 app/page.tsx, next.config.js Agy P1-R
P3 Members / Lectures 실데이터 반영 2개 라우트 Agy P1-R
P4 Publications — /publications + [category] 세그먼트 4종 (§8.5 렌더링 제약 준수, 대량 데이터 처리 포함) 1개 라우트 + 4개 세그먼트 Agy P1-R
P5 Standardization 3단 계층 뷰 1개 라우트 Agy P1-R
P6 자산 이관·최적화 (MG-06·07) public/ Agy P2~P5
P7 SEO·접근성·반응형 검수 (§9.2·9.3·9.5) 검수 리포트 Cline P6
P8 최종 교차 리뷰 및 Verdict 리뷰 리포트 Claude P7

병렬 가능: P3 / P4 / P5는 P1-R 완료 후 상호 독립이므로 동시 진행 가능하다. P2는 Header.tsx를 수정하므로 P3~P5와 파일 충돌 가능성이 있어 먼저 완료할 것을 권장한다.

11.2 잡 분할 권고

Publications(P4)는 데이터 규모(223건)와 필터·점진적 노출 요구로 인해 타 라우트 대비 작업량이 크다. P4를 단독 잡으로 분리하고 P3·P5를 묶는 편이 리뷰 단위로 적절하다.

11.3 리뷰 프로토콜

.agents/MULTI_AGENT_RULES.md §3에 따라 Phase 완료 시마다 리뷰 사이클을 돌린다. 리뷰어는 NOT PASS사유와 검증된 개선 방향을 반드시 함께 제시하고, 개발 팀장은 부당하다고 판단하는 지적에 대해 근거를 갖춰 반박한다.


12. 리스크 및 미결 결정 (Risks & Open Decisions)

12.1 미결 결정 등록부

ID 결정 사항 상태 기본값(잠정) 영향
D-01 Publications 카테고리 1(International Conference)과 2(International Journal & Conference)의 범위 중첩 해소 확정 (v1.5, 2026-07-30) 결정: 1번 단독 카테고리 폐기 → 3개 카테고리 확정. A안(저널/학술대회 분리)은 학술대회가 1건에 불과해 기각, B안(미수록 논문 확보)은 신규 데이터 유입 없이 실행 불가하여 기각. 레지스트리 1곳(content/categories.ts) + PubCategory 유니온 수정으로 완결되었고 223건 무손실을 유지했다(P-03). 근거: intl-conf 배정 레코드 실측 0건
D-02 강의 과목명 한글 병기 여부 🟡 미결 영문 원문만 노출 (L-05) Lectures 표기. 병기 시 지도교수 확인 필요
D-03 오시는 길의 지도 표현 방식 🟡 미결 주소 텍스트 + 캠퍼스 링크 (지도 임베드 없음) H-16. 외부 지도 스크립트는 R-9.13 최소 의존성 원칙과 충돌
D-04 졸업생 기본 노출 범위(N년) 🟢 위임 최근 3년 M-06. 구현자 재량
D-05 연구실 GitHub 조직명(github.com/iot-standards-laboratory) 개명 여부 🟡 미결 현행 URL 유지 조직명이 구 정체성. 개명 시 기존 링크 무효화 위험
D-06 본문 여백·최대 폭 컨테이너를 어느 계층에 부여할 것인가 확정 (v1.6, 2026-07-30) 결정: <main> 일괄 부여안 기각 → 라우트 래퍼 방식 + 자동 게이트 채택. Planner 초안(<main>container-content)은 1행 수정·누락 불가라는 장점이 있으나, 개발 팀장 이의제기(Job 2560771b)대로 full-bleed 밴드·마퀴 티커를 구조적으로 차단한다. 래퍼 방식의 유일한 약점(신규 라우트 누락)은 AC-25 게이트로 상쇄되므로 래퍼 방식이 우월하다. → R-8.17~R-8.19
D-07 Research Project 카드의 Funder/Sponsor 실데이터 확보 여부 🔴 미결 funder 미노출 + 실존하는 Standards Track 표기 PJ-07. ISL-2026/ 전체를 과제·연구비·IITP·NRF·한국연구재단·정보통신기획평가원 등으로 검색해 0건이다. 임의 생성은 MG-05·R-9.17·R-9.18 위반이며 실명·실제 이메일이 게시되는 페이지이므로 절대 불가. 기본값으로 구현 차단은 아니며, 지도교수가 사업명·부처·기간을 제공하면 content/projects.ts 재생성만으로 반영된다
D-08 Research Project 집합의 정체성 범위 — 레거시 3건(IoT/CCIS/VLC)만인지, ANL 신규 과제를 포함할지 🟡 미결 레거시 3건 노출, 섹션 라벨 Research Projects 레거시 3건은 IoT 시대 실적이고 현 정체성은 ANL이다. 신규 과제 추가는 지도교수 입력이 필요하다(MG-05). 레거시 3건 비노출은 PR-01에 역행하므로 배제
D-09 /publications 인덱스 라우트를 Overview 뷰 / redirect() / 기본 카테고리 재렌더 / 전체 통합 뷰 + All 중 무엇으로 둘 것인가 재확정 (v1.10, 2026-07-31) 결정: Overview 뷰 채택(A안). v1.9는 C안(첫 카테고리 본문 재렌더)을 채택했으나, 개발 팀장 이의제기(Job 22b7a309)대로 동일 DOM 정적 HTML 2본이 생성되어 R-8.25를 위반한다 — 지적이 타당하여 채택안을 교체한다. redirect()(B안)는 AC-25·AC-40과 충돌하고, All 탭 포함 전체 통합 뷰(D안)는 commit 22a31ff의 탭 제거 결정을 되돌리며 223건 단일 페이지로 P-07·R-9.11과도 충돌한다. A안은 고유 콘텐츠(카테고리별 집계 + 최신 하이라이트)를 가지므로 중복이 원천 소멸하고, All 탭 없이 3개 탭 체계를 유지해 22a31ff의 의도를 보존한다 → IA-03 재개정 · R-8.25 · AC-41
D-10 eaddc4f가 도입한 --cobalt: #4A7CE8라이트 테마 대비 미달(ivory 3.49 / paper 3.16)을 어떻게 해소할 것인가 확정 (v1.11, 2026-07-31) 결정: C안 채택 — --cobalt는 #4A7CE8 그대로 두고 --cobalt-dark52 98 204(#3462CC) → 50 84 158(#32549E)로 재조정한 뒤, 소형 텍스트 사용처를 -dark 변형으로 라우팅한다. 근거: ⓐ 사용자가 지정한 브랜드 색이 보존된다 — 히어로 SVG(var(--cobalt) 직접 참조)·대형 세리프 수치·불릿·테두리·아이콘 등 시각적으로 먼저 인지되는 표면은 전부 #4A7CE8을 유지하며, 이들은 대형 텍스트·비텍스트 UI 기준(3:1)을 실측 3.49로 충족한다. ⓑ cobalt-dark 슬롯은 현재 사용처 0건이므로 신규 토큰 없이 빈 슬롯을 활용해 토큰 계층이 늘지 않는다. ⓒ 결과값 6.43 / 5.82는 vermillion-dark(6.38 / 5.77)와 동일 등급이라 두 강조색이 대칭이 된다. 기각 사유 — A안(--cobalt 자체를 #3C64BC로 하향)은 브랜드 색이 눈에 띄게 어두워져 지시를 훼손하고, B안(신규 --cobalt-text 토큰)은 비어 있는 -dark 슬롯과 역할이 중복되며, D안(#1B3A8A 복귀)은 사용자 지시 역행이다. #3C64BC(paper 4.51)가 아니라 #32549E(5.82)를 쓰는 이유는 4.51이 임계선 대비 여유 0.01에 불과해 §12.1의 opacity-90 사고(4.69 → 4.05)처럼 후속 변경 한 번으로 재미달하기 때문이다. v1.12 개정 — 배지·칩 전경/배경: 개발 팀장(Agy) 이의제기(Job 7f136931)를 수용해 v1.11의 bg-cobalt text-ink dark:text-ivory(5.03 / 4.82)를 폐기하고 bg-cobalt-dark text-ivory(6.43 / 6.57) 로 교체한다. v1.11은 소형 텍스트 12곳에만 -dark 라우팅을 적용하고 동일 크기 등급(10.4 px)의 상태 칩 2곳은 DEFAULT 배경으로 남겨 스스로의 원칙과 어긋나 있었다 — 지적이 타당하다. 다만 이의제기의 권장 전경 text-white dark:text-ivory(7.25 / 6.57)는 미채택-dark 배경에서는 ivory 전경만으로 양 테마가 통과하므로 팔레트 외 색 whitedark: 변형이 모두 불필요하다(→ R-8.29). 아울러 권장안을 그대로 적용하면 standardization:87-89 삼항식의 나란한 두 칩의 상대휘도 대비가 1.19 → 1.54로 악화되므로, vermillion 칩도 -dark로 통일해 1.01로 맞춘다(→ R-8.26 짝 칩 등급 일치 조항) → R-8.26 · R-8.29 · AC-42 · AC-43 · AC-44 · AC-47
D-11 text-vermillion(DEFAULT) 소형 텍스트 약 30곳을 교정할 것인가 🟡 미결 현행 유지 (교정하지 않음) 실측 ivory 4.16 / paper 3.77로 R-8.26 소형 텍스트 기준에 미달하나, ⓐ eaddc4f가 만든 회귀가 아니라 최초 커밋 36a4cd8 이래의 상태이고, ⓑ 30곳 일괄 변경은 "전체적인 에디토리얼 디자인 시스템 유지" 목표와 정면 충돌하는 시각적 대변경이며, ⓒ vermillion(#D9342B)은 사용자가 명시적으로 현행 유지를 지정한 색이다. 교정 시에는 D-10과 동일한 패턴(text-vermillion-dark dark:text-vermillion, 라이트 6.38 / 5.77)을 적용하면 되므로 기술적 경로는 확보되어 있고 판단만 남는다. AC-44 화이트리스트에 사유와 함께 등재해 게이트가 이 결정을 명시적으로 기록하게 한다

D-01 상세

PR-04에 명시된 4개 라벨 중 1번과 2번의 범위가 논리적으로 중첩된다. International Journal & Conference가 국제 저널과 국제 학술대회를 모두 포함한다면, International Conference는 그 부분집합이 되어 동일 레코드가 두 카테고리에 해당하게 된다.

레거시 데이터 구조와의 대조:

레거시 파일 실제 내용 PR-04 라벨과의 대응
paper-international.html 국제 저널 67 + 국제 학술대회 1 = 68 International Journal & Conference에 정확히 대응
paper-domestic.html 국내 논문 80 (KCI 48) Domestic Journal & Conference에 정확히 대응
patent.html 특허 75 Patent에 정확히 대응
대응 원본 없음 International Conference⚠️

권고안 (A안) — 국제 실적을 저널/학술대회로 분리: International Journal / International Conference / Domestic Journal & Conference / Patent → 1번 라벨이 Journal의 오기라는 가정. 레거시 국제 목록을 게재처로 분리하면 저널 67 / 학술대회 1이 되어 학술대회 카테고리가 1건으로 빈약해지는 점을 함께 확인해야 한다.

대안 (B안) — 원문 라벨을 그대로 두고 1번을 국내외 통합 학술대회 카테고리로 재정의: International Conference에 미수록 학술대회 논문을 지도교수로부터 확보해 채운다.

리뷰어 판단: 어느 안이든 P-02의 레지스트리 설계로 인해 구현 착수를 막지 않는다. P1 단계에서는 레거시 3개 원본을 그대로 3개 카테고리에 적재하고, D-01 확정 후 4번째 카테고리 분리를 적용하는 순서를 권고한다. 단 P-03(레코드 무손실) 은 어느 안에서도 반드시 지켜져야 한다.

확정 결과 (v1.5, 2026-07-30 · commit 51aae14)C안: 1번 단독 카테고리 폐기로 결정되었다.

항목 내용
기각된 A안 국제 실적을 저널/학술대회로 분리 → 학술대회가 실측 1건뿐이어서 단독 카테고리로 성립하지 않음
기각된 B안 미수록 학술대회 논문을 추가 확보 → MG-05(ISL-2026/에 없는 데이터 생성 금지) 에 저촉되며 신규 원본 유입 없이는 실행 불가
채택된 C안 intl-conf 슬러그·라벨·타입 유니온을 제거하고 3개 카테고리로 확정
무손실 검증 intl-conf 배정 레코드 0건 → 축소가 정의상 무손실. 실측 68 + 80 + 75 = 223건 유지
변경 범위 content/categories.ts, content/types.ts(유니온), E2E 기대 라우트 목록, README.md 라우트 맵 — P-02 설계 예측대로 레지스트리 중심 수정으로 완결

이 확정으로 §4.1 사이트맵·§7 PubCategory·P-01·P-03이 v1.5에서 함께 갱신되었고, 문서 상태가 승인(Approved)으로 전환되었다.

D-09 상세 — 색 토큰 알파 계약 붕괴와 /publications 리다이렉트 (v1.9)

D-09를 촉발한 것은 라우트 문제 하나가 아니라, 정적 게이트 전부를 통과하면서 화면만 무너지는 결함 계열이 한 배치에서 두 종류 확인된 사건이다. 계약을 §8.7로 승격한 근거를 여기에 기록한다.

(1) 근본 원인 — 쉼표 구분 --*-rgb

app/globals.css는 토큰을 --vermillion-rgb: 217, 52, 43;처럼 쉼표 구분으로 정의해 왔다. 반면 tailwind.config.tsrgb(var(--vermillion-rgb) / <alpha-value>)를 선언했고, Tailwind는 이를 다음으로 전개한다.

.bg-vermillion { --tw-bg-opacity: 1; background-color: rgb(var(--vermillion-rgb) / var(--tw-bg-opacity, 1)) }
                                                        ↓ var() 치환 후
                                                     rgb(217, 52, 43 / 1)   ← 무효

rgb()공백+슬래시(현대) 또는 전량 쉼표(레거시) 중 하나여야 하며 혼용은 문법 위반이다. 무효 선언은 invalid at computed-value time 으로 폐기되므로 토큰 배경색이 아예 적용되지 않는다. 커밋 7889398("solid vermillion background")·40b252b("enforce high contrast white text")가 같은 증상을 반복 교정하려 한 이력이 이 진단을 뒷받침한다.

(2) 부작용 — <alpha-value> 제거가 만든 2차 무성 결함

7889398은 위 증상을 colors.ivory = "var(--ivory)" 형태로 축약해 해결했다. 단색은 정상화되었으나, 알파 자리표시자가 사라지면 Tailwind는 슬래시 수식자 유틸리티를 오류 없이 생략한다(독립 프로브로 확인). 그 결과 소스에 남은 26개 사용처가 전부 무효화되었고 lint·tsc·빌드·Gate 0–7은 그대로 통과했다.

소멸한 유틸리티 계열 대표 사용처 실제 화면
bg-*/… Header bg-ivory/85 sticky 헤더 배경 소실(본문이 비쳐 지나감)
border-*/… (15건) border-line/60 Preflight 기본색 #e5e7eb — 팔레트 외 회색, 다크 모드에서 특히 부각
text-*/… Footer text-ink/90 부모 색 상속
ring-*/… ProjectPageView focus:ring-vermillion/50 Tailwind 기본 파란색 포커스 링

(3) 3차 결함 — 인라인 style 우회

단색이 적용되지 않는 상태를 우회하려 활성 배지에 style={{ backgroundColor: "var(--vermillion)", color: "#ffffff" }}가 투입되었다. 인라인 styledark: 변형을 항상 이기므로 다크 모드에서 흰색 전경이 고정되었고, opacity-90이 함께 도입되어 대비가 추가로 떨어졌다. 이는 Job b3f001de에서 제기하고 43c75da에서 해소했던 R-9.6 결함의 직접 회귀다.

상태 라이트 다크 판정
배지 라벨 (흰색 단색) 4.69:1 3.74:1 다크 미달
배지 번호·en (opacity-90) 4.05:1 3.29:1 양 테마 미달
참고: 43c75dadark:text-ivory 4.69:1 5.01:1 양 테마 충족

(4) 확정 — 계약 복원이 스타일 보존과 일치한다

항목 내용
채택 --*-rgb공백 구분으로 정정(R-8.21) + tailwind.config.ts<alpha-value> 복원(R-8.22) + 인라인 style·opacity-* 제거(R-8.23)
기각 <alpha-value> 제거 상태 유지 후 26개 사용처를 각각 리터럴 색으로 치환 — 토큰 체계가 사실상 붕괴하고 다크 모드 반전이 사용처마다 깨진다
스타일 영향 의도된 디자인으로의 복원이며 재디자인이 아니다. 사용처 26곳은 원래 의도대로 렌더되고, 단색 토큰은 7889398 이후 상태를 그대로 유지한다
재발 방지 AC-35(슬래시 수식자 실효성) · AC-36(공백 구분) · AC-37(인라인 style 0건) · AC-38(양 테마 대비) 게이트 신설

(5) /publications 라우트 (v1.10 재확정)

같은 배치에서 All Overview 탭 제거와 함께 /publicationsredirect()로 대체되어 Gate 8이 실측 실패했다(<main> tag not found in .next/server/app/publications.html).

v1.9는 C안(첫 카테고리 본문 재렌더) 을 채택했으나, 개발 팀장 이의제기(Job 22b7a309)가 정적 HTML 2본이 동일 DOM을 갖는 문제를 지적했고 이는 타당하다. 현재 코드베이스에 metadataBase·alternates.canonical전무함을 확인했으므로(grep 0건), C안을 그대로 두면 완화 장치 없이 중복이 노출된다. 이에 A안(Overview 뷰) 으로 교체한다.

중복 22a31ff(All 탭 제거) 의도 AC-25/40 판정
A · Overview 뷰 없음 보존(탭은 3개 유지) 충족 채택
B · redirect() 유지 보존 위반 기각
C · 첫 카테고리 재렌더 2본 동일 보존 충족 기각 (v1.9 → v1.10 교체)
D · 전체 통합 + All 없음 역행 충족 기각

한편 이의제기의 두 번째 논거(isActive 하이라이트 모호)는 성립하지 않는다. Header.tsx의 활성 판정은 pathname === href || pathname.startsWith(\${href}/`)이므로, href="/publications"`는 세 하위 카테고리 경로 전부에 대해 이미 참이 된다. v1.9 계획의 3-3(예외 분기 제거)은 이 일반 규칙만으로 성립하며 별도 조치가 필요 없다. Overview에서 하위 탭이 하나도 활성이 아닌 것은 결함이 아니라 Overview의 정상 상태다(→ IA-03).


D-10 상세 — 강조색 교체가 대비를 붕괴시킨 경위 (v1.11)

증상. 커밋 eaddc4f("update primary color token to #4A7CE8 and secondary to #D9342B") 이후 라이트 테마에서 cobalt 계열 소형 텍스트가 읽기 어려워졌다. lint·tsc·프로덕션 빌드·기존 게이트 0~9가 전부 통과한다 — 빌드는 exit 0, 정적 13/13 생성, 동적 라우트 0건이다.

변경 실체. :root 블록 2줄만 바뀌었다.

-  --cobalt-rgb: 27 58 138;        /* #1B3A8A */
-  --cobalt-dark-rgb: 18 40 99;    /* #122863 */
+  --cobalt-rgb: 74 124 232;       /* #4A7CE8 */
+  --cobalt-dark-rgb: 52 98 204;   /* #3462CC */

html.dark 블록(--cobalt-rgb: 77 119 255)과 --vermillion-*양 블록 모두 미변경이다.

대비 실측(WCAG 2.1 공식 재계산).

조합 변경 전 변경 후 판정
text-cobalt on ivory 9.23 3.49 소형 텍스트 미달
text-cobalt on paper 8.35 3.16 소형 텍스트 미달
ivory on bg-cobalt 9.23 3.49 미달
text-cobalt-dark on paper 11.16 4.48 간발의 미달

소형 텍스트 미달 사용처는 14건(text-cobalt 12건 + bg-cobalt 소형 배지 2건)이다. 반면 page.tsx:92(text-3xl, 30 px)·page.tsx:174(불릿 도형)·ThemeToggle.tsx:146(아이콘)·members/page.tsx:102,132(hover:border-cobalt)는 대형 텍스트·비텍스트 UI 기준 3:1을 3.49로 충족한다. 즉 #4A7CE8은 큰 글자·도형으로는 적법하고 작은 글자로만 부적법하며, 이 경계가 D-10 채택안의 설계 근거다.

근본 원인 — 반전 계약 이탈. 이 시스템의 모든 토큰은 html.dark에서 반전된다(ivory 245→18, ink 10→245). cobalt도 예외가 아니어서 라이트는 짙은 남색, 다크는 밝은 청색이었다.

라이트 L 다크 L 라이트↔다크 대비
변경 전 0.0509 (#1B3A8A) 0.2199 (#4D77FF) 3.13
변경 후 0.2170 (#4A7CE8) 0.2199 (#4D77FF) 1.01

라이트 값이 다크 값과 사실상 같은 밝기가 되었다 — cobalt 한 토큰만 반전 체계에서 이탈해, 라이트 테마가 다크 테마용 밝기를 그대로 반입했다. → R-8.28.

게이트가 놓친 이유. Gate 6은 ["--ink", "--ivory", …, "--cobalt"]문자열 존재 여부만 확인하고, Gate 9는 알파 계약(구분자·<alpha-value>·인라인 style)만 확인한다. run_e2e_tests.pycontrast·4.5·luminance 검사는 0건이다. 즉 토큰의 "값"을 검사하는 게이트가 없어 --cobalt: #FF00FF로 바꿔도 10개 게이트가 전부 통과한다. → AC-43 · AC-44 · AC-45 · AC-46.

문서가 사고에 기여한 부분. docs/DESIGN.md의 커스터마이즈 훅은 "강조색 2개와 그 -dark 변형만 교체하면 됩니다"라고 교체 방법만 안내하고 지켜야 할 대비 제약을 적지 않는다. 안내를 문자 그대로 따른 결과가 이 커밋이므로, 문서 교정(R-8.27)이 재발 방지의 일부다.

부수 확인 — Secondary는 무변경. 커밋 메시지의 …and secondary to #D9342B는 변경이 아니라 현상 유지의 서술이다. --vermillion-rgb는 최초 커밋 36a4cd8(--vermillion: #d9342b) 이래 상수이며, 02247a0217, 52, 43217 52 43은 R-8.21 구분자 교정이지 색 변경이 아니다. 수렴 대장에 "Secondary 변경 검증 완료"로 기재되면 사실과 어긋나므로 무변경(no-op) 으로 기록한다.

AC-42 미충족 잔존. 직전 수렴(02247a0)에서 AC-42는 통과로 판정되었으나, 문언의 "vermillion 배경 위 텍스트 전량" 중 교정된 것은 Header 2곳·CategoryNav 1곳뿐이고 standardization/page.tsx:40·:88, lectures/page.tsx:89, members/page.tsx:1774곳이 4.16:1로 남아 있다(뒤 두 곳은 group-open: 상태 변형이라 육안 리뷰에서 누락되기 쉽다). → AC-42 개정.

D-10 보론 — 배지·칩 부류 분리 (v1.12, Agy 이의제기 7f136931 반영)

v1.11의 설계 오류. v1.11 §6.5는 bg-cobalt(#4A7CE8) 배경을 유지한 채 전경만 text-ink로 바꾸도록 정했다. 이는 채택안 C의 원칙("작은 요소는 -dark 변형으로 라우팅한다")을 소형 텍스트 12곳에만 적용하고 동일 크기 등급의 상태 칩 2곳에는 적용하지 않은 일관성 결함이다. 개발 팀장 이의제기가 이를 정확히 지적했다.

기술적 근거(심미 판단과 독립). 이의제기의 논거는 "짙은 검은 텍스트가 매거진 톤을 훼손한다"는 심미 판단이나, 같은 결론을 취향과 무관하게 지지하는 근거가 있다.

bg-cobalt(#4A7CE8) 위 전경 대비
ivory 3.49 🔴
white 3.93 🔴
ink-soft 3.94 🔴
ink 5.03 (유일)

팔레트 내 후보 4종 중 통과는 1종뿐이고, 그마저 라이트 전용이다 — 다크에서 --ink-rgb245 241 232로 반전되어 3.49로 미달하므로 dark:text-ivory를 수동으로 덧대야 한다. 즉 반전 계약을 손으로 우회하는 구조였다. bg-cobalt-dark text-ivory는 6.43 / 6.57로 dark: 없이 양 테마가 자동 통과한다(→ R-8.29).

권장안을 그대로 쓰지 않은 이유 — 짝 칩 무게 불균형. 대상인 app/standardization/page.tsx:86-90하나의 삼항식으로, InProgress(vermillion)와 그 외(cobalt) 배지가 문서 목록의 같은 자리에 번갈아 나타난다.

조합 배경 상대휘도 두 칩 간 대비
v1.11: vermillion #D9342B ↔ cobalt #4A7CE8 0.1738 ↔ 0.2170 1.19
이의제기 권장안: vermillioncobalt-dark #32549E 0.1738 ↔ 0.0949 1.54 (악화)
v1.12 확정: vermillion-dark #A8231C ↔ cobalt-dark #32549E 0.0961 ↔ 0.0949 1.01

cobalt 칩만 어둡게 내리면 vermillion 칩이 밝은 채로 남아 무게 차가 오히려 벌어진다. 이의제기의 논거(에디토리얼 완성도)가 요구하는 vermillion 쪽 대칭 조치가 권장안에서 누락되었다. 두 강조색의 -dark 변형은 휘도가 거의 같으므로(0.0961 vs 0.0949) 추가 색 조정 없이 균형이 나온다.

부류 A / 부류 B. 크기 기반으로 두 패턴을 분리한다 — R-8.26의 논리(가장 작은 글자에 가장 여유 있는 대비)를 연장한 것이다.

부류 대상 패턴 라이트 / 다크
A 상태 칩(text-[0.65rem]) standardization:40·:88(verm) · standardization:89 · publications/[category]:135(cobalt) bg-{accent}-dark text-ivory 6.386.43 / 6.576.72
B 인터랙티브 내비·토글 Header:69,129 · CategoryNav:22(교정 완료) · lectures:89 · members:177 text-white dark:text-ivory 4.69 / 5.01

부류 B를 -dark로 내리지 않는 이유: ① Header 활성 배지는 사이트에서 가장 눈에 띄는 브랜드 표면이며 #D9342B → #A8231C 변경은 "전체 스타일 유지" 지시를 벗어난다. ② 해당 2곳은 02247a0에서 교정되어 리뷰 PASS를 받았으므로 불필요한 재작업·재검증을 유발한다. ③ 4.69:1은 AA를 충족한다 — 개선 여지는 있으나 결함이 아니다.

시각 변경 고지. 부류 A의 vermillion 칩 2곳은 배경이 #D9342B → #A8231C로 실제로 어두워진다. #A8231C는 팔레트에 이미 정의된 vermillion-dark이므로 신규 색이 아니며(R-8.1 위반 아님) 대상 면적도 text-[0.65rem] 칩 2개로 극히 작다. GM이 배경 무변경을 선호하면 부류 B 패턴(bg-vermillion text-white dark:text-ivory, 4.69)으로 내려도 규격은 충족되며, 그 경우 위 표의 무게 불균형 1.54가 남는다는 점만 함께 기록한다 — 차단 사유가 아니라 선택지다.


12.2 리스크

ID 리스크 영향 완화 방안
R-01 레거시 HTML의 비정형 마크업으로 추출 정확도 저하 PR-01 위반 (데이터 누락·오배치) MG-01 스크립트화 + MG-02 건수 대조 + P1-R 독립 검증
R-02 223건 일괄 렌더로 초기 로드 지연 성능 저하 P-07 점진적 노출, R-9.11·9.12 예산 명시
R-03 Tailwind JIT이 동적 조립 클래스를 인식하지 못함 빌드는 성공하나 조판이 조용히 붕괴 클래스는 완전한 문자열 리터럴로 작성. AC-20으로 빌드 CSS 실측 검증
R-08 (v1.1 신설) Publications 필터 구현이 정적 생성을 깨뜨림 ƒ Dynamic 전환 → DM-03·NF-03 위반, 또는 빌드 중단 §8.5 실측 규칙 R-8.11~8.16 준수. AC-17·AC-21·AC-22로 검증
R-09 (v1.1 신설) 레코드 목록이 클라이언트 렌더로 밀려 정적 문서에서 누락 PR-01 실질 위반 — 크롤러·JS 미실행 환경에서 실적이 보이지 않음 R-8.15 서버 렌더 강제. AC-14로 JS 비활성 검증
R-04 실명·실적 데이터 오기재 연구실 신뢰도 훼손 R-9.17·9.18 무결성 원칙, MG-05 창작 금지, 지도교수 최종 확인
R-05 잔재 검사(MG-08)가 논문 제목의 도메인 용어까지 오검출 실데이터를 잔재로 오인해 삭제 → PR-01 위반 MG-08 예외 규정을 검사 스크립트에 반영. 검사 범위를 정체성 서술 영역으로 한정
R-06 문서-코드 불일치 재발 후속 작업자 혼선 R-9.19. 미완 영역은 문서에 미완으로 표기
R-07 P2(Header 수정)와 P3~P5 병렬 진행 시 충돌 머지 충돌 §11.1 주석대로 P2 선행 완료

13. 부록: 레거시 데이터 인벤토리 (실측)

ISL-2026/ 기준, 2026-07-30 파싱 실측치.

원본 파일 레코드 수 비고
member.html 재학 16 / 졸업 60 재학: 교수 1, Ph.D. 1, Ph.D. Candidate 4, Ph.D. Student 5, M.S. Candidate 3, M.S. Student 2. 졸업생 2007~2026
paper-international.html 68 저널 67 + 학술대회 1. 최신 2026-04(IEEE TNSM), 최고(最古) 1995
paper-domestic.html 80 KCI 등재 표시 48건. 최신 2026-06
patent.html 75 국내 출원 다수 + US 출원 일부. 최신 출원 2025-12-16
standard.html 기구 6 / 문서 약 55 국제 5개 기구 + 국내 1개(TTA/PG425). 2000~현재
lecture.html 약 20개 학기 2016 Fall ~ 2026 Spring
index.html 연구분야 3종 IoT Standards, CCIS, VLC-IoT폐기 대상(5대 기둥으로 교체, R-5.3)
introduction.html 연구 주제 13종 구 연구 분야 상세 — 폐기 대상(R-5.3)
image/, assets/ 11.6 MB image/ 3.4 MB + assets/ 8.2 MB. 선별 이관(MG-06)

연락처·소재지 (H-13~H-15 원천)

  • 소재지: 경북대학교 IT대학 5호관(415동) 527호 (레거시 index.html에 HTML 주석 처리된 상태로 존재 — 복원 필요)
  • 소속: School of Computer Science and Engineering, Kyungpook National University
  • 지도교수 이메일: sjkoh@knu.ac.kr
  • 연구실 GitHub: https://github.com/iot-standards-laboratory (→ D-05)
  • 지도교수 GitHub: https://github.com/sjkoh12
  • 기관 링크: KNU http://www.knu.ac.kr/ · 컴퓨터학부 http://cse.knu.ac.kr/ · IT대학 http://it.knu.ac.kr/
  • 전화·팩스: 레거시에 없음 (H-14에 따라 창작 금지)

14. 변경 이력

버전 일자 작성자 내용
1.0 2026-07-30 claude (planner) 최초 작성. 사용자 원본 요구사항(§1)을 정본으로 확장. Job 4148350e
1.1 2026-07-30 claude (planner) 개발 팀장(Agy) 기술 이의제기(Job 175860e4) 반영. §8.5 Next.js 렌더링 제약 신설(실측 5종). IA-03을 라우트 세그먼트 방식으로 개정, P-06 개정 + P-06a·P-07a 신설, DM-03·NF-03·AC-05·AC-16 문구 정정, AC-22~24 및 R-08·R-09 신설. Job 45d05868
1.2 2026-07-30 agy (creator) 교차 리뷰 리포트(Job 3820bdc8) 결함 피드백 전면 반영. F1 §4.1 사이트맵 쿼리 표기를 라우트 세그먼트(/publications/<slug>)로 갱신, F2 §2.1·§2.2 연구 실적 수치 279건 → 223건 정정, F3 §10 수용 기준 AC-14~24 순서 및 그룹핑 정돈. Job f3e09780
1.3 2026-07-30 agy (creator) 교차 리뷰 리포트(Job 60c92d3a) 결함 피드백 전면 반영. G-1 417행 R-8.16 참조 AC-16 → AC-17 정정, G-4 575행 R-03 참조 AC-19 → AC-20 정정, G-2 576행 R-08 참조 AC-16/22/23 → AC-17/21/22 정정, G-3 577행 R-09 참조 AC-24 → AC-14 정정. Job a535ce20
1.4 2026-07-30 agy (creator) 구현 교차 리뷰 리포트(Job 777c3ab8) 피드백 전면 반영. I1 전 파서 ISO 8601 정규화 100%, I2 Footer 주소/이메일 실주소 교체, I3 README 라우트 맵 갱신, I4 verify_counts.py 엄격 게이트로 강화 및 실측 수치(표준 44, 학기 45) 정정, I5 pycache 제거 및 .gitignore 차단, I6/I7 Home 카운터 및 5대 기둥 영문 라벨 정본 정렬. Job a54723ce
1.5 2026-07-30 claude (planner) D-01 확정 및 문서 상태 승인(Approved) 전환. commit 51aae14(백로그 4건 반영)에 대한 검증 결과를 정본에 동기화: intl-conf 단독 카테고리 폐기(A·B안 기각, C안 채택 — §12.1 D-01 상세에 결정 근거 기록), §4.1 사이트맵·§7 PubCategory 유니온·P-01·P-03·IA-03·§11 P0 갱신, 사이트맵의 학기(45)·표준 문서(44) 실측치 정정. Job 343b5808
1.6 2026-07-30 claude (planner) 개발 팀장(Agy) 기술 이의제기(Job 2560771b) 반영. §8.6 레이아웃 컨테이너 아키텍처·브레이크포인트 토큰 신설(R-8.17~R-8.20) — <main> 일괄 부여안을 기각하고 3계층 분리(전체 폭 <main> / 라우트 래퍼 container-content / full-bleed 밴드)를 채택, w-screen 탈출 기법 금지(R-8.18) 및 desktop: 1240px 스크린 토큰화(R-8.20, Tailwind 정렬 동작 실측 확인). D-06 신설·확정, AC-25·AC-26 신설, R-9.14 검수 뷰포트 6종으로 확대. AC-21 정적 HTML 4개 → 3개, R-8.15 표준 문서 55 → 44건 실측치 정정. Job 019b7331
1.7 2026-07-30 claude (planner) Home Hero → Research Project PageView 전환 계획 반영. §6.1.2 신설(PJ-01PJ-14) — 레거시 실재 프로젝트 3건(IoT Standards·CCIS·VLC-IoT) 확인, period·deliverablescontent/standards.ts 조인으로 도출하는 무창작 설계, 활성 슬라이드 전용 캐러셀 금지(PJ-08)·URL 상태 동기화 금지(PJ-09)·캐러셀 라이브러리 금지(PJ-10)·scroll-snap 기반 JS-off 동작 보장(PJ-11) 규정. H-02 개정(슬로건 교체 허용 + H-03·H-04·H-05·H-06·H-07·H-10 존속 명시). **AC-27AC-33 신설**, §7 ResearchProject·ProjectDeliverable 타입 추가, D-07·D-08 신설. Job 6b3840a1
1.8 2026-07-30 claude (planner) 개발 팀장(Agy) 기술 이의제기(Job 2299a6b9) 반영. PJ-13 개정 — 데스크톱 3카드를 flex 스크롤 트랙에서 grid-cols-3 정적 3열 + overflow-visible 로 전환하고 데스크톱 퍼센트 연산을 제거. PJ-15·PJ-16 신설(min-w-0+줄바꿈으로 shrink-0 min-content 넘침 방어 / 스크롤바 은폐 시 AC-34 동반 의무), AC-34 신설(데스크톱 scrollWidth === clientWidth 실측 판정). 이의제기의 근거 수식은 정정 — calc(33.333%-16px)은 초과가 아니라 0.0125 px 미달이며, 대안 B의 분수식은 여유가 0이어서 해당 실패 모드에 오히려 더 취약하다. Tailwind가 calc 연산자 공백을 자동 삽입함과 grid-cols-3minmax(0,1fr) 전개·미디어 쿼리 출력 순서를 실측 확인. Job 294570ab
1.9 2026-07-31 claude (planner) 스타일 관련 누적 커밋 23건(43c75da..b7f2e05) 검증 결과 반영. §8.7 색 토큰 알파 계약 신설(R-8.21R-8.24) — 쉼표 구분 --*-rgbrgb(a, b, c / α) 무효 선언을 만들어 토큰 색이 적용되지 않던 근본 원인을 규명하고, 그 우회로 도입된 <alpha-value> 제거가 슬래시 수식자 유틸리티 26건을 무성 소멸시킴을 독립 프로브로 실측 확인. 인라인 style·opacity-* 토큰 우회 금지(R-8.23)와 헤더 가로 예산(R-8.24, 1240 px 기준 69.3 px 초과 산정) 규정. D-09 신설·확정(/publications redirect() 기각 → 기본 카테고리 화면), IA-03 개정, **AC-35AC-40 신설**. Job 9a79e302
1.10 2026-07-31 claude (planner) 개발 팀장(Agy) 기술 이의제기(Job 22b7a309) 반영. D-09 재확정 — v1.9의 C안(첫 카테고리 본문 재렌더)이 동일 DOM 정적 HTML 2본을 만든다는 지적이 타당하여 A안(Overview 뷰) 으로 교체하고, All 탭 재도입(D안)은 commit 22a31ff 결정 역행·P-07 충돌로 기각. R-8.25 신설(라우트 간 콘텐츠 중복 금지 + canonical 예외 절차), AC-41 신설(<main> 정규화 해시 중복 0건), IA-03 재개정. 이의제기의 isActive 논거는 정정 — pathname.startsWith(\${href}/`)일반 규칙이 하위 카테고리를 이미 포괄하므로 모호성이 없음을 코드로 확인. 아울러 별건으로CategoryNav 활성 탭(bg-vermillion text-ivory)이 **라이트 테마 4.16:1로 R-9.6 미달**임을 발견해 **AC-42 신설**. Job 6a6094c6`
1.11 2026-07-31 claude (planner) 강조색 교체 커밋 eaddc4f 검증 및 리뷰 수렴. 라이트 테마 cobalt 대비가 9.23:1 → 3.49:1(ivory) / 8.35 → 3.16(paper)로 붕괴하여 소형 텍스트 14개 사용처가 AA 미달임을 WCAG 공식 재계산으로 확정. 근본 원인은 명암 반전 계약 이탈(라이트↔다크 상대휘도 대비 3.13 → 1.01)이며, run_e2e_tests.py에 대비 검사가 0건이라 게이트 09와 빌드가 전부 통과한 채로 통과했다 — §12.1 알파 계약 사고와 동일한 무성 실패 유형의 두 번째 발현. **R-8.26R-8.28 신설**(강조색 대비 바닥값 · 색값 변경 시 재측정 의무 · 명암 반전 계약 ≥2.0), AC-43~AC-46 신설(대비 게이트 Gate 10 · 소형 텍스트 라우팅 · 반전 계약 · 폴트 인젝션 4종). D-10 확정--cobalt는 사용자 지정 #4A7CE8을 유지하고 --cobalt-dark만 #3462CC → #32549E(paper 4.48 → 5.82)로 재조정해 소형 텍스트를 -dark로 라우팅(A·B·D안 기각). D-11 신설(🟡 text-vermillion 소형 텍스트 30여 곳, 기본값 현행 유지). AC-42 개정 — 직전 수렴에서 통과 판정되었으나 standardization:40,88·lectures:89·members:177 4곳이 4.16:1로 미교정 잔존함을 확인하고 대상을 명시 목록화, text-white on vermillion 수치를 4.58 → 4.69로 정정. §8.1 색상 토큰표를 실제 값과 동기화하고, Secondary #D9342B는 최초 커밋 이래 무변경(no-op) 임을 계보로 확인해 기록. Job 5c2137c6
1.12 2026-07-31 claude (planner) 개발 팀장(Agy) 기술 이의제기(Job 7f136931) 반영. D-10 배지·칩 결정 재확정 — v1.11의 bg-cobalt text-ink dark:text-ivory(5.03 / 4.82)는 채택안 C의 원칙(작은 요소는 -dark 라우팅)을 소형 텍스트 12곳에만 적용하고 동일 크기 등급의 상태 칩 2곳에는 적용하지 않은 일관성 결함이었음을 인정하고 폐기, bg-{accent}-dark text-ivory 로 교체(6.386.43 / 6.576.72). 이의제기의 권장 전경 text-white dark:text-ivory(7.25)는 미채택-dark 배경에서는 ivory만으로 양 테마가 통과해 팔레트 외 색 whitedark: 변형이 모두 불필요하다(R-8.29 신설). 아울러 권장안을 그대로 적용하면 standardization:87-89 삼항식의 나란한 두 칩 상대휘도 대비가 1.19 → 1.54로 악화됨을 실측해, vermillion 칩도 -dark로 통일하여 1.01 균형을 달성(R-8.26에 배지·칩 라우팅 및 짝 칩 등급 일치 조항 추가). 배지류를 부류 A(text-[0.65rem] 상태 칩 4곳) / 부류 B(인터랙티브 내비·토글 5곳) 로 분리해 AC-42 개정, -dark배경으로 쓰이는 조합을 AC-43 검사 대상에 추가(v1.11 목록은 전경만 다루어 칩 배경을 놓쳤다), AC-47 신설(팔레트 외 색 상한 8건 화이트리스트), AC-46에 폴트 인젝션 ⑤·⑥ 추가(폐기된 v1.11 칩 패턴 및 white 증가 검출). 부류 A vermillion 칩 2곳의 배경이 #D9342B → #A8231C로 어두워지는 시각 변경은 GM 승인 사항으로 명시하되 차단 사유가 아님을 기록. Job 3d3b823a