# WIA-CITY-003 — Smart Building

> 스마트 빌딩 표준 — 건물 자동화 · BAS · BMS · BACnet · 에너지 관리

## Scope

This standard documents the WIA Standards canonical envelope shape,
API surface, protocol exchanges, and ecosystem integration for
smart building hosts that need to interoperate across
jurisdictions, vendors, and operational contexts. The standard
composes with the wider WIA Standards family to inherit cross-
standard composition, audit transport, and federation handshakes
without per-standard re-implementation.

## Normative references

- ASHRAE 90.1-2022 (Energy Standard for Buildings)
- ASHRAE 189.1-2020 (High-Performance Green Buildings)
- LEED v4.1 (USGBC)
- BREEAM v6.1 (BRE Global)
- ISO 16484-2 BACnet
- ISO 16484-5 BACnet/IP
- IEC 61850-7-420 (DER comm)
- ISO 50001:2018 (EnMS)
- WELL v2 (IWBI)
- Fitwel v3.0

## Phase organisation

The standard is published in four Phase files:

- `spec/PHASE-1-DATA-FORMAT.md` (or PHASE-1-FOUNDATION.md) — wire-format envelopes
- `spec/PHASE-2-API.md` (or PHASE-2-DATA.md) — REST + JSON-RPC surface
- `spec/PHASE-3-PROTOCOL.md` — protocol exchanges and federation
- `spec/PHASE-4-INTEGRATION.md` — ecosystem composition and compliance

## eBook companion

A learner-focused 8-chapter eBook is published in both Korean and
English at `ebook/ko/` and `ebook/en/`:

1. BACnet Foundations
2. Building Automation Architecture
3. HVAC Sequences and Control
4. Energy Management ISO 50001
5. LEED v4.1 Operations Pathway
6. Indoor Environmental Quality
7. BACnet Cybersecurity ISO/IEC 27001
8. Net-Zero and Grid-Interactive Pathways

## CLI

A POSIX shell helper is published at `cli/smart-building.sh`. The helper ships
sample envelope generators with no dependencies beyond `jq` and POSIX
shell so integrators can exercise the contract before wiring real
backends.

## Reference simulator

A browser-based reference simulator is published at `simulator/index.html`.
The simulator surfaces every Phase 1 envelope and walks every Phase 2
endpoint exchange so adopters can study the contract behaviour before
integrating with a real backend.

## Conformance

A standard is conformant when:

1. Every Phase 1 envelope it emits validates against the published
   JSON Schema for that envelope class
2. Every Phase 2 endpoint it exposes honours the documented status
   codes, content shapes, and error envelopes
3. Every Phase 3 protocol exchange it participates in honours the
   handshake order, signature requirements, and audit hook contract
4. Phase 4 ecosystem composition reaches the required cross-standard
   capabilities (audit transport, identity, federation) per the
   Phase 4 §4 capability matrix

## Governance

Maintained under the WIA Standards public-benefit governance model.
See `https://wiastandards.com/governance/` for committee composition,
voting rules, and the per-standard release calendar.

弘益人間 — Benefit All Humanity.