AI운영이슈🔬 AX 케이스 스터디2026. 08. 11.(업데이트: 2026. 08. 21.)

같은 명령인데 다르게 동작했습니다 — Sandbox와 로컬 PowerShell 사이

"같은 명령도 실행 환경에 따라 다르게 동작한다"

🔴 Before (문제 상황)

로컬 커밋과 빌드까지는 문제 없었지만, 실제 DB(si-in-ai-dev) 반영 작업은 네트워크가 필요해 Sandbox 밖 구버전 PowerShell 5.1 환경에서 진행해야 하는 상태
supabase db push가 일부 마이그레이션만 보여줘 정상인지 판단이 필요한 상황
SQL을 PowerShell에 직접 입력, <project-id> 같은 placeholder를 그대로 복사하는 실수, Out-File -Encoding utf8NoBOM 미지원 등 여러 실무 문제 발생

🟢 After (해결/결과)

supabase db push가 Industries 마이그레이션만 보여준 것이 정상임을 확인(Platform Role 마이그레이션은 이전 작업 때 이미 적용됨)
SQL Editor 사용, 실제 project-id 값 사용, .NET 메서드 직접 호출 방식으로 각 문제를 순차 해결
industries 테이블 생성 확인("Success. No rows returned"), database.types.ts 재생성, npm run build가 관련 라우트 포함해 정상 빌드됨을 확인

로컬에서 커밋과 빌드까지는 아무 문제가 없었습니다. 문제는 그다음, 실제 DB(si-in-ai-dev)에 마이그레이션을 반영하고 타입을 재생성하는 단계였습니다. 이 작업은 네트워크가 필요해 Sandbox 밖, 구버전 PowerShell 5.1 환경에서 직접 진행해야 했습니다.

첫 번째로 supabase db push를 실행했을 때 Industries 관련 마이그레이션만 표시됐는데, 이게 정상인지 확인이 필요했습니다. 확인 결과 Platform Role 마이그레이션은 이전 작업 때 이미 적용되어 있어서 표시되지 않은 것뿐이었습니다. 이어서 SQL 쿼리를 PowerShell 터미널에 직접 입력하는 실수가 있어 Dashboard SQL Editor 사용으로 정정했고, <project-id> 같은 플레이스홀더 값을 그대로 복사해 리다이렉션 파싱 에러가 발생한 것도 실제 값으로 교체해 해결했습니다.

PowerShell 5.1이 Out-File -Encoding utf8NoBOM을 지원하지 않는다는 것도 확인해, .NET 메서드를 직접 호출하는 방식으로 대체했습니다. 이런 문제들은 하나하나가 크지 않았지만, Sandbox의 네트워크 제약과 로컬 환경의 구버전 도구라는 두 가지 조건이 겹쳐 있어서 매 단계마다 "이걸 어디서 실행해야 하는지"부터 명확히 구분해줘야 했습니다.

최종적으로 industries 테이블이 실제 DB에 생성된 것을 SQL Editor에서 "Success. No rows returned"로 확인했고, database.types.ts가 실제 스키마 기준으로 재생성됐으며, npm run build가 관련 라우트를 포함해 정상 빌드되는 것까지 확인했습니다. 다만 이 시점에서 확인한 건 빌드 성공까지이고, 실제 화면에서 기능이 동작하는지는 다음 단계에서 별도로 검증해야 하는 부분으로 남아있었습니다.

🧐 재설계 근거 (Why)

Sandbox 네트워크 제약(허용 도메인에 실제 DB 서비스 미포함)과 사용자 로컬 환경의 구버전 도구 차이라는 두 가지 제약 조건이 동시에 작용하고 있었습니다. 이 상황에서는 매 단계마다 "무엇을 어디서 실행해야 하는지"를 명확히 구분해 안내하는 것이 문제 해결의 전제조건이라고 판단했습니다.

💡 재현 가능성 (Replicability)

supabase db push로 diff를 확인한다(이미 적용된 마이그레이션은 표시되지 않는 게 정상)
Dashboard의 Table Editor 또는 SQL Editor에서 테이블 존재를 직접 확인한다
supabase gen types typescript --project-id <실제ID> --schema public으로 타입을 재생성한다(플레이스홀더 문자가 남아있지 않은지 확인)
PowerShell 버전에 따라 Out-File -Encoding utf8NoBOM 또는 .NET WriteAllText 중 동작하는 방식을 선택한다
npm run build로 최종 검증한다

SI in AI Platform

프로젝트 개요 비즈니스 프로세스 트랜스포메이션(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 스키마 구현 완료

Next.jsSupabaseTypeScriptZodVitestPostgreSQL