@@ -55,66 +55,13 @@ Each agent follows the same operating shape: deterministic baseline first, LLM-a
55557 . Ask grounded follow-up questions in the workspace assistant
56568 . Export Markdown or WeasyPrint-backed PDF documents
5757
58- ## Stack
59-
60- - Next.js frontend in ` frontend/ `
61- - FastAPI backend in ` backend/ `
62- - Shared Python workflow, agents, builders, and services in ` src/ `
63- - Supabase for Google auth, quota tracking, saved workspaces, and saved jobs
64- - Greenhouse and Lever job-source clients with matching and registry layers
65- - OpenAI Responses API for assisted generation
66- - WeasyPrint-backed PDF export pipeline
67- - Docker Compose + Caddy deployment bundle in ` deploy/vps/ `
68-
6958## Engineering Notes
7059
7160- 37 focused Python test files cover parsing, normalization, fitting, tailoring, orchestration, builders, exports, auth, quotas, persistence, and backend routes.
7261- 12 ADRs in ` docs/adr/ ` record product and architecture decisions, including the Streamlit-first to Next.js + FastAPI transition.
7362- Architecture details live in [ docs/architecture.md] ( docs/architecture.md ) .
7463- Deployment notes live in [ docs/next-fastapi-transition.md] ( docs/next-fastapi-transition.md ) .
7564
76- ## Local Development
77-
78- Run the backend:
79-
80- ``` powershell
81- uv run uvicorn backend.app:app --reload --host 127.0.0.1 --port 8000
82- ```
83-
84- Run the frontend:
85-
86- ``` powershell
87- cd frontend
88- npm install
89- npm run dev
90- ```
91-
92- Recommended local frontend env:
93-
94- ``` env
95- NEXT_PUBLIC_API_BASE_URL=http://127.0.0.1:8000/api
96- NEXT_PUBLIC_SITE_URL=http://localhost:3000
97- ```
98-
99- Recommended backend env:
100-
101- ``` env
102- ENABLE_JOB_SEARCH_BACKEND=true
103- JOB_BACKEND_BASE_URL=http://127.0.0.1:8000
104- GREENHOUSE_BOARD_TOKENS=narvar,gleanwork,wayve,datadog,moloco,figma,qualtrics,thumbtack,placerlabs,zscaler,coinbase,typeface
105- LEVER_SITE_NAMES=dnb,plaid,mistral
106- ```
107-
108- ## Core Checks
109-
110- 1 . Open ` http://127.0.0.1:8000/api/health `
111- 2 . Open ` http://localhost:3000/workspace `
112- 3 . Upload a resume
113- 4 . Search or import a job
114- 5 . Load or paste a JD
115- 6 . Run the agentic analysis
116- 7 . Verify resume, cover letter, assistant, and exports
117-
11865## Deployment Shape
11966
12067- ` app.job-application-copilot.xyz ` -> Vercel frontend
0 commit comments