docs(phase 105): Logger Box Framework設計&ドキュメント整備
- Create logger_box_design.md: comprehensive Logger Box framework design - Define 3 reference patterns (Lightweight/Structured/Contextual) - Add pseudo-code examples for each pattern (reference only) - Update logging_policy.md: add Logger Box reference - Update hako_logging_design.md: Logger Box integration with Phase 104 - Update ring0-inventory.md: Phase 105 entry - Update CURRENT_TASK.md: Phase 105 completion + Phase 106+ backlog Design principles: - Logger Box provides level-based logging (DEBUG/INFO/WARN/ERROR) - Phase 105 scope: ConsoleBox output only - Phase 106 scope: output redirection (FileBox/NetworkBox) - Reference examples for documentation (execution testing Phase 106+) This completes the structured logging framework design, building on Phase 99 (logging policy), Phase 100-101 (Rust logging), Phase 104 (.hako patterns), and Phase 105.5 (console macro unification).
This commit is contained in:
@ -324,8 +324,30 @@ box RequestHandler {
|
||||
- [ ] テストコード内の println! は許容
|
||||
- [ ] 本番環境での不要なログを削除した
|
||||
|
||||
## Phase 105: Logger Box Framework Integration
|
||||
|
||||
Phase 105 で Logger Box フレームワークが導入され、以下のパターンが正式化されました:
|
||||
|
||||
- **LightweightLoggerBox**: メッセージのみの単純ロギング
|
||||
- **StructuredLoggerBox**: DEBUG/INFO/WARN/ERROR レベル付きロギング
|
||||
- **ContextualLoggerBox**: context(request ID等)付きロギング
|
||||
|
||||
詳細な設計と実装例は [Logger Box Design](logger_box_design.md) を参照してください。
|
||||
|
||||
### Integration with Phase 104 Categories
|
||||
|
||||
Logger Box は以下のカテゴリに対応:
|
||||
|
||||
| Phase 104 Category | Logger Box Pattern | Use Case |
|
||||
|-------------------|-------------------|----------|
|
||||
| user-facing | Direct ConsoleBox (no Logger Box needed) | 単純なユーザーメッセージ |
|
||||
| dev-debug | StructuredLogger (DEBUG level) | デバッグ出力 |
|
||||
| monitoring | StructuredLogger (INFO level) | 監視情報 |
|
||||
| internal Rust | Ring0.log | Rust側の内部ログ |
|
||||
|
||||
## 関連ドキュメント
|
||||
|
||||
- [logger_box_design.md](logger_box_design.md) - Phase 105 Logger Box フレームワーク
|
||||
- [logging_policy.md](logging_policy.md) - Rust/Ring0.log側方針
|
||||
- [ring0-inventory.md](ring0-inventory.md) - println!分類在庫
|
||||
- [core_optional_design.md](core_optional_design.md) - Optional化設計
|
||||
|
||||
Reference in New Issue
Block a user