Architecture Overview · Enterprise AI Delivery

Cloud-Portable AI Governance Platform — AWS

Cloud adapter deployment of the Advisory AI governance library to AWS — 5 CloudFormation stacks, 17 API routes, 7 DynamoDB tables, and a 5-job CI/CD pipeline. Zero business logic changed.

0 Logic Lines ChangedAWS · CloudFormation136 Tests Preserved

Click any component to explore it in the full case study.

Input A
Governance Library (Python)
Existing governance assessment logic: 136 passing tests, 6 core components, scanning domains, artifact generators. Business logic unchanged — only cloud adapter layer added.
Python · 136 tests preserved
Input B
AWS Deployment Spec
5 CloudFormation nested stacks, 7 DynamoDB tables, 17 API routes, 3 environments (dev/staging/prod), CI/CD pipeline specification
CloudFormation · 5 stacks
Cloud Adapter + CI/CD Pipeline
Layer 1
Lambda Routing
17 API route handlers via Lambda function dispatcher
›
Layer 2
Cloud Adapters
DatabaseAdapter (DDB), StorageAdapter (S3), AIModelAdapter (Bedrock), SecretsAdapter (SSM)
›
Layer 3
DynamoDB Queries
7 tables with GSIs — query translation from business logic calls
›
Layer 4
CI/CD (5 jobs)
GitHub Actions: test → lint → security-scan → deploy → smoke-test. Pre-signed URL + secret caching validation
🧪
Property-Based Testing + Smoke Gates
Hypothesis PBT validates 6 behavioral properties. Smoke tests verify health endpoint, API contract, and DynamoDB access on every deploy. Pre-signed URL security validation included.
6 PBT properties (Hypothesis)Smoke tests per deploySecret caching validationPre-signed URL security3 environmentsZero manual IaC
Output A
AWS-Deployed Governance Platform
Full governance assessment API on AWS — same compliance workflows, artifact generation, and audit trail as the original library, now running at cloud scale with DynamoDB persistence
17 API routes · 7 DDB tables
Output B
CloudFront Static Frontend
S3 + CloudFront CDN hosting governance dashboard UI. 3-environment promotion pipeline (dev → staging → prod)
S3 · CloudFront · 3 envs
5
CFN nested stacks
17
API routes
7
DynamoDB tables
0
Logic lines changed
StackAWS CloudFormationLambda Python 3.11DynamoDBS3 + CloudFrontGitHub ActionsHypothesis PBTAWS BedrockSSM Parameter Store