8000 GitHub - kr0k/katas · GitHub
[go: up one dir, main page]

Skip to content
kr0kPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

17 Commits

Folders and files

Repository files navigation

Architectural Katas 2026: AI-Assisted Software Architecture — Von Digitalis Estates

Proposal for a modern, AI-assisted architecture that helps the 72nd Countess Von Digitalis turn a sprawling estate — 40 historic rides and 200+ exotic (and poisonous) animals — into a profitable, growing attraction, without going back to the garden gnome business.

Team: BONK · Submission: September 2026


Table of Contents


How to read this repository

Folder What is inside Start here if you are…
requirements/ Business goals, pain points, FRs, NFRs, assumptions, OKRs, risks, and the business case …checking whether we understood the problem, and whether it pays
hld/core/ The non-AI foundation: edge, connectivity, ticketing, event backbone, data, and the game days that verify it …checking whether the AI fits the rest of the system
hld/scenarios/ One folder per AI use case — eight of them: why, what, containers, diagram, validation …judging innovation and suitability
hld/ai-platform/ai-portfolio.md The whole AI inventory on one page: twenty-three applications, what each falls back to, and what is deliberately absent …asking "how much AI is in this, and why that AI"
hld/ai-platform/agents.md The four agents: their tools, their invariants, two worked attack chains, and what they cost …judging whether AI is really inside the business process
hld/ai-platform/ Inference gateway (adopted) and model governance: registry, evaluation, monitoring, risk classes, cost …judging how we handle uncertainty and verify AI
hld/architecture-evaluation.md Quality-attribute scenarios, the styles we rejected, sensitivity and trade-off points, risks and non-risks …asking how the characteristics were evaluated
adrs/ Architecture Decision Records with alternatives and trade-offs …looking for the "why" behind any choice
appendix/ The work the architecture rests on but does not consist of: business-case model, generative-cost model, daily-report specification, vendor ticketing rules, data-health runbooks, the AI incident runbook, LoRaWAN airtime …checking a number or a calculation
video/ Semi-final video (if we get there)

Every scenario links to its ADRs; every ADR links back to the requirements it serves. The traceability table is the shortcut. uv run scripts/lint_docs.py checks links, anchors, ids, traceability, duplicated prose and every number derived from the business-case model; uv run scripts/check_mermaid.py renders each diagram with mermaid's own parser. GitHub Actions runs both on every push.


The problem in one paragraph

The estate receives ~5,000 visitors/day and must reach 15,000/day within three years. Nobody knows which parts of the park are popular, so investment and staffing are guesswork. The animal collection is expensive to run — dramatically more so when animals get sick — and the jumping piranha population needs counting. Visitors rarely come back and the estate does not know why. Wi-Fi is patchy, cloud services are allowed, and there is a budget for MQTT-capable devices. Full statement: requirements/.


Why this pays back

The platform costs about 3% of today's revenue, and its savings alone never cover it. On the roadmap's own gates it pays back in years 4–7 — year 4 only if the platform is credited with 36% of the growth between year 2 and year 3, which the roadmap cannot deliver before Phase 3. It is a growth bet, sized accordingly, and conditional on the ticketing-vendor evaluation (TODOS.md): without a capacity API and an upgrade credit, the second growth lever becomes a desk process and the window moves right.

The estate's physical capacity binds before the software does: 15,000 a day is not feasible on the current car park and lunch seating, and those are the Countess's decisions before the first summer. The findings and what the architecture takes from them are in requirements/08; the arithmetic behind them, and how season 1 replaces its assumptions, is in the appendix model.


Our approach: how we used AI

AI sits inside the estate's working day, not beside it. It belongs to the keeper's morning round, the ops manager's opening plan, the vet's decision at the review queue, a family's afternoon and the Countess's 21:00 review — recurring decisions that already exist and are made badly today for want of information. Twenty-three AI applications across eight scenarios, inventoried on one page: the portfolio. Four agents put AI inside the multi-step part of those decisions: agents.

Embedded in a process is not embedded in the critical path. Every one of those decisions is still made with the AI switched off. Every read the platform offers is also a dashboard, every draft is also a form, every model alert has a rule standing behind it, and no agent is the only path to any action. That is the difference between AI in a business process and a business process that depends on AI — and it is why the degradation ladder is a design artefact rather than a disclaimer.

The order of work:

  1. Business first. The brief rewritten as goals, pain points and OKRs with current and target values, so every scenario points at a number it should move. The revenue arithmetic the portfolio is arranged against — attendance × spend per visitor-day × repeat rate — is in the portfolio's opening section.
  2. Foundation second. Patchy Wi-Fi is the dominant constraint, so the core architecture is edge-first: a local MQTT broker with store-and-forward, cellular/LoRaWAN backhaul, offline ticket validation, and a per-class channel choice for the enclosures none of those reach (ADR-0019). Everything that keeps people and animals safe works without the cloud.
  3. AI where the decision needs a judgement a rule cannot make. Each candidate answered: which OKR does it move, why is deterministic logic insufficient, how will we know it works, and what happens when it is wrong? Several failed and are rules today — live zone popularity is a counter, ticket validation is a signature, the staffing optimiser is a solver. Eight scenarios survived, and each capability inside them ships as a rule first and is promoted only if the model beats it (ADR-0023).
  4. Uncertainty and verification as architecture. An adopted inference gateway isolates us from any single provider; one governance loop covers every model, rented or owned; confidence bands derived from what an error costs (ADR-0016), evaluation gates and production monitoring are in ADR-0007, ADR-0008 and ADR-0005; and the controls a capability owes follow from its risk class (ADR-0017).

Four kinds of AI, treated differently: classical ML (forecasting, pricing, ride condition) is deterministic given its inputs and tested like software; computer vision produces probabilities and gets confidence bands and human review; generative AI is grounded, constrained and continuously evaluated; and an agent is an orchestrator over the other three, evaluated on task success and rolled back separately from the model it runs on.

Where AI sits in the working day

Six processes, each with an owner and a decision that already happens. The right-hand column is the test of the claim above: someone human commits, and the day survives the AI being gone.

Process Owner Where AI enters the decision Who commits, and what happens with the AI off
P1 · The morning welfare round Keeper, then the vet The round starts from a ranked list with the evidence behind each item rather than 55 equally likely enclosures; agent:animal assembles the animal's fortnight, the scale's health and the species protocol before the vet opens a treatment The vet confirms or dismisses with a reason code. Without AI the round runs in its usual order, and tier-0 rules and feed-scale thresholds still raise alerts
P2 · The opening and staffing plan Ops manager Tomorrow's footfall is forecast per zone; a deterministic optimiser turns it into a roster proposal; agent:ops-copilot drafts a one-zone change and what it costs The ops manager approves or edits. Without AI the heuristic — same weekday last week, adjusted for season — produces the plan
P3 · A family's day in the park The visiting family The companion builds the day around live queues, answers from the knowledge base, and re-plans when a ride closes; the token makes entry and payment a tap The family chooses; staff take over on escalation. Without AI the cached itinerary, the printed map and the info point
P4 · The 21:00 review, the commercial call, the quarterly capital question The Countess and management Figures inserted verbatim into the daily report and its wording drafted around them; quiet-day price proposals from the elasticity model; agent:management answers the follow-up over defined metrics; quarterly, each investment gets a causal estimate with its interval The ops manager approves the wording; management approves any price outside guardrails. Without AI the report goes out from its template with the same figures and prices stay fixed
P5 · The weekly content slot and the visitor's voice Curator, guest team Highlight candidates found in activity features already computed for welfare; a caption drafted around a verbatim species fact; the week's free-text feedback clustered into named themes with quotes The curator publishes or discards — there is no automated publish path. Without AI the curator scans the week's clips and the guest team reads the sentences, which is today
P6 · The census, the stock take and the inspection round Keeper; certified engineer Edge counting maintains a population estimate between censuses as an interval; ride condition flags a machine for inspection with its traces The keeper's count is the census of record; the engineer decides every ride. Without AI the manual count and the statutory schedule, which is the whole safety regime either way

Architecture at a glance

flowchart TB
    subgraph Estate["🏰 Estate (patchy Wi-Fi)"]
        direction TB
        Gates["Entry gates<br/>(QR/NFC + token, offline-capable)"]
        Foot["Footfall & queue sensors<br/>(anonymous counters — the instrument of record)"]
        TokRd["Token readers<br/>(rides, outlets, zone boundaries)"]
        Cams["Enclosure cameras<br/>+ feed scales, water sensors"]
        RideS["Ride condition sensors<br/>(non-invasive)"]
        EdgeAI["Edge inference nodes<br/>(piranha counting, anomaly pre-filter, highlight candidates)"]
        Broker["Local MQTT broker<br/>store-and-forward"]
        Gates & Foot & TokRd & Cams & RideS & EdgeAI --> Broker
        Remote["Remote enclosures<br/>bridge · pickup · cellular"]
        Remote --> Broker
    end

    Broker -- "cellular / LoRaWAN backhaul<br/>(buffered, at-least-once)" --> Ingest

    subgraph Cloud["☁️ Cloud"]
        direction TB
        Ingest["Ingestion gateway"]
        Bus["Event backbone"]
        Ingest --> Bus
        subgraph Domains["Business monolith — one deployable, four modules"]
            Tix["Ticketing & Access<br/>(adapter to ticketing platform & POS)"]
            Ops["Park Operations & Analytics<br/>+ Estate daily report"]
            Welfare["Animal Welfare"]
            Guest["Guest Engagement"]
        end
        Bus --> Tix & Ops & Welfare & Guest
        AICons["AI consumers & batch workers<br/>(own models: scoring, forecasts)"]
        Bus --> AICons
        Data["Data platform<br/>(raw → curated → features → metric layer & estate twin)"]
        Bus --> Data
        subgraph AIP["AI platform"]
            GW["Inference gateway"]
            Reg["Model governance:<br/>registry · evals · monitoring · risk class"]
            Agents["🤖 Four agents on typed tools<br/>(propose only — a human commits)"]
        end
        Ops & Welfare & Guest --> GW
        Agents --> GW
        Data --> Agents
        Agents -. "drafts into approvals that already exist" .-> Ops & Welfare & Guest
        AICons -. "governed" .-> Reg
        GW --> Providers["LLM / vision providers<br/>(interchangeable)"]
    end

    TixSaaS(["Ticketing platform<br/>(SaaS, adopted)"])
    POS(["POS / commerce<br/>(vendor's or separate)"])
    Tix <--> TixSaaS
    POS -. "purchases" .-> Tix
    Visitors["👨‍👩‍👧 Visitors<br/>(web & mobile)"] --> TixSaaS & Guest
    Staff["👩‍⚕️ Vet & ops staff<br/>(dashboards, review queue)"] --> Welfare & Ops
    Countess["👑 Countess<br/>(daily report, 21:00)"] --> Ops
Loading

Notation follows the HLD legend. This overview does not distinguish synchronous from asynchronous calls; the detailed views in hld/ do.


Key architectural decisions

Twenty-five records stand behind the proposal and the index is the way in, but ten of them carry the shape of the system. Each row states what was chosen and what we accepted in exchange; the record holds the alternatives and the consequences.

Decision What we accepted in exchange Record
Edge-first with store-and-forward. Patchy Wi-Fi is the dominant constraint, so safety rules and gate validation execute on the estate and the cloud is an eventual consumer of what they produce Logic in two places, and a signed downlink to keep the estate copy current ADR-0001, ADR-0011
A channel per traffic class per remote site, chosen by measured coverage. Cellular where it reaches, a radio bridge where it does not, delay-tolerant pickup only for clips at a thin-link site with no line of sight Up to three delivery modes to operate, and a channel mix that stays an assumption until the Phase 0 survey ADR-0019, ADR-0020
Adopt the ticketing platform; build only what is specific to this estate. Offline validation, passes and PCI scope are a product requirement rather than a backlog A vendor on the critical path, and a payback window that moves if the capacity API and the upgrade credit are not on the market ADR-0012
One event backbone; four bounded contexts in a single deployable. Ticketing, operations, welfare and guest engagement keep their boundaries in the code and share a release Module discipline has to be enforced by review, because the runtime does not enforce it ADR-0004, ADR-0003
No business service names a model or a provider. A service asks for a capability; a resolver maps it to a versioned bundle behind an adopted inference gateway One more hop on every generative call, and a gateway to run ADR-0005, ADR-0006
Rules first, model second. A capability ships as a rule, and its model is promoted only where it beats that rule on the capability's own metric Slower arrival for the models, and rules to maintain after promotion — which is also why every fallback is a path that has already run in production ADR-0023
What an error costs sets the confidence band; the risk class sets the controls. Bands are derived fr 8000 om the cost of being wrong, and a capability owes evidence in proportion to its class Two classification exercises per capability, kept honest by review rather than by a tool ADR-0016, ADR-0007, ADR-0017
Agents propose and a human commits. Typed least-privilege tools, effectful calls as commands into the owning context, step and token budgets, and the agent versioned apart from the model it runs on Approval steps stay in the working day, and the agentic layer never becomes the fast path ADR-0013, ADR-0014
Anonymous counters are the instrument of record, and the visitor token is opt-in. No faces, no device tracking, no re-identification across seasons Path data covers only the households that carry a token, so its carry rate is published beside every figure it produces ADR-0009, ADR-0018
One metric layer defines every number once. The daily report, the dashboards and agent:management compute nothing of their own A definition change is a reviewed change, and an agent that cannot resolve a question to a named metric refuses rather than improvising a query ADR-0015

Delivery roadmap: what we build when, and what we buy

Eight AI scenarios, twenty-three applications, four agents, two radio technologies and an edge tier are a lot for ≤ 5 engineers (NFR-OPS-1, R9, R25), so the scope is sequenced rather than cut: each phase has an entry gate, no model is promoted before the data it needs exists (A6, R7), the agents arrive two at a time, and four capabilities carry a kill gate.

Phase Enter when Foundation delivered AI delivered Verified by
0 · Foundation Day 1 Edge tier: MQTT broker, LoRaWAN gateway, gate readers, tier-0 safety rules, staff devices. Ticketing platform adopted and integrated (ADR-0012). Visitor token issued at the gate as a second credential form factor (FR-1.8). Site survey settles the remote-site channel mix (A17). Event backbone, business monolith skeleton, data platform, GitOps. None. Data capture only — every sensor, gate and token tap produces events from day one. Game days: uplink loss, broker failover, gate offline, revocation after outage, safety alert to a human → resilience validation
1 · Data & rules Phase 0 in production Anonymous counters in every zone (OKR 2.1). Feature store and the metric layer (ADR-0015). Inference gateway and thin model governance. Spend ingestion (PurchaseRecorded, FR-2.6) after 14 days in shadow. Estate daily report as a template (FR-2.7). Ride sensors fitted where the heritage assessment allows, feeding threshold rules only (A19). S1 feeding-by-scale and plant-house climate: rules + tabular anomaly. S3 live occupancy dashboard (no ML). S4 FAQ answers: small model via the gateway, grounded on the knowledge base. S8 condition rules on each ride's run-in baseline. Thresholds table live; golden sets started by domain owners; heuristic staffing rules in place (R7); 7 consecutive green spend reconciliations; OKR 1.6 baseline at month 12
2 · Models on accumulated data ≥ 1 season of footfall and welfare data (A6, R7) Edge compute sized N+1; visitor-masking gate. Token path weighting validated against counter totals (A16). requirements/08 re-issued with season-1 measured values. S1 per-enclosure activity anomalies, then camera features in shadow. S3 footfall forecasting + staffing optimiser (must beat the heuristic). S4 day planning with streaming answers. S6 agent:ops-copilot and the agent:companion tool turn. S7 feedback themes. Daily report phrasing via the S1 drafter, after the numeric-fidelity eval. Backtests vs. heuristic baseline; 2-week shadow runs; MAPE gate; GD-17 and GD-18 before either agent carries a drafting tool
3 · Optimisation Phase 2 live + 1 year of sales and footfall — S2 piranha counting against a census of record. S5 demand-aware pricing as a year-1 randomised quiet-day experiment. S4 return-visit nudges, the pass-upgrade prompt and personalisation for token holders. S1 per-animal vision for solitary or tagged animals, and the plant feeding detector. S6 agent:animal, agent:management and investment effect estimation. S7 highlight mining and caption drafts. S8 the condition model, if it beats its rule. Census comparison; A/B by date cohort; nudge control cohort; the four kill gates in the portfolio
4+ · Research Open questions in TODOS.md — Per-animal re-identification in group enclosures; the five preconditions for vehicle autonomy reviewed yearly (ADR-0020 §4). Spikes with entry thresholds

Build vs. adopt. The team builds what is specific to this estate and adopts the commodities:

Component Build or adopt Why
Ticketing, family passes, checkout, offline gate validation Adopt an attraction-ticketing platform → ADR-0012 Commodity with hard edge cases (PCI, refunds, fraud); ADR-0011 becomes our selection criteria
Event backbone, databases, object storage, IoT ingestion, model hosting Adopt managed cloud services → ADR-0003 Nobody on a team of five should run Kafka at 2 a.m.
Inference gateway (routing, budgets, fallback, tracing) Adopt an OSS LLM gateway → ADR-0005 Solved problem; our routing and budget config is declarative and portable
Open-weight fallback model Adopt managed hosting of open weights → ADR-0005 Provider independence without a GPU fleet (R9)
Model governance: registry, evaluation gate, monitoring Build thin, on managed MLOps primitives → ADR-0008 Golden sets and thresholds are ours; the plumbing is not
Edge tier: broker, LoRaWAN server, tier-0 rules, gate adapters Configure OSS, build small glue → ADR-0001 Off-the-shelf components; the estate-specific part is the rules and the wiring
Business logic of the four contexts Build as a modular monolith → ADR-0004 This is the estate's domain
Own models: welfare vision and anomaly scoring, piranha counting, footfall forecast, price elasticity Build → ADR-0006 No API knows what a lethargic cassowary looks like

Each scenario README states its phase; the phases in hld/ are summarised in hld/README.md.


Requirements

High Level Design

AI scenarios

# Scenario AI type Moves OKR Human in the loop?
S1 Animal welfare monitoring (reference) CV + anomaly detection, per animal or per enclosure 3.1, 3.2, 3.3 Yes — veterinarian decides
S2 Piranha population counting Edge CV 3.4 Census of record at tank maintenance; monthly visual sanity check
S3 Visitor flow forecasting & staffing Classical ML 2.1, 2.2, 2.3 Ops manager approves rosters
S4 Guest companion Grounded LLM 1.2, 1.3, 1.6, 2.2 Escalation to staff
S5 Dynamic family passes Classical ML + rules 1.5, 1.1, 1.4 Pricing guardrails set by Countess
S6 Operations copilot and ask-the-estate Agents on typed tools + classical 2.3, 2.4, 2.6, 3.1, 5.4 Yes — every agent output is a proposal into an approval that already existed
S7 Content drafting and visitor voice Edge CV + generative + clustering 1.7, 1.4, 1.2 Yes — the curator publishes or discards; there is no automated publish path
S8 Ride condition monitoring Classical ML 2.5, 2.2 Yes — a certified engineer decides every flag, and AI never clears a ride

The whole inventory behind these eight — twenty-three applications, their fallbacks, what was deliberately left out and where each can be killed: the AI portfolio.

Architecture Decision Records

Twenty-five, with alternatives and trade-offs. The ten that carry the shape of the system are listed above under key architectural decisions; the index with status is adrs/README.md.


Traceability: capability → requirement → decision

Business capability FR HLD ADRs
Core
Buy tickets & family passes online and on site FR-1.x Core ADR-0012, ADR-0004
Validate entry with patchy connectivity FR-1.4 Edge ADR-0011, ADR-0012, ADR-0001
Collect telemetry from park & enclosures FR-2.1, FR-3.1 Edge ADR-0001, ADR-0002
Store and analyse estate data FR-2.x Core → Data ADR-0003, ADR-0004
Record on-site spend and report the day to the Countess FR-2.6, FR-2.7 Core → Estate daily report ADR-0012, ADR-0004, ADR-0010
AI-enabled
Detect animal health & feeding anomalies, and monitor the plant collection on the same pipeline FR-3.2, FR-3.3, FR-3.8 S1 ADR-0006, ADR-0007, ADR-0008, ADR-0024
Count piranha population FR-3.4 S2 ADR-0006, ADR-0008
Understand zone popularity, forecast flows, plan staff, and see the order of a visit FR-2.2, FR-2.3, FR-2.10 S3 ADR-0009, ADR-0008, ADR-0007, ADR-0004, ADR-0018
Guide visitors, personalise the day, drive return visits FR-4.1, FR-4.2, FR-4.7 S4 ADR-0005, ADR-0010, ADR-0007, ADR-0018
Price family passes to fill quiet days FR-4.3 S5 ADR-0008, ADR-0007, ADR-0004, ADR-0012
Recognise a returning household, and pay by tap FR-1.8, FR-4.6 Core ADR-0018, ADR-0011, ADR-0009
Answer the question the report did not anticipate, and what an investment changed FR-2.4, FR-2.8 S6 ADR-0013, ADR-0014, ADR-0015
Turn the estate's own footage and its visitors' words into something usable FR-4.4, FR-4.5 S7 ADR-0006, ADR-0021, ADR-0025
Know how the rides are behaving before one stops FR-2.5, FR-2.9 S8 ADR-0016, ADR-0022, ADR-0023
Reach the enclosures nothing else reaches FR-3.1, FR-1.9 Edge ADR-0019, ADR-0020
AI operations
Swap models/providers without rewriting services NFR-EVO AI platform ADR-0005
Prove AI works before and after release NFR-VER AI platform ADR-0008
Let an agent act without letting it decide FR-5.4, NFR-AGT-1 Agents ADR-0013, ADR-0014
Know which controls a capability owes OKR 5.3 Risk classes ADR-0017, ADR-0016

Dealing with uncertainty in AI

The best model today is not the best model tomorrow. No business service names a model or a provider. A service asks for a capability (summarise-daily-welfare-report, plan-visit); a thin resolver maps it to the versioned model/prompt bundle in the registry. Hosted models are reached through an adopted open-source inference gateway; our own vision, counting and forecasting models run on managed endpoints, edge nodes or batch jobs. All of them sit under the same governance: registry, evaluation gate, monitoring. Switching a model is a registry change plus a passing evaluation suite. → ADR-0005

A provider changes prices. Per-capability budgets and cost-per-request telemetry in the gateway; tiered routing (cheap model first, escalate on low confidence); alerts at 70/90% of budget; a documented downgrade path to an open-weight model on managed hosting. The generative bill is costed per request class in what the generative capabilities cost. → ADR-0005

A provider shuts down. Every generative capability has a named fallback provider that passes the same evaluation suite, exercised monthly rather than assumed. Prompts, evals and traces stay on our side, and safety-critical paths never depend on a generative model at all. → ADR-0005, ADR-0006

Does it work? Validation & verification of AI

  • Before release: golden datasets per capability (labelled enclosure footage, historical footfall, annotated visitor conversations); a CI gate that blocks a bundle whose score regresses; shadow mode against the current version. Every gated metric names its instrument — how the gated metrics are defined.
  • In production: confidence bands with human review for medium confidence; drift monitoring on inputs and outputs; LLM-as-judge on a sample plus weekly human spot checks; business-metric guardrails (vet override rate, forecast MAPE) with automatic rollback.
  • For the agents, three more metrics: task success, tool-error rate and human-override rate — and an agent rollback that reverts the prompt, whitelist and step budget without touching the model bundle, because the failure is at least as often in the wiring (agents).
  • When it misbehaves: every capability has a deterministic fallback — static schedules, rule-based alerts, fixed prices — and it is not a designed one: each fallback ran in production as the primary path before its model was promoted (ADR-0023).

→ ADR-0008, ADR-0007, ADR-0016, AI platform

The non-AI foundation gets the same treatment. A game-day catalogue of twenty scripted faults — from uplink loss and broker failover to an erasure request, a POS webhook carrying a card number and a feed scale wedged at a plausible weight — each with expected behaviour, a metric, a pass threshold, a cadence and an owner. Five are the exit criterion for Phase 0. Four of the twenty aim at what the AI added: a poisoned knowledge-base document, a poisoned batch of agent memory and its rollback, a remote enclosure losing both its bridge and its pickup round, and a token reader going offline on a capacity-managed day.

What this architecture does not do

The proposal removes the estate's blindness — where people are, how animals are doing, how the rides are behaving, what a Wednesday is worth — and bounds the cost of running it (cost model: ≈ €0.61 per visitor today, ≈ €0.32 at 15,000/day, most of it ticketing fees and the team). It does not:

  • Guarantee the business case. requirements/08 shows the arithmetic and its assumptions; the decisions and marketing that make them true, and the parking that makes 15,000 a day physically possible, are the Countess's.
  • Manufacture demand. The platform measures growth from day one and drives two of its three levers — weekday fill and repeat visits — only from Phase 3. New audiences come from marketing, and the platform claims none of them.
  • Run the rides, or clear one. Ride control systems and their certification stay out of scope. S8 watches the machinery on non-invasive sensors and flags a ride for inspection with its evidence, on top of an unchanged statutory schedule — and a certified engineer, never a model, decides whether a ride opens (ADR-0022).
  • Drive anything. The land train keeps its driver. Autonomy is a safety case with five stated preconditions, none of which holds today, and we would rather write that down than quietly leave it out (ADR-0020 §4).
  • Replace people. The vet decides, the keeper identifies the animal, the ops manager approves the roster and the daily report, the curator publishes, the engineer clears the ride, management sets prices; ≈ 17–35 staff hours a week, spread across eight roles, go into that (who does what). Every agent output is a proposal into one of those decisions.
  • Identify anyone without them choosing it. No faces, no device tracking, no re-identification across seasons — and no re-identification of meerkats, yet. Footfall and queues are measured by anonymous counters, which remain the instrument of record. The visitor token is the opposite of covert: a physical thing the visitor can refuse, whose location consent is separate and costs no function, whose taps are aggregated and suppressed below twenty before any analyst sees them, and whose carry rate is published beside every figure it produces.
  • Do HR, payroll or physical security. Staff data is imported and plans exported (A12); CCTV for theft is not this system.

Risks

See requirements/07-risks-and-mitigations.md.

Appendix

Finance, product specification, vendor rules, radio planning and runbooks are kept out of the architecture and indexed in appendix/. Each architectural document quotes the conclusion it needs and links to the calculation behind it.

Video

Semi-final video (5 min): see video/.


Portions of this documentation were drafted with AI-assisted tools under human direction. All architectural decisions, trade-offs and final content were made, reviewed and approved by the team, who take full responsibility for them.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0