Jijibora — Smart City Documentation Set
What this set is: the complete feature, API, playbook, compliance, and deployment documentation for Jijibora, a smart-city platform for municipal, government, and community service — written for the three reader groups that carry it.
How it stays honest: every fact cites a source file; every uncertainty says so; the platform's Soft posture and fail-closed behavior are stated wherever they matter.
Stakeholders
| File | What it answers |
|---|---|
| S-01 Overview | What is Jijibora, who does it serve, and what does a pilot look like? |
| S-02 Features | What does it do for my city, capability by capability? |
| S-03 Playbook Registry | Which operational playbooks run (dispatch, reflex, maintenance, claims), who runs them, and what audit they leave? |
| S-04 Compliance | What can we genuinely claim, and what must we never claim? |
| S-05 Competitive Positioning | What acquirers in this market look for, and where we meet or miss it? |
| S-12 Sourcing & Optimization | Machines propose, rules dispose — the sourcing/solve/optimize warranties. |
| S-13 Wider Scenarios | School zones, help desks, complaints, housing, traffic, malls, real estate. |
| S-06 Environmental Playbooks | The reflexes for buildings, sourcing, civic rounds, SOS, and sensing. |
| S-07 Starter Packs | What your first deployment ships on Day 1. |
| S-09 Ontology | One shared list of things (land, buildings, councils, citizens) so every desk refers to the same thing; rules have a lifecycle. |
| S-10 Starter Bundles | Day-1 starter bundles + the staged expansion catalogue (offer ids exist for the four originals). |
| S-11 Governance Rules | Your rules are the law of the building/city: scope, compliance, spatial, and AI-advisory rules + their violations/elections. |
Administrators
| File | What it answers |
|---|---|
| A-01 Deployment | What runs where, Soft-first rollout, what to watch. |
| A-02 Compliance Ops | Logs, exports, retention, personal-data minimization, billing, incident posturing. |
| A-03 Environmental Ops | Reflex enablement, checks, capacity probes, the hurt-playbook ladder. |
| A-04 Starter Packs | Opening a starter pack: activation, rollback, pilot gates. |
| A-08 Wider Scenario Ops | Ops runbooks for help desks, complaints, school zones, housing, traffic, facilities. |
| A-05 Management Plane | Rule lifecycle, tick/scheduler stewardship, entity stewardship, SOS governance loop. |
| A-06 Governance Admin | Running the rules: proposals, amendments, violations, elections, AI advisors, break-glass. |
| A-03 Environmental Ops | Enabling, checking, and capacity-probing the environmental playbooks. |
| A-04 Starter Packs | Opening a starter pack: activation, rollback, pilot gates. |
Developers
| File | What it answers |
|---|---|
| D-01 Architecture | Control loop, reflex model, backbone, ontology package, non-goals. |
| D-02 Features & Interfaces | The five planes as interface surfaces, plus three worked integration walks. |
| D-03 Playbook Designs | Developer version of the registry: contracts per playbook + how to author the next one. |
| D-04 Environmental Playbooks | The reflex families as developer contracts (building reflex, sourcing, civic rounds, SOS, sensing). |
| D-05 Starter Packs | Pack anatomy, bundle composition, cold vs live rollout, authoring checklist. |
| D-06 Ontology Pack | Hierarchy, entity lifecycle, indexability, and adding a new "thing" without new tables. |
| D-07 Governance Rules | The six-family taxonomy, event geography, property playbooks, authoring recipe. |
| D-08 Starter Bundles | The full bundle catalogue with contents matrices and authoring checklist. |
| D-09 Optimization Capability | Sourcing/solver/optimizer catalog + playbook participation matrix + sentinel sources. |
| D-12 Playbook Building | How playbooks are authored from fragments: taxonomy, flow, per-family dossier sheets. |
| D-10 Wider Scenario Designs | Playbook anatomy end-to-end: pickup timelines, seven families, authoring recipe, completeness checker. |
| D-13 Playbook Catalog | Every playbook fully detailed in one consistent format: purpose, users, flow, guard rails, evidence, rollout. |
Blueprint sources (the corpus this set was compiled from)
docs/jijibora-gtm/(17 files — market & customer, stratification, entry point, AI interface, pricing, channels, security & compliance posture, gap analysis)docs/jijibora-government-trial/(12 files — proposal, trial, ontology, implications, limits, MoU, dossier)docs/event-sourcing/rules/(the three reflex rule examples that playbooks mirror)docs/platform-map/system/(the cross-platform set this plugs into — API references inapi/, honesty invariants inD-15, validation inD-17)