How volodymyr-holovan/ats-resume-xray works
ATS Resume X-Ray is a resume-analysis product with a Streamlit web app and CLI. The main workflow accepts a PDF or DOCX, compares naive and layout-aware extraction, evaluates parsing and convention risks, recognizes fields, and produces findings and a readiness score; optional rendering boxes finding locations. A separate job-match branch parses an advert into weighted requirements, compares them with CV content, and feeds unmet requirements into a prioritized action plan. The graph follows documented and indexed dependencies; some detector internals and UI wiring are unsampled, so those links are omitted.
Main entry points: pipeline.py Analysis pipeline · app.py Web app · vacancy.py Advert parsing · engine.py Risk rule engine
Components 21
Resume analysis
- Analysis pipeline
src/ats_xray/pipeline.py - PDF extraction
src/ats_xray/extract.py - DOCX extraction
src/ats_xray/docx_extract.py - Shared PDF reader
src/ats_xray/pdf_document.py
Detection and reporting
- Risk rule engine
src/ats_xray/engine.py - Structure detectors
src/ats_xray/structure.py - Field recognition
src/ats_xray/field_report.py - Readiness score
src/ats_xray/score.py - Finding overlays
src/ats_xray/overlay.py - Page regions
src/ats_xray/regions.py - Locale conventions
src/ats_xray/conventions.py - Resume sections
src/ats_xray/sections.py
Job matching
- Advert parsing
src/ats_xray/vacancy.py - Unknown term mining
src/ats_xray/terms.py - Skills lexicon
src/ats_xray/skills_lexicon.py - CV matching
src/ats_xray/match.py - Action plan
src/ats_xray/action_plan.py
User interfaces
- Web app
app.py - Command line
src/ats_xray/cli.py
Other components
- Resume owner
- Job advert
Connections 24
- Resume owner → Web app: uploads resume
README.md - Resume owner → Command line: submits resume
README.md - Web app → Analysis pipeline: analyzes file
app.py - Command line → Analysis pipeline: analyzes file
src/ats_xray/cli.py - Analysis pipeline → PDF extraction: dispatches PDF
src/ats_xray/pipeline.py - Analysis pipeline → DOCX extraction: dispatches DOCX
src/ats_xray/pipeline.py - Analysis pipeline → Shared PDF reader: shares document
src/ats_xray/pipeline.py - PDF extraction → Shared PDF reader: reads PDF
src/ats_xray/extract.py - Analysis pipeline → Risk rule engine: runs rules
src/ats_xray/pipeline.py - Analysis pipeline → Field recognition: builds report
src/ats_xray/pipeline.py - Analysis pipeline → Readiness score: scores resume
src/ats_xray/pipeline.py - Risk rule engine → Structure detectors: checks structure
src/ats_xray/engine.py - Risk rule engine → Locale conventions: checks conventions
src/ats_xray/engine.py - Analysis pipeline → Finding overlays: renders findings
src/ats_xray/pipeline.py - Finding overlays → Page regions: draws regions
src/ats_xray/overlay.py - Job advert → Advert parsing: provides requirements
README.md - Advert parsing → Unknown term mining: guesses unknowns
src/ats_xray/vacancy.py - Advert parsing → Skills lexicon: recognizes skills
src/ats_xray/vacancy.py - CV matching → Advert parsing: uses requirements
src/ats_xray/match.py - CV matching → Skills lexicon: matches skills
src/ats_xray/match.py - Web app → CV matching: matches CV
app.py - Web app → Advert parsing: reads advert
app.py - Web app → Action plan: builds action plan
app.py - Field recognition → Resume sections: recognizes sections
src/ats_xray/field_report.py