Skip to content

Commit facf822

Browse files
LEANDERANTONYclaude
andcommitted
Reorganize docs: SQL into docs/sql/, static + pdf_rendered into docs/
Two parallel reorgs that share the same theme — keep all file-based project assets under docs/ instead of scattered at the repo root. User-driven moves (committed here as renames so history follows) - static/ → docs/static/ Demo resumes (7 PDFs/DOCX) and demo job descriptions (4 files) used by tests/quality/eval_resume_parser.py and the demo job source. They were never served at runtime; living next to the rest of the project's reference assets is more discoverable. - docs/pdf_rendered/ → docs/static/pdf_rendered/ The two sample artifact renders (classic_resume_render.pdf, cover_letter_render.pdf) get folded into the same static/ tree alongside demo_resume / demo_job_description. Cleanup pass — group SQL files - docs/job_cache_cron_setup.sql → docs/sql/job_cache_cron_setup.sql - docs/supabase-bootstrap.sql → docs/sql/supabase-bootstrap.sql - docs/supabase-resume-builder.sql → docs/sql/supabase-resume-builder.sql - docs/supabase-saved-jobs.sql → docs/sql/supabase-saved-jobs.sql Path references updated - src/config.py — STATIC_DIR moved from `BASE_DIR / "static"` to `BASE_DIR / "docs" / "static"`. DEMO_RESUME_DIR and DEMO_JOB_DESCRIPTION_DIR follow automatically. Also fixed a stale comment that pointed at a `docs/supabase-resume-builder -ttl.sql` file that doesn't exist (the real file is the resume-builder migration, now under `docs/sql/`). - docs/architecture.md — cron-setup link now points to `docs/sql/job_cache_cron_setup.sql`. - docs/adr/ADR-013 — same link updated. - tests/quality/eval_resume_parser.py — argparse help text references `docs/static/demo_resume` (was `static/demo_resume`). DEVLOG.md still has historical references to the old paths; those are kept as-is since the day-by-day log records what locations were in play at the time the work shipped. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent a867f9c commit facf822

23 files changed

Lines changed: 9 additions & 5 deletions

docs/adr/ADR-013-cached-jobs-cache-layer-with-scheduled-refresh.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Considered but rejected. Running the cron inside Postgres means the schedule sur
6161
- per-board success gating on cleanup
6262
- the bearer-protected admin endpoint
6363
- structured per-provider error reporting
64-
- The system depends on `pg_net` and `pg_cron` extensions being enabled on the Supabase project. Documented in `docs/job_cache_cron_setup.sql`.
64+
- The system depends on `pg_net` and `pg_cron` extensions being enabled on the Supabase project. Documented in `docs/sql/job_cache_cron_setup.sql`.
6565

6666
## Follow-Up
6767

docs/architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -211,7 +211,7 @@ Each `saved_jobs` row stores one shortlisted posting per user and normalized job
211211

212212
Each `resume_builder_sessions` row stores one in-progress conversational resume-builder draft per user with a 7-day TTL refreshed on every save. A `pg_cron` job (`cleanup-expired-resume-builder-sessions`) hard-deletes expired rows every 5 min and RLS hides expired rows from per-user queries; see [ADR-016](adr/ADR-016-conversational-llm-resume-builder.md).
213213

214-
Each `cached_jobs` row holds one upstream posting keyed on `(source, job_id)`. The table has GENERATED STORED columns (`work_mode`, `employment_type_norm`) backing the dropdown filters and `removed_at` tombstones for upstream-closed jobs the user has bookmarked. A `pg_cron` + `pg_net` schedule POSTs to `/admin/refresh-cache` every ~30 min (see `docs/job_cache_cron_setup.sql`); ranked search reads from this table via the `search_cached_jobs_ranked` RPC, per [ADR-014](adr/ADR-014-postgres-rpc-for-ranked-search.md).
214+
Each `cached_jobs` row holds one upstream posting keyed on `(source, job_id)`. The table has GENERATED STORED columns (`work_mode`, `employment_type_norm`) backing the dropdown filters and `removed_at` tombstones for upstream-closed jobs the user has bookmarked. A `pg_cron` + `pg_net` schedule POSTs to `/admin/refresh-cache` every ~30 min (see `docs/sql/job_cache_cron_setup.sql`); ranked search reads from this table via the `search_cached_jobs_ranked` RPC, per [ADR-014](adr/ADR-014-postgres-rpc-for-ranked-search.md).
215215

216216
## Testing Model
217217

File renamed without changes.

static/demo_job_description/Job_Title_Data_Analyst.txt renamed to docs/static/demo_job_description/Job_Title_Data_Analyst.txt

File renamed without changes.

static/demo_job_description/Sample_Job_Description_DataAnalyst.docx renamed to docs/static/demo_job_description/Sample_Job_Description_DataAnalyst.docx

File renamed without changes.

static/demo_job_description/Sample_Job_Description_DataScientist.txt renamed to docs/static/demo_job_description/Sample_Job_Description_DataScientist.txt

File renamed without changes.

0 commit comments

Comments
 (0)