Solar PV System — 지식 번들
Bundle OKF 0.2 · 5 conceitos · nalpari/solar-pv-system
Open source Repository Open in the app JSON
About
# Solar PV System — 지식 번들
Google Maps 위성영상 위에서 지붕 태양광 모듈 배치를 설계하는 단일 페이지 웹 앱의 OKF 번들.
코드를 읽어도 나오지 않는 것 — 도메인 규칙, 좌표계 규약, 외부 시스템 계약, 배포 전제, "왜 이렇게 했는가" — 를 개념 단위로 기록한다.
# 하위 디렉터리
* [system](system/index.md) - 시스템 개요·배포·설정·보안 경계.
* [domain](domain/index.md) - 지붕면·처마·경사(寸)·배치 규칙 등 이 도메인에서만 통하는 개념.
* [modules](modules/index.md) - 코드 모듈과 각자의 책임·불변식.
* [interfaces](interfaces/index.md) - HTTP 엔드포인트 계약.
* [workflows](workflows/index.md) - 사용자 작업 흐름과 상태 전이.
# 번들 규약
* `resource` 와 `sources[].resource` 의 경로는 **저장소 루트 기준 상대 경로**(`src/...`, `docs/...`)다.
`/` 로 시작하는 경로는 번들 내부 문서를 가리킨다(`/domain/roof-face.md`).
* 코드가 SSOT 인 값(상수·zod 스키마·매핑 테이블)은 여기서 재정의하지 않고 **위치를 가리킨다**.
값을 옮겨 적은 곳은 반드시 `sources` 로 출처를 남긴다 — 코드가 바뀌면 이 문서가 틀린다는 뜻이다.
* 신뢰 등급(OKF §5.3): `verified` 없음 → **unverified**, 비인간 actor 만 → **machine-confirmed**,
`human:<id>` 포함 → **human-reviewed**. 현재 `system/deployment.md` 만 machine-confirmed 이고 나머지는 unverified 다.
사람이 검토했다면 `verified: { by: human:<id>, at: <ISO8601> }` 를 추가할 것 — 등급이 오르고
Details
- Kind
- OKF bundles
- Topic
- Cloud & DevOps
- Publisher
- nalpari
- Origin
- okf_github
- Category
- dados
- Version
- 0.2
- Added
- 2026-09-09 12:03:57
- Updated
- 2026-09-09 12:03:57
- Origin id
nalpari/solar-pv-system:docs/okf/index.md