Skip to main content

How School Connections Work

The Junipa Organisation Portal connects to individual school instances using a parent-child architecture. Each school runs independently, and the organisation portal sits above them as a centralised oversight layer.

Architecture​

Organisation Portal (Parent)
    |
    |--- School A (Child)
    |--- School B (Child)
    |--- School C (Child)
  • The Organisation Portal is the parent. It receives aggregated data from connected schools.
  • Each School Instance is a child. It operates independently and controls its own student data, evidence, and administration.

How Connections Are Established​

Connections between the organisation portal and a school instance are established through a secure invite code handshake:

  1. The organisation administrator generates an invite code in the organisation portal.
  2. The code is shared with the school administrator.
  3. The school administrator enters the code in their Junipa instance.
  4. The two systems complete a handshake to verify the connection.
  5. The school appears as a connected campus in the organisation portal.

For detailed steps, see the Invite Code Flow guide.

What Data Flows to the Organisation​

Once connected, the organisation portal receives:

  • Summary metrics -- Student counts, evidence counts, and adjustment level distributions.
  • Aggregated reporting data -- Data needed for cross-school audit reports and executive overviews.
  • Health status -- Connection status and response time from the school instance.

The organisation portal does not receive:

  • Individual student names or personally identifiable information (unless specifically configured)
  • Raw evidence entries or attached files
  • School-level administration settings

Data Sovereignty​

Each school retains full control of its data:

  • Data remains stored within the school's own Junipa instance.
  • The organisation portal accesses aggregated data via secure API calls.
  • If a school is disconnected from the organisation, the organisation portal loses access to that school's data immediately.
  • Disconnecting a school does not affect the school's own data or operations.

Connection Limits​

There is no limit to the number of schools that can be connected to a single organisation portal. Each school can be connected to one organisation at a time.