Skip to main content

2026년 4월 변경 이력

2026-04-23 (목)​

✅ Scene 생성 프롬프트 용어를 스튜디오 프롬프트로 통일​

사진/영상 Scene 생성에서 사용하던 자동 제어 레이어를 사용자-facing 용어 기준으로 스튜디오 프롬프트에 통합했습니다.

  • Scene 생성도 studio + dynamic + user 프롬프트 계층을 따른다고 정리
  • 영상 생성의 프레임 간 일관성 지시는 별도 영역이 아니라 영상 Scene의 스튜디오 프롬프트에 포함한다고 명시
  • 생성 레시피의 최종 프롬프트는 사용자 제어 값 중심으로 표시하고, 스튜디오 프롬프트는 기본 접힘 영역으로 분리한다고 정리
  • 영상 준비/생성 흐름을 착장 기반이 아니라 등록 사진 1장을 시작 이미지로 사용하는 구조로 업데이트

문서 반영​

  • features/personas/OVERVIEW.md
  • features/personas/PROMPT_STRATEGY.md

2026-04-09 (목)​

✅ 페르소나 서비스의 기본 에셋 설계 방향 문서화​

서비스 적응을 위한 시스템 제공 샘플 자산을 기본 에셋 개념으로 분리하고, 관리자 관리 화면 및 사용자 필터 전략을 문서에 반영했습니다.

  • 기본 에셋은 PUBLIC/PRIVATE 공개 범위와 별도로 USER/SYSTEM 출처 축으로 관리
  • 페르소나/코디/착장에는 assetSource 도입 방향을 명시
  • 관리자 업로드 이미지/영상은 creations와 분리된 별도 저장 모델로 관리하도록 정리
  • 관리자 메뉴에 기본 에셋 관리를 추가하고, 사용자 좌측 목록에는 기본 에셋 포함 체크박스를 기본 활성화하는 UX를 계획

문서 반영​

  • project-overview/02-planning/MODULES.md
  • project-overview/02-planning/ROADMAP.md
  • features/personas/OVERVIEW.md
  • features/personas/STYLING_MODULE_IMPLEMENTATION_PLAN.md

2026-04-08 (수)​

✅ Durable status plane 2차 핵심 흐름을 현재 구현 상태로 정렬​

결과 등록과 최종 완료의 책임을 backend authoritative 흐름에 더 명확히 맞췄습니다.

  • 결과 일부 등록 시 Creation.status가 PROCESSING으로 되돌아가지 않고 POST_PROCESSING을 유지하도록 정리
  • completed는 결과 개수 기준으로 backend가 확정하는 현재 구현 원칙을 문서에 반영
  • artifact_registered는 개념적 이름으로 두고, 현재 wire-level 이벤트명은 creation_result_added로 유지한다고 명시

문서 반영​

  • project-overview/03-architecture/AGENT_RELAY_PROTOCOL.md
  • project-overview/03-architecture/AI_SERVER_REDIS_EXIT_STRATEGY.md

✅ Durable status plane 최종안과 DB authoritative 원칙 문서 반영​

relay 기반 아키텍처에서 durable status plane의 구현 범위를 더 명확히 고정했습니다.

  • durable status를 Redis write가 아니라 backend domain service를 통한 DB 상태 전이로 정의
  • post_processing, failed, processing_failed를 1차 범위로 정리
  • completed, artifact_registered는 post-processing/backend 기준 2차 범위로 분리
  • Redis는 durable source가 아니라 projection/cache 역할로 유지
  • DB 과부하 회피를 위해 heartbeat/progress는 끝까지 DB에 쓰지 않는 원칙을 명시

문서 반영​

  • project-overview/03-architecture/AGENT_RELAY_PROTOCOL.md
  • project-overview/03-architecture/AI_SERVER_REDIS_EXIT_STRATEGY.md

✅ Public relay 프로토콜 문서 추가 및 아키텍처 표현 정리​

relay 중심 구조를 실제 구현 가능한 수준으로 고정하기 위해, transport/이벤트/Redis adapter 규칙을 별도 문서로 추가하고 아키텍처 문서의 direct Redis 표현을 정리했습니다.

  • heartbeat, progress, node.monitor, command는 WebSocket 중심으로 정리
  • post_processing, completed, failed, artifact 등록은 HTTP 중심으로 정리
  • 외부 ai-node-agent는 shared Redis/RDS에 직접 붙지 않고 relay만 바라보도록 명시
  • ARCHITECTURE.md 하단의 direct Redis 발행 서술을 relay 기준으로 수정

문서 반영​

  • project-overview/03-architecture/AGENT_RELAY_PROTOCOL.md
  • project-overview/03-architecture/ARCHITECTURE.md
  • project-overview/03-architecture/AI_SERVER_REDIS_EXIT_STRATEGY.md
  • project-overview/README.md

2026-04-07 (화)​

✅ AI Server Redis 탈피 전략을 relay 중심 구조로 재정의​

외부 연산 노드가 AWS private Redis에 직접 붙는 구조의 한계를 반영해, 아키텍처 전략 문서를 다음 방향으로 재정리했습니다.

  • shared Redis는 유지하되 ai-server -> Redis direct access는 제거
  • local backend, dev backend가 계속 같은 중앙 상태를 볼 수 있도록 단일 shared Redis 유지
  • 외부 노드는 각 backend 주소 대신 단일 public relay 주소만 알도록 전환
  • relay와의 통신은 역할에 따라 WebSocket + HTTP hybrid로 분리
  • Redis와 relay는 물리적으로 여러 개로 쪼개기보다 단일 허브를 유지하고 역할만 논리적으로 분리

문서 반영​

  • project-overview/03-architecture/AI_SERVER_REDIS_EXIT_STRATEGY.md
  • project-overview/03-architecture/REALTIME_PIPELINE.md
  • project-overview/03-architecture/ARCHITECTURE.md
  • project-overview/README.md

2026-04-01 (수)​

✅ 생성 실행부 운영 구조 문서화​

Dev/Prod 생성 실행부 운영 방식을 다음과 같이 문서에 반영했습니다.

  • local/dev/prod 환경별 생성 실행부 역할 분리
  • ComfyUI와 ai-node-agent를 generation runtime으로 정리
  • 진행률, 상태, 결과물 업로드는 SQS/S3/Redis/relay 기반으로 전달
  • local/dev/prod queue와 bucket/prefix 분리
  • API-node 기반 generation과 후처리 worker 분리를 기준으로 문서화

문서 반영​

  • project-overview/04-infra-deployment/TARGET_INFRASTRUCTURE_PLAN.md
  • project-overview/04-infra-deployment/DEV_COMPUTE_SERVER.md
  • project-overview/04-infra-deployment/README.md
  • project-overview/01-introduction/OVERVIEW.md
  • project-overview/03-architecture/ARCHITECTURE.md