Transition Overview
Preparing the platform split before the full UI redesign
This branch establishes the deployment and codebase skeleton for a Vercel-hosted Next.js frontend talking to a Dockerized FastAPI backend on the VPS. The goal is to prove the architecture first, then layer the real product screens and style system on top.
Keep the Python workflow core
The value is already in the parsing, fit analysis, orchestration, and artifact builders. We are not rewriting that logic into JavaScript.
Move product UI to Next.js
The frontend gets cleaner routing, deploys naturally on Vercel, and becomes easier to iterate on without the constraints of Streamlit state.
Standardize backend deployment on the VPS
The FastAPI boundary becomes the single Dockerized service for the product shell to call, matching the HelpMate deployment pattern.
Migration note
The current Streamlit product remains the reference implementation while parity work is underway.
Migration note
This branch is aimed at the main-architecture transition only, not the larger extended-job-support branch.
Migration note
The first useful checkpoint is not visual polish; it is a trustworthy split deployment shape that we can build on.