iop/agent-ui/definition/components/endpoint-card/index.md
toki bebd95f909 docs(agent-ui): legacy 상태값을 보정한다
validate-agent-ui 규칙이 요구하는 상태값 스키마에 맞춰 기존 code-first agent-ui 문서의 legacy 상태 표기를 정규화한다.
2026-06-25 10:54:05 +09:00

66 lines
1.6 KiB
Markdown

---
ui_doc_type: component
component_id: endpoint-card
status: 구현됨
source_evidence:
- type: code
path: packages/flutter/iop_console/lib/src/iop_console_overview.dart
notes: _buildEndpointCard renders endpoint/auth reference rows.
- type: docs
path: apps/client/README.md
notes: Client HTTP and WebSocket URLs are provided with dart-define values.
- type: user
path: null
notes: Initial scaffold requested by user.
---
# Endpoint Card
Component ID: `endpoint-card`
Status: `구현됨`
## Source Evidence
| Type | Path | Notes |
|------|------|-------|
| code | `packages/flutter/iop_console/lib/src/iop_console_overview.dart` | `_buildEndpointCard`가 title, url/reference, icon을 가진 card를 렌더링한다. |
| docs | `apps/client/README.md` | `IOP_CONTROL_PLANE_HTTP_URL`, `IOP_CONTROL_PLANE_WIRE_URL` 설정을 설명한다. |
| user | 없음 | 초기 agent-ui 생성을 요청했다. |
## Purpose
운영 endpoint나 auth reference를 label과 monospace value로 읽기 쉽게 보여준다.
## Used By
- `overview`: `overview.endpoints`, `overview.auth`
## Anatomy
- leading icon block
- title
- monospace endpoint/reference value
## Variants
- http endpoint
- websocket endpoint
- auth token reference
## States
- default
- loading: 없음
- empty: fallback text 사용
- error: 없음
- disabled: 없음
## Rules
- secret 원문은 표시하지 않고 reference만 표시한다.
- 긴 endpoint 값은 한 줄 ellipsis로 처리한다.
## Decision History
- 2026-06-25: overview endpoint card helper를 component로 정의했다.