Reviewer path

Understand it in 3 minutes, go deep in 15.

3-minute overview

  1. Scan the project matrix and CI badges.
  2. Read the maturity labels and deployment status.
  3. Open the architecture and tradeoff notes.

15-minute technical review

  1. Start with Enterprise RAG or Customer Operations.
  2. Compare API flow diagrams with each project README.
  3. Inspect tests, eval scripts, and sample responses.

30-minute local run

  1. Clone one target repo and install dependencies.
  2. Run tests/evals, start the API, then run smoke tests.
  3. Repeat with a scoring service or ADAAS backend.

Final reviewer checklist

What to verify before going deep.

Orientation

  1. Confirm this repo is the portfolio index.
  2. Use the matrix to choose one runnable project.
  3. Open the linked repo README and DEMO guide.

Evidence

  1. Check tests/evals and smoke-test commands.
  2. Inspect sample requests and responses.
  3. Review CI badges and Docker build status.

Boundaries

  1. Look for remaining gaps in each repo README.
  2. Expect no real credentials or production datasets.
  3. Treat cloud deployment as pending.

CI evidence

Build and test signal from each repo.

Project matrix

What each system proves.

Project Problem solved Stack Demo command Status Tests/evals Deployment validation
Enterprise RAG Source-backed retrieval and grounded HR policy answers. Python, FastAPI, local embeddings, SQLite, Docker, Kubernetes, CI. uvicorn api.server:app --reload --port 8000
python scripts/smoke_test.py
Locally tested, smoke-tested, cloud deployment pending, needs production data. 9 tests passed; retrieval eval accuracy 1.0. Compose/K8s statically validated; image build validated in CI.
Customer Ops Multi-step customer message routing with an inspectable decision trace. Python, FastAPI, workflow agents, SQLite, Docker, Kubernetes, CI. uvicorn api.server:app --reload --port 8000
python scripts/smoke_test.py
Locally tested, smoke-tested, cloud deployment pending, needs production data. 8 tests passed; policy/action accuracy 1.0. Compose/K8s statically validated; image build validated in CI.
Incident Detection Telemetry scoring for latency, errors, timeouts, and traffic anomalies. Python, FastAPI, z-score model, SQLite, Docker, Kubernetes, CI. uvicorn api.server:app --reload --port 8000
python scripts/smoke_test.py
Locally tested, smoke-tested, cloud deployment pending, needs production data. 7 tests passed; scoring eval accuracy 1.0. Compose/K8s statically validated; image build validated in CI.
Sales Intelligence Account propensity scoring with ranked feature explanations. Python, FastAPI, deterministic scoring, SQLite, Docker, Kubernetes, CI. uvicorn api.server:app --reload --port 8000
python scripts/smoke_test.py
Locally tested, smoke-tested, cloud deployment pending, needs production data. 7 tests passed; scoring eval accuracy 1.0. Compose/K8s statically validated; image build validated in CI.
Meeting Intelligence Transcript analysis for summaries, decisions, and action items. Python, FastAPI, Pydantic schemas, SQLite, Docker, Kubernetes, CI. uvicorn api.server:app --reload --port 8000
python scripts/smoke_test.py
Locally tested, smoke-tested, cloud deployment pending, needs production data. 8 tests passed; structure accuracy 1.0. Compose/K8s statically validated; image build validated in CI.
ADAAS HR assistant application with leave workflows and policy chat. Flutter, Dart, Node, Express, optional MongoDB, Docker, Kubernetes, CI. cd hr-backend && npm start
npm run smoke in a second terminal
Locally tested, smoke-tested, cloud deployment pending, needs production data. 10 backend tests passed; Flutter analyze clean; 17 Flutter tests passed. Backend Compose/K8s statically validated; backend image build validated in CI.

System map

A portfolio index, not a seventh product.

Deep dives

One page per project, linked to the runnable repo.

Enterprise RAG Knowledge System

Repository
What it does
Retrieves policy context, ranks evidence, and returns source-backed answers through `/query`.
Architecture summary
FastAPI route, deterministic local embeddings, hybrid retrieval, reranking, SQLite event store, metrics, and safe JSON errors.
API/demo surface
`GET /health`, `GET /metrics`, `GET /events`, `GET /query`, `POST /query`; see DEMO.md.
Tests/evals
`python -m pytest -q` and `python evaluation/run_eval.py`; last local validation: 9 tests passed, eval accuracy 1.0.
Deployment readiness
Dockerfile, Compose, Kubernetes, CI tests/eval, and CI Docker image build validation are present.
Remaining gaps
Production corpus, managed retrieval infrastructure, managed observability, cloud deployment, and production data controls.

AI Proactive Customer Operations

Repository
What it does
Routes customer messages through planner, policy, and action steps with a visible decision trace.
Architecture summary
FastAPI orchestration service with domain policy data, action selection, SQLite event persistence, metrics, and request IDs.
API/demo surface
`GET /health`, `GET /metrics`, `GET /events`, `POST /decide`; see DEMO.md.
Tests/evals
`python -m pytest -q` and `python evaluation/evaluate.py`; last local validation: 8 tests passed, policy/action accuracy 1.0.
Deployment readiness
Dockerfile, Compose, Kubernetes, CI tests/eval, and CI Docker image build validation are present.
Remaining gaps
Live CRM integration, production policy sources, rate limits, managed observability, cloud deployment, and production data.

AI Incident Detection Platform

Repository
What it does
Scores operational telemetry to identify anomalous service behavior and explain the signal.
Architecture summary
FastAPI scoring endpoint, feature extraction, z-score anomaly model, SQLite audit trail, metrics, request IDs, and safe errors.
API/demo surface
`GET /health`, `GET /metrics`, `GET /events`, `POST /score`; see DEMO.md.
Tests/evals
`python -m pytest -q` and `python evaluation/evaluate.py`; last local validation: 7 tests passed, eval accuracy 1.0.
Deployment readiness
Dockerfile, Compose, Kubernetes, CI tests/eval, and CI Docker image build validation are present.
Remaining gaps
Production telemetry ingestion, alert routing, incident workflow integrations, cloud deployment, and long-term metrics storage.

AI Sales Intelligence Engine

Repository
What it does
Scores accounts for propensity and returns ranked feature explanations through a simple API.
Architecture summary
FastAPI scoring service, deterministic feature model, explanation ranking, SQLite events, metrics, request IDs, and safe JSON errors.
API/demo surface
`GET /health`, `GET /metrics`, `GET /events`, `POST /score`; see DEMO.md.
Tests/evals
`python -m pytest -q` and `python evaluation/evaluate.py`; last local validation: 7 tests passed, eval accuracy 1.0.
Deployment readiness
Dockerfile, Compose, Kubernetes, CI tests/eval, and CI Docker image build validation are present.
Remaining gaps
Real CRM feeds, model monitoring, retraining workflow, cloud deployment, and production data governance.

Autonomous Meeting Intelligence

Repository
What it does
Turns meeting transcripts into summaries, decisions, and action items with structured output.
Architecture summary
FastAPI analysis endpoint, transcript parser, structured extractor, Pydantic schema validation, SQLite events, and metrics.
API/demo surface
`GET /health`, `GET /metrics`, `GET /events`, `POST /analyze`; see DEMO.md.
Tests/evals
`python -m pytest -q` and `python evaluation/evaluate.py`; last local validation: 8 tests passed, structure accuracy 1.0.
Deployment readiness
Dockerfile, Compose, Kubernetes, CI tests/eval, and CI Docker image build validation are present.
Remaining gaps
Calendar/transcript integrations, identity controls, cloud deployment, production data, and human review workflow.

ADAAS HR Assistant

Repository
What it does
Combines a Flutter HR assistant with a Node backend for leave balances, leave applications, and policy chat.
Architecture summary
Flutter UI, intent routing, Express API, optional MongoDB persistence, seeded fallback data, optional provider-backed chat, metrics, and API key support.
API/demo surface
`GET /health`, `GET /metrics`, `GET /leave-balance`, `POST /leave-application`, `GET /leave-applications`, `POST /chat`; see DEMO.md.
Tests/evals
`npm test`, `flutter analyze`, and `flutter test`; last local validation: 10 backend tests, clean analyze, 17 Flutter tests.
Deployment readiness
Backend Dockerfile, Compose, Kubernetes, CI backend tests, CI backend image build, and Flutter CI are present.
Remaining gaps
Production HR data integration, identity provider, managed MongoDB, cloud deployment, and policy data governance.

Documentation map

Go from overview to evidence.

Screenshots and GIFs

Capture real demos, do not fake assets.

No screenshots or GIFs are committed yet. Use docs/DEMO_CAPTURE.md to capture real terminal runs or UI screenshots, then place final assets under docs/assets/ and link them from this page.

GitHub Pages

Deploy this static site without a build step.

  1. Open the portfolio repository settings on GitHub.
  2. Go to Pages.
  3. Set source to GitHub Actions.
  4. Save the setting.
  5. Push to main or run the Deploy GitHub Pages workflow manually.
  6. Open the generated Pages URL after the workflow finishes.

This site is plain HTML and CSS. It does not require Node, package installation, a frontend build, secrets, registries, or service runtime credentials.