Back to archive
II. Clinical AI & Health Platformssupportingleadclient anonymised

Health Platform v2 — Architecture Blueprint

Architectural blueprint of Healthcare platform Platform v2 — a microservices medical platform under HIPAA/GDPR/Saudi PDPL: three-way privacy split PII ↔ PHI ↔ Anon (field-level encryption + blind index + anonymous ID mapping), AI lab-result processing on LangGraph, Temporal orchestration, MinIO/S3. The folder contains project documentation (not code) — code lives in separate service repositories.

Status
active
Period
n/a
AI sessions
1
Stack
Languages
Markdown
§01

Overview

  • What it is: A system-design hub for rewriting Healthcare platform from a Django monolith into microservices. The folder ~/development/salomatic_v2 is NOT a git repo and contains docs/ (per-service architecture) + team/ + .claude/. It is the "map" and spec of the v2 platform; the implementation lives in separate service repositories (many of which are tasks of their own: phi-service #44, pii_salomatic #47, anon-service #7, lab-processor #26, salomatic_temporal #68, salomatic_lab_preview #66).
  • Type / status / role: other (architecture / planning) · active · lead (architect) — the user designs the platform decomposition.
  • Activity period: n/a (not git). Docs are dated Dec 2025 – Feb 2026 by mtime.
§02

What was shipped

  • Designed the full microservices architecture of v2: flow diagrams, services table (stack/port/purpose), per-service specifications.
  • Defined the core privacy model: splitting PII/PHI/Anon across 3 services with anonymous mapping.
  • Locked in infrastructure decisions (Temporal, MinIO, API Gateway).
  • (Implementation is being done in separate service repos — see related tasks.)
§03

Technical challenges

Confirmed by docs/ARCHITECTURE.md:

  • Privacy via three-way PII/PHI/Anon separation (pii_salomatic + phi-service + anon-service): personal data (PII) with field-level encryption and blind index (search over encrypted data), medical data (PHI) with two-level encryption, plus a dedicated anon-service mapping PII ↔ anonymous UUID. The services talk to each other, but none of them holds the full picture. → advanced privacy-by-design architecture under HIPAA/GDPR/PDPL.
  • Blind index for search over encrypted PII — a non-trivial cryptographic pattern (search without decrypting). → deep understanding of applied cryptography.
  • AI processing on LangGraph (lab-processor): agentic workflows for lab-result analysis as a separate service.
  • Temporal orchestration of inter-service processes + MinIO for binary artifacts (PDF reports). → durable, fault-tolerant design.
  • Polyglot microservices (Bun/Elysia + Python/FastAPI) with an API Gateway — deliberate stack choice per service.
§04

AI-assisted development

  • Sessions found: 1 directory (2 transcripts + index) — the architecture was worked out with Claude Code.
  • What was done with AI: designing v2 architecture/specs (likely — generating and iterating per-service design docs with AI).
  • AI-workflow patterns: AI-assisted system design (using AI to design a microservices architecture and its documentation).
§05

Achievements & metrics

  • Full microservices architecture of a medical platform (5 core + support services).
  • Privacy-by-design under 3 regulatory regimes (HIPAA/GDPR/Saudi PDPL).
  • 8+ per-service specifications.
Currently

Open to Senior / Staff engineering roles and selective freelance — production AI, platform, and full-stack work.

Get in touch