Kontinuum Node — документация
Серверный узел распределённой P2P-сети Kontinuum. Удерживает global DHT, хостит пользовательский контент (E2E-зашифрованный) и предоставляет NAT-traversal, mailbox и rendezvous-сервисы для клиентов
kontinuum-app.
Код узла живёт в submodule kontinuum-node (на уровне корня проекта). Здесь — спецификация и проектные документы; репозиторий кода содержит только thin overview + workspace layout.
Структура спецификации (v0.6)
Спецификация разбита по audience. Section codes (§1, §3, §5, ...) одинаковые во всех документах и соответствуют единой v0.6 спеке.
| Документ | Что внутри | Для кого |
|---|---|---|
architecture.md | §1 Назначение · §2 Глоссарий · §3 Tier'ы и capabilities · §4 Топология · §17 Workspace · §18 Масштабируемость · §19 Open questions · Roadmap | Все — start here |
protocols.md | §5 Модель DHT · §10 Mailbox (structure + GC + TTL) · §11 Inter-node протокол | Node developers |
app-integration.md | §6 Identity / bootstrap / pairing / recovery · §7.3 family-mode UX · §9.5 user pins UX · §10.5 free-tier warnings · §13 PRO model · §14 Migrations · §15.2 self-hosted control | App developers (kontinuum-app integration) |
operations.md | §7 Storage layer (rustfs, Virtual Pool) · §9 Replication & geo · §12 Cert lifecycle · §15.1 org-side admin · §16 Threat model · §16.1 DR plan | DevOps · SRE · Security review |
pricing.md | §8 Модель тарификации (fixed + pay-as-you-go + cost-plus draft) | Billing team · Business stakeholders |
implementation-notes.md | §20 Известные edge-cases и derived противоречия из v0.5; resolved во время написания кода | Node developers (начинающие имплементацию) |
testing.md | Testing strategy: 9-layer pyramid (unit → property → integration → simulation → fuzzing → E2E → chaos); per-component coverage; CI/CD pipeline; priorities; coverage edge-cases из implementation-notes | Node developers · QA · CI/CD setup |
db-schemas.md | P0 — SQLite schemas (server + admin DB), migrations framework, encryption at rest, retention policies, capacity planning. Prerequisite перед началом persistence-layer кодинга | Node developers (начинающие persistence layer) |
configuration.md | P0 — TOML schema для node.toml + admin.toml, env-vars override, secrets management, per-environment configs, validation rules, hot-reload policy, CLI flags | Node developers · Ops · Operator onboarding |
bootstrap.md | P0 — Tier 0 key ceremony (v0.1 single-key, v1.0 3-of-5 multi-sig), hardcoded pubkey list location, node bootstrap flows per tier, genesis network formation, Tier 0 operational procedures | Kontinuum.org operators · Node developers · Partner onboarding |
wire-types.md | P0 — CBOR encoding rules (canonical RFC 8949), formal schemas всех frame types, schema evolution policy, version negotiation, golden test vectors, Rust↔CBOR mapping | Node developers · Future native-client implementers |
api-contracts.md | P1 — HTTP/JSON API contracts для admin REST, S3-gateway, billing webhooks, Tier 0 RPC; auth schemes; error codes; rate limits; app integration contract | Node developers · App developers · Billing team · Tier 0 operators |
observability.md | P1 — full metrics inventory (всё kontinuum_node_*), log conventions (privacy в logs), tracing spans, alerts (info/warn/critical), Grafana dashboards layout, SLO definitions | SRE · DevOps · Node developers |
deployment.md | P1 — build process (reproducible, musl static), Docker images (distroless), Kubernetes (StatefulSet + Helm), systemd, hardware requirements per tier, network ports / firewall, zero-downtime updates, rollback, CI/CD, backup | SRE · DevOps · Partner operators · Self-hosted PRO users |
design-prompts/ | Brief'ы для design-агентов (UX brief: external S3 attachments, etc.) | UX designers · External design contractors |
Статус
v0.6 (2026-05-18) — pre-implementation freeze approaching. Большинство architectural решений зафиксированы; остающиеся open questions (§19) — implementation-level или v2.0 milestones.
Полная история версий — в architecture.md.
Связанные документы
docs/internals/— client-side angle (какkontinuum-appиспользует DHT / discovery / p2p).docs/managers/sharing.md— sharing manager вkontinuum-app(взаимодействует с node mailbox).docs/billing/— биллинговая инфраструктура (Kontinuum Org процессинг).docs/internals/architecture-decisions.md— высокоуровневые ADR'ы проекта.
Phase 2 reorg notes
Это документация в Phase 2 структуре: разбита по audience из originally-single specification.md. Section codes (§N.X) сохранены от единой v0.6 спеки — cross-references идут по этим кодам, не по pathfile'у.
При апдейте — apply правки только в один из split files (тот где живёт секция). README index обновляется только если меняется high-level structure.