01-policy

devian/10-module Policy

Status: ACTIVE AppliesTo: v10 SSOT: skills/devian/10-module/03-ssot/SKILL.md

Scope

This folder contains core documents:

• SSOT (Single Source of Truth) and policy definitions
• Skill specification and naming conventions
• Core runtime and serialization rules
• Network infrastructure (WebSocket, HTTP RPC, Server)
• Generated code integration rules

These documents define the foundational policies that all other skill groups reference.

---

Runtime Layers (정책)

Devian 런타임은 세 계층으로 나눈다. 모든 계층이 namespace Devian 단일을 사용한다.

1. Core (빌드/공용 유틸 레이어) — namespace: Devian

   • 도메인/프로토콜 생성물이 공통으로 의존할 수 있는 최소 유틸

2. Proto (인코딩/디코딩 레이어) — namespace: Devian

   • Protobuf 스타일의 wire encoding/decoding 및 DFF 파서 제공
   • ".proto/protoc 체인"을 전제하지 않는다 (v10은 IDL이 JSON 기반)

3. Net (전송 레이어) — namespace: Devian

   • Transport 어댑터가 구현해야 하는 계약(Contract)
   • WebSocket/TCP/UDP 등 구체 구현은 Consumer 책임

분리 네임스페이스 금지: 런타임 코드에서 분리된 하위 네임스페이스 사용 금지. 파일 폴더 구조(Core/, Proto/, Net/)는 유지하되 namespace는 모두 Devian이다.

---

Framework Modules (단일 모듈 구조)

C# — 단일 모듈

경로	namespace	역할
framework-cs/module/Devian/src/Core/	Devian	IEntity, ITableContainer, LoadMode 등
framework-cs/module/Devian/src/Proto/	Devian	Dff 파서, Protobuf 직렬화
framework-cs/module/Devian/src/Net/	Devian	INetPacketSender, NetPacketEnvelope 등

TypeScript — 단일 패키지

경로	역할
framework-ts/module/devian/src/	IEntity, ITableContainer, ICodec, LoadMode
framework-ts/module/devian/src/proto/	DffConverter, ProtobufCodec, IProtoEntity
framework-ts/module/devian/src/net/	NetworkClient, NetworkServer, WsTransport

---

Dependency Rules

Hard Rules (MUST)

1. 생성물(framework/**/generated)은 Core/Proto/Net 중 필요한 레이어에만 의존한다.
2. Net은 "전송"만 다룬다. 프로토콜/도메인 타입을 직접 알지 않는다.
3. Proto는 "표현/파싱"만 다룬다. Net을 참조하지 않는다.

Soft Rules (SHOULD)

• 런타임 API는 Span/ReadOnlySpan 기반을 선호한다(불필요한 ToArray/MemoryStream 방지).

---

Generated ↔ Runtime 경계

• Generated 코드는 런타임 계약을 소비(consuming)하는 쪽이다.
• 런타임 계약의 정답(타입/시그니처)은 런타임/제너레이터 코드에서 확인한다.

---

Related Groups

Group	Policy
devian	skills/devian/SKILL.md — 공통 인덱스, 용어, workspace
tools	skills/devian/80-tools/01-policy/SKILL.md
data	skills/devian/80-tools/11-builder/01-policy/SKILL.md
protocol	skills/devian/80-tools/11-builder/01-policy/SKILL.md
unity	skills/devian-unity/01-policy/SKILL.md

---

See Also

• SSOT
• 동작 정본: 런타임/제너레이터 코드