Portfolio Project
An agency-operations platform for local SEO and website fulfillment. It turns a plain-language client request into grounded recommendations, reports, tasks, and approval-gated fulfillment handoffs.
Onboarding, plans, reports, approvals, jobs, retries, and outcomes are persisted rather than held only in a conversation.
Every conclusion carries a source, freshness, confidence, and verification status. Unknown access is reported as unknown, never invented.
Recommendations generate cheaply, but consequential external writes require explicit authorization and a final provider-health check.
Slack, GitHub, Vercel, Search Console, and Google Business Profile are adapters with safe failure codes instead of hidden side effects.
Secrets stay in runtime configuration, agency scope is role-enforced, and privileged job routes require a separate shared secret.
Readiness checks, provider verification, scheduler health, and execution evidence make failures diagnosable.
Python, FastAPI, Pydantic, SQLAlchemy, Alembic, SQLite/Postgres, server-rendered HTML/CSS, Slack and Google APIs, GitHub and Vercel adapters, pytest, GitHub Actions.
The sanitized public checkout bootstraps a test schema and passes its full suite with dummy configuration. The repository README documents a suggested review path through the evidence and authorization boundaries.