Files
Aislo/docs/wiki/concepts/api_common.md
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

1.2 KiB

type, status, related_pages, last_updated, source
type status related_pages last_updated source
concept draft
B01_Dashboard/B01_backend
B03_FileInput/B03_backend
B04_PreProcess/B04_backend
architecture/shared_resources
2026-07-12 raw/plans/plan_workflow_state_management.md, raw/guidelines/backend.md + 실 코드 확인 2026-07-12

API 공통 (여러 페이지가 공유하는 엔드포인트)

공통 오류 응답 포맷 (전 라우터)

{"status": "error", "message": "원인"}

schema_common

워크플로우 상태 조회

항목 위치 역할
GET /api/projects/{project_id}/workflow-state B03_FileInput_Router.py:667 단일 프로젝트의 current_stagestages[] 조회
get_workflow_states_for_projects() B01_Dashboard_Repository.py:83 [[B01_Dashboard/B01_backend

상태 모델과 사용처: workflow_state.

폴링 패턴 (legacy workflow.json 설계; 현재 구현은 workflow-state API 사용)

  • 클라이언트가 3초마다 GET /api/projects/{project_id}/workflow 호출
  • 과거 설계의 stale 감지 UX 참고용이며, 실제 상태 조회는 workflow_state API를 사용한다.