---
title: Obsidian Frontmatter 스키마
updated: 2026-04-13
tags: [dev, obsidian, schema, convention]
---

## 목적

[[infra-hosts|인프라 호스트]]나 [[outline|서비스]] 등 정본 문서에 **Bases/Dataview로 쿼리 가능한 구조화된 필드**를 추가해서 빠른 조회·필터링이 가능하게 한다. 기존 본문(prose)과 공존.

- Obsidian **Bases** (core plugin, 2026년 정식) 기본 사용
- 필요 시 Dataview 플러그인 추가 (커뮤니티, DQL 쿼리)

## 공통 필드

모든 문서 공통:

| 필드 | 타입 | 필수 | 설명 |
|------|------|------|------|
| `title` | string | ✅ | 문서 제목 (파일명과 별개) |
| `updated` | date (YYYY-MM-DD) | ✅ | 최근 업데이트. 변경 사유는 뒤에 자유 텍스트 |
| `tags` | array[string] | ✅ | 분류 태그. type 태그(`host`, `service`, `product`) 포함 권장 |

## Type별 필드

### `type: host` (서버/컨테이너/라우터/NAS)

```yaml
---
title: incus-hp2
updated: 2026-04-13
tags: [infra, host]
type: host
host_kind: server         # server | container | router | nas | vm
location: seoul           # seoul | tokyo | osaka | aws-kr | ...
provider: self-hosted     # self-hosted | linode | aws-lightsail | google-cloud | vultr
status: active            # active | maintenance | retired
ssh_host: incus-hp2       # ssh 단축 별칭 (tssh 포함)
public_ip: null           # 공인 IP (없으면 null)
tailscale_ip: 100.100.52.34
lan_ip: 192.168.9.134
os: Debian 13
cpu_model: Xeon E5-2670
cpu_cores: 32
ram_gb: 188
k3s_role: worker          # control-plane | worker | null
critical: true            # 다운 시 서비스 영향 큰지
monthly_cost_usd: 0       # 자체 운영 0, 클라우드는 실제 비용
---
```

### `type: service` (K3s 서비스, 외부 SaaS 등)

```yaml
---
title: Gitea
updated: 2026-04-13
tags: [service, devtools]
type: service
category: devtools        # devtools | observability | edge | storage | ai | messaging | ...
deployment: helm          # helm | kubectl | docker-compose | bare-metal | saas
cluster: k3s-seoul        # k3s-seoul | k3s-tokyo | null(외부) | saas
namespace: gitea          # K8s 네임스페이스
url: https://gitea.inouter.com
criticality: high         # high | medium | low
status: active
depends_on: [postgresql-ha, traefik, cert-manager]   # 내부 문서 슬러그
---
```

### `type: product` (사내 제품/서비스 브랜드)

```yaml
---
title: 아이언클래드
updated: 2026-04-13
tags: [product, anvil]
type: product
brand: ironclad
status: live              # live | beta | planning | retired
url: https://ironclad.it.com
owner: kaffa
---
```

### `type: reference` (외부 서비스/문서 레퍼런스)

```yaml
---
title: BunnyCDN
updated: 2026-04-13
tags: [services, cdn]
type: reference
category: cdn
vendor: Bunny.net
---
```

## 스키마 진화 규칙

- 필드는 **추가**만 자유롭게. 제거/이름 변경은 기존 파일도 같이 수정
- 모르는 값은 `null` 보다 필드 **생략** 선호 (Bases에서 자동 무시)
- 날짜는 ISO `YYYY-MM-DD` 고정
- 배열은 `[a, b, c]` 인라인, 5개 초과 시 블록 스타일
- 문자열에 콜론·대괄호 있으면 따옴표 필수

## 참고

- Bases 쿼리 예시: [[hosts|hosts.base]]
- Obsidian Bases 공식: https://help.obsidian.md/bases