Skip to content

Commit 95aee40

Browse files
committed
feat(docs): enhance architecture documentation with additional protocols and descriptions
1 parent a3a133f commit 95aee40

3 files changed

Lines changed: 46 additions & 26 deletions

File tree

content/docs/introduction/architecture.mdx

Lines changed: 40 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -3,54 +3,69 @@ title: Protocol Architecture
33
description: How the Data, System, and UI protocols work together as one cohesive system
44
---
55

6-
import { Database, Layout, Cpu, ArrowRight, CheckCircle, Workflow } from 'lucide-react';
6+
import { Database, Layout, Cpu, ArrowRight, CheckCircle, Workflow, Bot, Cloud } from 'lucide-react';
77

88
# The Protocol Stack
99

10-
The architecture is built on three foundational protocols that work together as a unified system:
10+
The architecture is built on foundational protocols that work together as a unified system:
1111

1212
<Cards>
1313
<Card
1414
icon={<Database />}
1515
title="Data Protocol"
16-
description="Structure, queries, and constraints."
16+
description="ObjectQL: Structure, queries, and constraints."
17+
/>
18+
<Card
19+
icon={<Layout />}
20+
title="UI Protocol"
21+
description="ObjectUI: Presentation, interaction, and routing."
1722
/>
1823
<Card
1924
icon={<Cpu />}
2025
title="System Protocol"
21-
description="Control, runtime, and governance."
26+
description="ObjectOS: Control, runtime, and governance."
2227
/>
2328
<Card
24-
icon={<Layout />}
25-
title="UI Protocol"
26-
description="Presentation, interaction, and routing."
29+
icon={<Workflow />}
30+
title="Automation Protocol"
31+
description="Business Logic: Flow, Workflow, Triggers."
32+
/>
33+
<Card
34+
icon={<Bot />}
35+
title="AI Protocol"
36+
description="Intelligence: Agents, RAG, Models."
37+
/>
38+
<Card
39+
icon={<Cloud />}
40+
title="Hub Protocol"
41+
description="Management: Multi-tenancy, Marketplace, Licensing."
2742
/>
2843
</Cards>
2944

30-
## Why Three Layers?
45+
## Why Separated Layers?
3146

3247
Traditional applications tightly couple data, business logic, and presentation. This creates **Implementation Coupling** — changing one layer forces changes across the entire stack.
3348

3449
ObjectStack enforces **Separation of Concerns** through protocol boundaries:
3550

3651
```
37-
┌─────────────────────────────────────────┐
38-
│ UI Protocol │
39-
│ Apps, Views, Dashboards, Reports
40-
│ "How do users interact?" │
41-
└────────────────────────────────────────┘
42-
│ View-Data Interface
43-
┌────────────────────────────────────────┐
44-
System Protocol
45-
│ Auth, Permissions, Workflows, Events
46-
│ "Who can do what, when?"
47-
└────────────────────────────────────────┘
48-
│ Control-Data Interface
49-
┌────────────────────────────────────────┐
50-
│ Data Protocol │
51-
│ Objects, Fields, Queries, Drivers │
52-
│ "What is the data structure?" │
53-
└─────────────────────────────────────────┘
52+
┌───────────────────────────────────────────────────────────
53+
│ UI Protocol & AI Protocol
54+
│ Apps, Views, Dashboards, Agents, RAG
55+
│ "How do users and agents interact?"
56+
└───────────────────────────┬───────────────────────────────┘
57+
Interface
58+
┌───────────────────────────┴───────────────────────────────┐
59+
│ System Protocol & Automation Protocol & Hub Protocol
60+
│ Auth, Permissions, Orchestration, Multi-tenancy
61+
│ "Who/What can do what, when, and where?"
62+
└───────────────────────────┬───────────────────────────────┘
63+
│ Control
64+
┌───────────────────────────┴───────────────────────────────┐
65+
Data Protocol
66+
│ Objects, Fields, Queries, Drivers
67+
│ "What is the data structure?"
68+
└───────────────────────────────────────────────────────────
5469
```
5570

5671
## Layer 1: ObjectQL (Data Protocol)

content/docs/meta.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,10 @@
88
"objectui",
99
"objectos",
1010
"---",
11+
"automation",
12+
"ai",
13+
"hub",
14+
"---",
1115
"references"
1216
]
1317
}

content/docs/objectui/meta.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
"concept",
55
"layout-dsl",
66
"widget-contract",
7-
"actions"
7+
"actions",
8+
"reports"
89
]
910
}

0 commit comments

Comments
 (0)