English · 한국어

pqcota-common¶

pqcota 플랫폼의 공유 계약과 공유 코드입니다.

단계를 건너는 모든 메시지의 단일 정보원(SSOT)인 protobuf 계약, 그 계약에서 생성한 Go 코드, 모든 단계가 함께 쓰는 어휘와 도우미 코드가 들어 있습니다. pqcota를 이루는 리포지터리 다섯 개 중 하나입니다. 다섯 개는 pqcota-common, pqcota-inventory, pqcota-discovery, pqcota-provisioning, 그리고 통합 리포지터리 pqcota(데모, 예제, 릴리스 번들, 기여 안내)입니다.

들어 있는 것¶

경로	내용
`contracts/`	protobuf 계약 `pqcota.{common,discovery,inventory,provisioning}.v1`입니다. contracts/README.ko.md와 data-model.ko.md부터 읽으세요
`gen/`	계약에서 생성한 Go 코드이며 커밋되어 있으므로 소비하는 쪽은 `go get`만 하면 됩니다
`pkg/kernel/`	공유 로직입니다: `registry`, `posture`, `scope`, `machineid`, `sign`, `completeness`
`pkg/org/`	스토어(store)를 조직 단위로 나누는 코드입니다
`cmd/`	`pqcota-keygen`입니다. 수집기 서명과 계획 승인이 모두 쓰는 ed25519 키 생성기입니다(cmd/README.ko.md)

의존하는 것¶

이 패밀리 안에는 없습니다. 다른 pqcota 모듈이 모두 이 모듈에 의존하므로, 이 모듈은 그중 어느 것도 import하지 않습니다.

빌드와 테스트¶

make            # every check of this repository
go test ./...   # unit tests only

make generate는 contracts/에서 gen/을 다시 생성합니다(buf, protoc-gen-go, protoc-gen-go-grpc가 필요하며, make tools가 두 플러그인을 설치합니다). make lint와 make breaking은 계약을 점검하고, make breaking은 가장 최근 릴리스 태그와 비교합니다.

pqcota-common에는 형제 의존성이 없으므로 go.mod에 replace 지시문이 없습니다. 나머지 네 리포지터리는 각자의 go.mod를 통해 ../pqcota-common에서 이 모듈을 읽으므로, 리포지터리를 나란히 클론하세요. 빌드 안내를 보세요.

기여 · 보안 · 라이선스¶

기여와 보안 신고 방법은 pqcota 리포지터리에 설명되어 있습니다.