Skip to content
Historical revision — this record as it stood on 14 June 2026, not the current version. View the current record →

Three-ring architecture

Before a regulated organization buys an AI platform, it has to answer one question: can AI silently touch the authoritative record? On most platforms the answer is procedural — a policy, a configuration flag. A flag can be flipped, and a policy is only as strong as its enforcement.

PointSav answers the question architecturally. The Three-Ring Architecture organises every service into one of three concentric rings with strict one-way dependencies; the two inner rings — boundary ingest and deterministic processing — function fully without the outer AI ring.

Rings 1 and 2 contain no import, no dependency, and no runtime call that reaches Ring 3. A deployment can exclude Ring 3 entirely; where Ring 3 is included, it is a read-only consumer that produces proposals, never record writes.

For a regulated buyer the verification is structural rather than procedural. A deployment without Ring 3 has no AI to audit; a deployment with it keeps the deterministic core as the sole authoritative record. This article covers the ring layout, the service taxonomy, the multi-tenant isolation model, and why AI is optional by construction.

Ring layout

 Ring 3 — Optional Intelligence
 service-slm + GPU burst orchestrator
 + Tier C external API integration
 ↓ queries (read-only)
 Ring 2 — Knowledge and Processing
 service-content + service-extraction
 + service-search + service-egress
 ↑ feeds ↓ writes
 Ring 1 — Boundary Ingest (per-tenant)
 service-fs + service-people
 + service-email + service-input
 (data flows in; per-tenant; MCP servers)
Ring 1 produces raw data and depends on nothing else. Ring 2 reads from Ring 1, writes structured records, and depends only on Ring 1. Ring 3 reads from Ring 2 and never writes to it.

Service taxonomy

Ring Service Purpose Required at all tiers?
1 service-fs Immutable Ledger (WORM append-only) Required
1 service-people Identity Ledger Optional
1 service-email Communications Ledger Optional
1 service-input Generic document ingestion Optional
2 service-extraction Deterministic parser; structured data never routes through Ring 3 Required
2 service-content Taxonomy Ledger and knowledge graph Required
2 service-search Search index Required
2 service-egress Physical release valve Required for output
3 service-slm AI Gateway — the Doorman Optional
3 GPU burst orchestrator Ephemeral multi-cloud burst (Yo-Yo) Optional

Ring 1 — Boundary Ingest

Ring 1 is the per-tenant data boundary. Each service accepts raw data from one external source — the filesystem, an email inbox, a document upload, an identity provider — and writes it to a durable ledger. No Ring 1 data is transformed or classified; it is only stored.

Every Ring 1 service implements a [Model Context Protocol](/wiki/mcp-substrate-protocol) server interface, and Ring 2 talks to Ring 1 as an MCP client. A customer who needs a new data source adds another MCP server without modifying any existing service.

Because Ring 1 is per-tenant, each tenant's data lives in a separate service instance with its own storage root. There is no shared state between tenants at this ring.

Ring 2 — Knowledge and Processing

Ring 2 reads from Ring 1 and produces structured knowledge: parsed records, knowledge graphs, classified entities, search indexes. All Ring 2 processing is deterministic, and a binding architecture decision prohibits AI from writing to the knowledge graph or the structured record stores. Ring 2 output is reproducible: the same Ring 1 input replays to the same result.

An audit that questions a classification can replay the deterministic parse against the unchanged Ring 1 ledger and get the same answer. No AI variance enters the authoritative record. Ring 2 services are multi-tenant by moduleId: one process serves all tenants, and each tenant's knowledge graph and search index are isolated behind a moduleId namespace.

Ring 3 — Optional Intelligence

Ring 3 is a single read-only consumer of Ring 2. It never writes to the knowledge graph, the ledger, or the structured record stores; its only outputs are proposals — text the operator reviews, drafts the operator approves. Every accepted output enters the record through a Ring 2 write path with a human at the checkpoint.

service-slm is the single Ring 3 service. It implements the Doorman pattern: every request enters through one boundary, which sanitises outbound data, routes among the three compute tiers, and logs every call to the per-tenant audit ledger. No API key lives outside the Doorman boundary.

The three compute tiers available to Ring 3:

  • Tier A — local. A 7B-class model on the customer's own hardware. Zero marginal cost, full data locality. The default for most requests.
  • Tier B — GPU burst. A larger model on a short-lived GPU instance (Yo-Yo), used when Tier A cannot handle the request shape efficiently. The customer controls when it starts and stops.
  • Tier C — external API. External vendor APIs, used only with an explicit per-request allowlist. Every call is logged at the customer's audit ledger.

Multi-tenant isolation model

Tenant isolation varies by ring, by deliberate design.

  • Ring 1 — hard isolation by service instance. Each tenant's boundary ingest runs as a separate process with separate storage. No code path reaches from one tenant's Ring 1 data to another's.
  • Ring 2 — logical isolation by moduleId. One process, one set of indexes, strict namespace separation at every read and write. A query for tenant A cannot return tenant B's records.
  • Ring 3 — a single service-slm instance with per-moduleId adapter loading. The Doorman writes the moduleId into every audit-ledger entry.

Why AI is structurally optional

The three-ring pattern makes AI optional by construction, not by configuration. A deployment that excludes Ring 3 ships fewer processes, exposes less attack surface, and satisfies network-isolation requirements that prohibit external API calls.

For a deployment that includes Ring 3, the read-only constraint keeps the deterministic core as the authoritative record. An operator auditing AI involvement in any output inspects the audit-ledger entry for the Doorman call, compares the proposal against the Ring 2 record it drew from, and confirms that no AI path modified the underlying structured data.

See also

  • compounding-substrate — the five structural properties the Three-Ring Architecture implements
  • service-slm — the Ring 3 Doorman service that routes among compute tiers and logs every call
  • compounding-doorman — the operational pattern the Doorman implements and why it compounds over time
  • worm-ledger-architecture — the Ring 1 append-only ledger that underpins the audit guarantee
  • apprenticeship-substrate — how Ring 3 interactions generate training signal that improves the local model over time
  • architecture-decisions — the binding decisions that govern how rings interact and where AI is permitted
Important Information

Important Information

Corporate structure. PointSav Digital Systems ("PointSav") is a trade name of Woodfine Capital Projects Inc. ("Woodfine"). PointSav does not itself offer, sell, or solicit any security. Any securities offering associated with Woodfine's real-property direct-hold solutions is made exclusively by Woodfine, and only by means of the applicable Private Placement Memorandum.

No investment advice. This wiki's content is provided for engineering, operational, research, and development purposes. Nothing on this wiki constitutes investment advice or a solicitation to invest in any Woodfine partnership or direct-hold solution.

Intellectual property. The PointSav name, trade name, wordmark, and marks, together with all current and future PointSav- and Totebox-branded products, services, and offerings — and the software, source code, documentation, design system, and all related materials — are proprietary to Woodfine and its affiliates, except for components identified as open source. No rights are granted except as expressly set out in a written license or agreement. See TRADEMARK.md in this repository for the full trademark notice.

Open source components. Portions of the platform are made available under permissive open-source licenses identified in the accompanying repository. Use of those components is governed by their respective license terms.

No warranty; informational use. Content on this wiki is provided for general informational purposes only and does not constitute a representation, warranty, or commitment with respect to product functionality, availability, pricing, or roadmap. Some articles describe planned or intended features, capabilities, and milestones — language such as "planned," "intended," "targeted," "may," and "expected" marks this forward-looking content, which is subject to change and does not constitute a commitment regarding future performance.

Confidentiality. Where an article describes an operational or deployment detail that is not intended for public disclosure, that article is not published on this wiki. Content here is general-purpose engineering documentation, not customer-specific configuration.

Jurisdiction. Woodfine Capital Projects Inc. is organized in British Columbia, Canada. References to the Sovereign Data Foundation on this wiki describe a planned or intended initiative only, not a current equity holder or active governance body.

Changes to this notice. PointSav may update this notice from time to time; the version posted on this page governs.

Not a filing system. This wiki is not a securities filing system, an electronic disclosure repository, or a substitute for SEDAR+ or any other regulatory filing system. Formal securities filings are made through the applicable regulatory filing system, not through this wiki.

Full disclaimer. This notice supplements, and does not replace, the full Disclaimers article. In the event of any conflict, the full Disclaimers article governs.

Read the full disclaimer →