Technical AddendumRevised English · 10 min read · 12 sections

Platform Architecture & Integration Addendum

Data ownership, access flows and deployment requirements

The technical companion to the Whitepaper: application boundaries, intake and record sharing, operator monitoring, product-specific AI, Wiki retrieval and the checks needed before a connected workflow is enabled.

Functions described here depend on the product, permissions and configured services. An implemented feature or connector does not establish availability in every deployment. Planned capabilities are identified separately.

Architecture scope

Aimedis applications own different workflows and expose specific interfaces. The architecture is best understood through service ownership and explicit handoffs, rather than a single shared runtime beneath every product.

Common branding, similar account screens and historical integration documents do not establish universal identity, consent, storage or deployment. Current interfaces and their receiving implementations determine what is connected.

ConcernResponsible boundary
Patient health recordCare Pro and the authorized record-access workflow
Structured intakeOnboarding handoff and the receiving practice / Pro workflow
BookingBooking and configured receiving applications
CommunicationConnect conversation access and configured video services
Reference evidenceWiki source review, organization access and retrieval permissions
Operator observationsCenter registry, operator access and configured probes
Specialist workflowsEach specialist application, its roles and external dependencies

Identity and integration ownership

Shared Supabase identity is implemented for configured care applications. Care Pro, Connect and Onboarding support a configured parent-domain cookie. Pro verifies the shared credentials and creates a separate professional session; Booking also uses its own sessions. Shared credentials therefore do not mean a universal logged-in session or universal permissions.

Center has separate operator access. Wiki requires eligible administrator access and organization approval. Specialist products have their own roles and configuration.

An identity match is only one part of integration. The caller still needs authorization for the target service, requested scope and current session. Connect and Pro have their own professional review mechanisms. A professional credential badge is not a substitute for a patient-record grant.

  • Confirm which identity issuer and patient/practice identifiers both ends accept.
  • Distinguish signup processing consent, intake handoff permission and medical-record access.
  • Specify the sender, receiver, payload, error states and revocation behavior for each interface.
  • Verify the current implementation rather than reusing an older illustrative endpoint from a different product.

Center observes registered systems

Center records platform relationships, contract ownership and configured liveness or response-shape checks. Its current implementation includes seeded data and simulated probes. Contract maturity labels and green states are not successful clinical-integration acceptance tests.

Application and service boundaries

Center is a registry and monitoring application. It is not a clinical traffic gateway, credential vault, universal consent authority or fleet deployment controller. Its current in-memory operator state also requires separate decisions about durable storage and operational use.

User-facing applications

Patient, professional, insurer, moderator and operator workspaces expose the workflows appropriate to each role. An application’s visible controls must be backed by the target service’s permissions.

Product-owned data

Clinical records, intake, conversations, rehabilitation activity, feedback and reference evidence have different owners and storage lifecycles. Do not treat all of them as one shared patient database.

Explicit integrations

Record bridges, booking handoffs, intake exports, video providers and evidence retrieval connect selected services. Each integration requires a compatible contract and configured credentials.

External delivery

Model and voice providers, telematics services, wearable connections and immersive streaming have their own availability, authorization and deployment requirements.

Security and operational responsibilities

The inspected applications contain combinations of authenticated endpoints, role checks, database policies, input validation, private storage, rate limits and audit records. Their coverage and operational guarantees differ by service.

Hash-linked audit entries support integrity checks within their implementation. They are not evidence of blockchain anchoring, immutable retention or independent protection. Deployment-specific persistence, backup, access review and monitoring remain necessary.

A standard mentioned in source code or a design document is not certification. Healthcare-data processing, hosting, provider agreements and the intended clinical use require their own applicable approvals and operational evidence.

  • Keep service credentials on the authorized server and use the minimum permitted scope.
  • Check source licences and recipient permissions before transferring reference excerpts.
  • Define retention, deletion, access logging and incident handling for each data category.
  • Confirm production identity, database policies and private-storage configuration.
  • Keep simulation fixtures and demonstration credentials separate from operational workflows.

Product-specific AI behavior

The assistant brand does not imply a single model, shared memory, common toolset or identical safeguards across all applications. Model and voice configuration, available data and role permissions must be inspected per product.

For evidence-based workflows, treat retrieved excerpts as untrusted source material rather than instructions. Preserve citations and licence information. Distinguish a supported claim from a suggestion and show when retrieval or a provider fails.

ContextImplemented purposeImportant limit
Public website AVAPublic-content search and site navigationNo access to clinical records
Care Pro AVABounded patient-record context and supported record actionsUse only the current patient’s authorized context
Pro AVAGeneral reference AI subject to provisioning and processor gatesLive patient-aware AI is disabled; record-view consent does not authorize external AI processing
Decision Pro AVAClinician support and patient explanationsClinical decisions remain with the professional
Rehab AVAGuided discussion, reference search and supported activity proposalsSupported saves require the review flow; recent changes need deployment acceptance
Wiki AVACited analysis of eligible reference evidenceSource authorization and insufficient-evidence handling apply
Support AVADocumentation-based support chat and administrator feedback insightsSome creation and analytics modes still return demonstration responses
Insur AI CoachHealth-engagement coaching interfaceCurrent patient and health context includes mock data

Wiki evidence APIs and interoperability

Wiki separates source administration from reference retrieval. Current general retrieval uses an eligible administrator’s short-lived session with the required organization and MFA checks. It is not a permanent application key. A chosen AI model can use the retrieved passages through an authorized application server.

Wiki retrieval returns hits, insufficientEvidence and a retrieval mode. The calling application must keep each excerpt’s source, version, licence and available page or timestamp locator with the answer. An empty result is a valid outcome.

The dedicated Care Pro reference service has a separate contract: queries are 3–300 characters and results are limited to 1–6. Credential issuance and successful hosted retrieval require acceptance before this integration is described as operational. Legacy awk_ keys are disabled.

InterfaceFunctionCurrent boundary
POST /api/v1/retrieveRetrieve reviewed reference passages with source/version informationAdministrator authentication; reference query up to 4,000 characters and 1–20 hits
POST /api/v1/askReturn an answer with citations using a Wiki-configured providerRequires the relevant provider and authorized source access
POST /api/v1/mcpLimited stateless JSON-RPC bridge for knowledge_search and source_getAdministrator authentication; no OAuth discovery or SSE transport
POST /api/reference/v1/retrieveScoped service retrieval using expiring awr_ credentials and source grantsCurrently restricted to aimedis-care-pro; not general unattended client access
FHIR reference projectionsRead/search of selected Library, DocumentReference and Provenance resources; authorized Binary accessNo general patient registry, FHIR writes, transactions or SMART launch

Integration maturity by product

These distinctions describe implementation boundaries. They do not certify current uptime, production configuration, medical-device status or delivery to a particular customer.

AreaPresent in the applicationsWhat remains to confirm
Care workflowsIntake, record sharing, scheduling and communication pathsPairwise configuration, identity matching, expiry and receiving-system acceptance
CenterRegistry, contract metadata and probesLive probe configuration, durable operations and actual workflow acceptance
WikiReviewed reference library and scoped APIsApproved access, credentials, provider configuration and hosted retrieval
Decision ProConsultations, triage documentation and care plansReal external adapters for TI, eRezept signing/submission, ePA and KIM
RehabSessions, assessments, exercises and external Stream launchPending migrations/releases, immersive runtime and hardware acceptance
InsurEngagement records and insurer/patient interfacesReplacement of mock Care Pro sync, coach context and demonstration XR behavior
SupportCampaigns, feedback, documentation chat and insightsDemonstration assistant modes and unfinished activity/leaderboard surfaces

Service configuration

Agree product access, user roles, external-provider costs, integration support and the included workflows in the deployment’s commercial arrangement. An implemented payment screen, estimated dashboard benefit or demonstration rewards tier does not prove a current contract or financial outcome.

Deployment acceptance

  • Identify the deployed application versions and apply the required database migrations.
  • Verify the expected patient, professional, operator or administrator identity and role.
  • Exercise an approved fictional workflow through both sender and receiver.
  • Check expired tokens, revoked grants, denied permissions and missing patient matches.
  • Verify empty retrieval, provider failures, delayed exports and retry behavior.
  • Confirm that the UI distinguishes real records from demonstration data.
  • Inspect the receiving record or acknowledgement; a successful health probe is insufficient.
  • Accept external video, telematics, wearables and immersive delivery independently.
  • Record the languages, devices and workflows actually tested for the intended users.

What the documents establish

These documents explain product purpose, implemented workflows and material integration limits. They replace blanket claims about a universal shared account, instant synchronization, a family-wide FHIR backend and identical AI behavior with product-specific descriptions.

They do not establish comparative clinical performance, certified compliance, validated cost savings or an addressable-market forecast. Assess those questions using evidence for the specific product, intended use and deployment.

Roadmap and change control

Future work can strengthen interoperable care, independently protected audit records, general service-to-service evidence access and consistent product experiences. Each proposed capability needs a defined owner, authorization model, implementation and acceptance evidence.

When an application or integration changes, update its public description and these documents together. Keep the distinction between available workflows and planned capabilities visible to patients, professionals and integration teams.