eomsangdonandClaude Opus 5
eb30b774f8
- `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>
28 lines
1.2 KiB
Markdown
28 lines
1.2 KiB
Markdown
---
|
|
type: concept
|
|
status: draft
|
|
related_pages: ["[[B01_Dashboard/B01_backend]]", "[[B03_FileInput/B03_backend]]", "[[B04_PreProcess/B04_backend]]", "[[architecture/shared_resources]]"]
|
|
last_updated: 2026-07-12
|
|
source: raw/plans/plan_workflow_state_management.md, raw/guidelines/backend.md + 실 코드 확인 2026-07-12
|
|
---
|
|
|
|
# API 공통 (여러 페이지가 공유하는 엔드포인트)
|
|
|
|
## 공통 오류 응답 포맷 (전 라우터)
|
|
```json
|
|
{"status": "error", "message": "원인"}
|
|
```
|
|
→ [[schema_common]]
|
|
|
|
## 워크플로우 상태 조회
|
|
| 항목 | 위치 | 역할 |
|
|
|---|---|---|
|
|
| `GET /api/projects/{project_id}/workflow-state` | `B03_FileInput_Router.py:667` | 단일 프로젝트의 `current_stage`와 `stages[]` 조회 |
|
|
| `get_workflow_states_for_projects()` | `B01_Dashboard_Repository.py:83` | [[B01_Dashboard/B01_backend|B01_Dashboard]] 목록용 다중 프로젝트 상태 배치 조회 |
|
|
|
|
상태 모델과 사용처: [[workflow_state]].
|
|
|
|
## 폴링 패턴 (legacy workflow.json 설계; 현재 구현은 workflow-state API 사용)
|
|
- 클라이언트가 3초마다 `GET /api/projects/{project_id}/workflow` 호출
|
|
- 과거 설계의 stale 감지 UX 참고용이며, 실제 상태 조회는 [[workflow_state]] API를 사용한다.
|