"화면 명세와 백로그가 충돌하면 백로그를 우선한다"
Project 목록 화면 작업을 시작하기 전에 화면 명세 문서를 확인했는데, Progress, Review Status, Owner 컬럼까지 포함된 풀 스펙이 정의되어 있었습니다. 하지만 이 시점에는 Progress를 계산하는 로직도, Review 관련 테이블도 아직 존재하지 않았습니다.
이 괴리를 그대로 두고 작업을 시작하면, 없는 데이터를 억지로 조회하려다 에러가 나거나 의미 없는 Placeholder만 남을 위험이 있었습니다. 그래서 화면 명세보다 백로그 정의(검색과 3종 필터만)를 우선하기로 미리 결정하고, Progress/Review Status/Owner/Sort는 명시적으로 제외 항목으로 프롬프트에 못박았습니다.
listProjects()에 검색과 필터 기능을 구현받은 뒤, 코드 리뷰에서 SQL Injection 안전성, workspace 경계가 복합 FK 의존 방식으로 안전하게 지켜지는지, 그리고 제외하기로 한 항목들이 실수로도 들어가지 않았는지를 전수 확인했습니다.
목록 화면이 백로그 범위 내에서 정확히 구현된 것까지는 코드 리뷰로 확인했습니다. 다만 실제 브라우저에서의 동작 검증은 이 시점에 하지 않았고, 이후 다른 작업과 함께 통합 검증하는 과정에서 조직·산업명이 잘못 표시되는 버그가 발견되어 별도로 수정하게 됩니다. 화면 명세에 있다고 다 만들 수 있는 건 아니라는 걸, 이번에 명시적인 원칙으로 세워두게 됐습니다.
아직 존재하지 않는 기능을 화면 명세에 있다는 이유만으로 억지로 만들면 의미 없는 Placeholder가 남거나, 없는 데이터를 조회하려다 에러가 날 위험이 있다고 판단해 사전에 범위를 좁혔습니다. 이 시점에 "화면 명세와 백로그가 충돌하면 백로그를 우선한다"는 원칙을 명시적으로 세웠습니다.
관련 프로젝트
프로젝트 개요 비즈니스 프로세스 트랜스포메이션(BPR)을 지원하는 한국어 기반 웹 애플리케이션. 컨설팅 프로젝트의 AS-IS 프로세스 분석부터 TO-BE 설계, Blueprint 승인까지의 전체 워크플로우를 디지털화하는 플랫폼으로, EPIC 단위로 구조화된 백로그를 기반으로 개발 중. 역할 및 워크플로우 PM / Architect / Reviewer 역할 수행 Codex(구현 담당)에게 Task 단위 구현 프롬프트 설계 Codex 구현 결과를 git log, git grep, git status로 직접 검증 후 승인 승인 전에는 Codex가 commit하지 않는 엄격한 게이팅 프로세스 운영 한 번에 하나의 Backlog Task만 진행, Task 완료 전 다음 Task 착수 금지 기술적 의사결정 및 성과 워크스페이스/프로젝트 접근 권한을 DB 레벨(복합 FK, SECURITY DEFINER 트리거)과 애플리케이션 레벨(Server Action 권한 검증)의 이중 방어 구조로 설계 Hard Delete 미구현 원칙 하에 배열 필드 전체교체(replace)를 단일 트랜잭션 RPC로 처리하는 패턴 확립 및 재사용 AS-IS 프로세스 그래프의 순환 참조 탐지에 Tarjan SCC 알고리즘 적용, 차단 오류(Error)와 경고(Warning)를 분리한 이중 Validator 아키텍처 설계 도메인 규칙 위반을 커스텀 Postgres 에러 코드 체계(SIA0104)로 문서화하여 거버넌스 문서와 코드베이스 간 정합성 유지 AI 생성 데이터와 사람이 검증한 데이터를 구분하는 generatedbyai / verified 메타데이터 패턴을 여러 도메인 테이블에 일관되게 적용 진행 상태 ✅ EPIC-01 (인증 / 워크스페이스 / 프로젝트 접근) ✅ EPIC-02 (조직 / 산업 / 프로젝트) 🚧 EPIC-03 (AS-IS 프로세스 그래프) — 그래프 검증, Input/Output 스키마, Business Rule 스키마 구현 완료