c78f928a2d
- Redmine 8단계 페르소나 파이프라인 (.claude/agents, workflows) - Design-First docs 골격 (docs/design, docs/adr, docs/pipeline) - 안전-최대 권한 정책 (.claude/settings.json) - Tasteby 고유 규칙 보존 (CLAUDE.md 병합) - scripts/enqueue.sh: Redmine 큐 투입 Refs: tasteby bootstrap
52 lines
1.5 KiB
Markdown
52 lines
1.5 KiB
Markdown
<!-- 함수별 설계서 템플릿. 복잡 함수마다 design/<issue-id>-<slug>/fn-<function_name>.md 로 작성.
|
|
작성: [AI] Architect, 구현 전 필수. -->
|
|
|
|
# 함수 설계서: `<function_name>` (#<issue-id>)
|
|
|
|
> **부모 설계서**: ./README.md · **상태**: Draft <!-- Draft|Approved|Superseded -->
|
|
> **작성**: [AI] Architect · **구현**: <file:function 또는 TBD> · **테스트**: <경로 또는 TBD>
|
|
|
|
## 1. 시그니처
|
|
```
|
|
<returnType> <function_name>(<params>) # 언어 확정 후 정확히 기재
|
|
```
|
|
|
|
## 2. 책임 (단일 책임, 1줄)
|
|
이 함수가 하는 단 하나의 일.
|
|
|
|
## 3. 입력
|
|
| 파라미터 | 타입 | 제약/검증 | 설명 |
|
|
|----------|------|-----------|------|
|
|
| `<p>` | | | |
|
|
|
|
## 4. 출력
|
|
- **반환**: 타입 / 의미.
|
|
- **부수효과**: (있으면 — I/O·상태변경 명시) / 없으면 **순수 함수**.
|
|
|
|
## 5. 동작 / 알고리즘
|
|
1. ...
|
|
2. ...
|
|
|
|
## 6. 에러 & 실패 모드
|
|
| 조건 | 처리 | 반환/예외 |
|
|
|------|------|-----------|
|
|
| | | |
|
|
|
|
## 7. 엣지케이스
|
|
- 경계값(0, 음수, 빈값, 최대), 동시성, 부분 실패.
|
|
|
|
## 8. 복잡도 / 성능
|
|
- 시간/공간 복잡도. 호출 빈도(예: 시세 폴링 루프 내부인가?).
|
|
|
|
## 9. 의존성
|
|
- 호출하는 함수/모듈, 외부 API, 설정 키.
|
|
|
|
## 10. 테스트 케이스
|
|
- [ ] 정상: <입력 → 기대 출력>
|
|
- [ ] 경계: ...
|
|
- [ ] 실패: ...
|
|
|
|
## 11. 추적성
|
|
- 인수조건: #<issue-id> 의 "<항목>".
|
|
- 관련 ADR: <ADR-NNNN 또는 없음>.
|