How organizations turn knowledge into action.
Data → Intelligence → Capability → Solution → Business Outcome
OIA is a conceptual reference model for intelligent organizations. It describes how raw data becomes decisions, actions, and measurable business outcomes — going beyond pure data and analytics architectures.
Organizations fail at AI adoption when they do not first address data quality, culture, structures, and knowledge curation.
OIA provides the architectural bridge between "we have data" and "we consistently apply that knowledge in solutions and decisions" — making the cognitive architecture of the organization explicit.
| Layer | What it describes |
|---|---|
| Situation Layer | Context of every decision: employee, event, time, place, domain, task, permissions |
| Use Cases | Organizational challenges: HR, Maintenance, Customer Support |
| Solutions & Applications | User-facing systems: Enterprise Search, Knowledge Assistants, Code Assist |
| Cognitive Capabilities | What the organization can do: Find, Link, Evaluate, Generate, Structure, Report |
| Features & APIs | Reusable services: /search /summarize /link /chat /classify |
| AI & Cognitive Infrastructure | LLMs, ML, NLP, Vector Indexes, Knowledge Graphs, RPA |
| Data Layer | Foundation: persons, documents, projects, rules + processing pipeline |
→ See QUICKSTART.md for prerequisites, clone, dev server, tests, and build.
git clone https://github.com/ruKurz/oi-architecture.git
cd oi-architecture/oia-site && npm install && npm run dev| Document | Purpose |
|---|---|
CONTRIBUTING.md |
Contribution workflow, dev setup, commit format, PR process |
docs/ARCHITECTURE.md |
Codebase structure, rendering architecture, routing, CSS |
docs/MODEL_GUIDE.md |
OIA model layers, terminology, how to contribute to the model |
docs/GOOD_FIRST_ISSUES.md |
Curated entry points for new contributors |
decisions/adr/ |
Architecture Decision Records (ADRs) — technical and structural choices |
decisions/odr/ |
Organizational Decision Records (ODRs) — governance, operating model, principles |
OIA improves through shared experience from people who build real knowledge systems. Contributions range from a comment on an issue to a new use case or model refinement.
See CONTRIBUTING.md for full details, or browse docs/GOOD_FIRST_ISSUES.md for entry points.
- Code (
oia-site/) — MIT License - Content (
context/,articles/,diagrams/,decisions/,notes/) — CC BY 4.0
See GOVERNANCE.md — current model: benevolent dictator (single maintainer, Rüdiger Kurz).
Decisions are documented in a three-layer hierarchy:
- Org layer — Organizational Decision Records (ODRs) in
decisions/odr/: ecosystem type, operating model, language policy - Arch layer — Architecture Decision Records (ADRs) in
decisions/adr/: tooling, conventions, technical structure
See decisions/README.md for the full index.