OPSQAIOQOPSQAI
All documentation

Book 2

Architecture Handbook

OPSQAI is a licensed Windows Self-Hosted operational AI platform. The installation is the customer product; cloud services distribute licenses, releases and support without becoming an employee workspace.

1. Product topology

OPSQAI team                Customer boundary
+-------------------+       +--------------------------------+
| Management Center | ----> | Windows Self-Hosted product    |
| licenses/releases |       | app + services + PostgreSQL    |
+-------------------+       | local knowledge + AI provider  |
          |                 +--------------------------------+
+---------v---------+
| Customer Portal   |  downloads, activation, release notes, support
+-------------------+

2. Customer boundary

Users work only in the Windows Self-Hosted installation. Documents, embeddings, conversations, configuration and operational records remain in the customer-controlled environment. PostgreSQL is provisioned locally by the Windows installer.

3. Effective configuration

The canonical model is Core Platform → Company Profile → Enabled Products → Optional Add-ons → Effective Configuration → Visible Workspaces. Company Profiles recommend products; Management Center explicitly enables them; a signed license distributes the resulting entitlements.

4. Grounded knowledge flow

  1. Authorized users add governed knowledge inside their installation.
  2. OPSQAI prepares local searchable representations with the configured AI provider.
  3. Questions retrieve permitted sources under role and access rules.
  4. Answers return with source context; auditing records the interaction locally.

5. License system

Management Center issues Ed25519-signed JWT licenses containing customer, profile, products, add-ons and compatibility claims. Self-Hosted verifies the signature locally and derives navigation and product access from the validated entitlements. Core capabilities remain part of the platform but stay license-controlled.

6. Cloud support services

Management Center is an internal OPSQAI administration service. Customer Portal serves designated customer contacts with downloads, activation material, release information and support. Neither service is the customer product or an employee workspace.

7. Updates & maintenance

Windows release packages are published through the controlled release flow. Customers retrieve authorized packages through Customer Portal and apply updates according to their maintenance policy.