HIVE access architecture · working reference

Who can do what, in which tenant

One base platform, three separate verticals: Organizational (cities, companies, conferences), Educational (schools, classrooms, teachers, students) and User (the individual avatar creator). This page is the expanded version of the v2 architecture board: same login and tenant model, redrawn to show every role, every scope boundary and who can see what.

Two terms from the sprint plan, decoded

Both came straight out of the v2 delivery plan, not the architecture board itself. Here is what each one means and where it lives.

Walking skeleton flows

Not wireframes. It is an agile engineering term for the thinnest possible slice of the real system, login all the way through to a scoped session, built end to end before any feature logic sits on top of it. It proves the plumbing works before the team spends sprints on features.

Sprint 0 to 1, v2 delivery plan · the two flows named are SSO login and tenant switch (figure 1)

Tenant switch

The guess was right. It is the moment a person who belongs to more than one organization or school picks which one they are currently working inside. Everything after that, avatars, rosters, branding, insights, is scoped to the tenant they picked.

Confirmed by the architecture board's tenant isolation boundary and SSO org login node

How a login becomes a scoped session

This is the walking skeleton itself: the one flow every vertical shares before it ever reaches a role specific screen.

no tenant 1+ tenants organizational educational Any person Login / SSO skeleton Identity + tenant resolver Tenant memberships? Individual session Tenant switch skeleton · auto if only one Tenant type? Personal home (User) Org console School console
Figure 1. The two gold nodes, login and tenant switch, are the walking skeleton the developer seeds in Sprint 0 and 1. The resolver checks one shared identity and tenant membership table: zero memberships routes straight to the personal, tenant free User vertical; one or more routes through tenant switch (silent if there is only one) into either the Organizational or the Educational vertical.

Three verticals, one platform

Organizational covers cities, companies and conferences. Educational covers schools, classrooms, teachers and students. User is the existing individual model: create, train and share a personal avatar with no tenant at all. The Organizational and Educational shapes are close cousins (an admin role, a scoped console, an isolated tenant), but Educational nests a second boundary inside the first: a classroom sits inside a school the same way a school sits inside the platform.

Organizational Educational User Cross tenant (HIVE Ops)
HIVE Ops · cross tenant platform admin USER · INDIVIDUAL no tenant, personal scope Consumer Own avatars Friends: read / chat / none Group chats Personal DB per user One user, one scope. Nothing to switch between. ORGANIZATIONAL tenant isolation boundary Org owner / admin Team / content manager Org member (staff) Audience (public, QR / embed, no login) Org DB · avatars, KB, branding, guardrails City, company or conference. One flat isolation boundary. EDUCATIONAL tenant isolation boundary School admin classroom (nested, per teacher) Teacher (professor scoped) Student sees only their own classroom School DB · rosters, classroom avatars School, then classroom. Two nested boundaries.
Figure 2. Organizational is one flat boundary: admin sees everything in the org. Educational nests a second boundary inside the first, so a teacher who switches tenants between two schools is doing the same thing an org admin does across two organizations, and a teacher who moves between classrooms inside one school is a smaller version of the same switch, scoped one level deeper.

Permissions by role

Full control, scoped control (their own team, classroom or org only) or none, across the actions people actually ask about.

●full ◑scoped ○none
Role Create / edit avatar Manage users / roster Branding & guardrails Insights & analytics Billing Chat / use avatar Public, no login
HIVE Ops ● ◑ ◑ ● ● ○ ○
Org owner / admin ● ● ● ● ● ● ○
Team / content manager ● ○ ○ ◑ ○ ● ○
Org member (staff) ○ ○ ○ ○ ○ ● ○
Audience (public) ○ ○ ○ ○ ○ ◑ ●
School admin ● ● ● ● ● ● ○
Teacher (own classroom) ◑ ◑ ○ ◑ ○ ● ○
Student ○ ○ ○ ○ ○ ● ○
Consumer (individual) ● ○ ○ ○ ● ● ○

Before this is official, not yet confirmed