<HI/>
AIDIFFICULTY: IntermediateSTATUS: Demo

ResumeAI Optimization Platform

ATS-Aware Resume Scoring & Narrative Optimization

GitHub Repository
Client / ScopeCareer Development Platform
My RoleLead AI Engineer
Duration3 Months
Completion Date2026-03-05

1. SYSTEM OVERVIEW

Executive Summary

An AI-powered resume optimizer analyzing professional summaries against target job descriptions, providing real-time ATS scores and impact-driven writing tips.

Business Problem

Qualified software engineers get filtered out by Applicant Tracking Systems (ATS) due to poor keyword matching and failure to use metric-driven impact language.

Business Impact Value

Improves candidate callback rates by matching resumes with target keywords and restructuring sentences to follow the STAR methodology.

Key Engineering Goals
  • Assess resume keyword densities and match ratios in real time
  • Provide transparent, actionable feedback without making blind revisions
  • Create responsive sandbox editor displaying instant score updates
My System Responsibilities
  • Designed prompt constraints restricting LLM hallucinations in rewrites
  • Developed candidate summary scoring heuristics running client-side
  • Implemented clean, typography-focused layout editors

2. SYSTEM FEATURES

ATS Scoring sandboxComplexity: Low

Interactive editor evaluating keyword presence and action verbs against target goals.

Impl:Regex parsing engine scoring input against customizable rules.
LLM Impact RewriterComplexity: Medium

Secured AI rewriter transforming generic sentences into metric-driven statements.

Impl:Structured prompt layouts sending only non-PII details to LLM APIs.
Keyword Gap AnalysisComplexity: Low

Highlights target skills missing from a resume compared to job descriptions.

Impl:Array match checks parsing input strings.

3. SYSTEM ARCHITECTURE

Hybrid architecture processing lightweight parsing client-side for performance, routing content through security filters to external LLM APIs for privacy-compliant rewrites.

Topology Vector Diagram
Candidate Text + Keywords ──> Heuristic Parser (Client-Side) ──> ATS Score Dashboard
                                     │
                    [Rewrite Request]▼
               Next.js API Handler (PII Filter) ──> LLM API ──> Styled Recommendations
Pipeline flow sequences
User pastes summary and lists target keywords in inputs
Client-side engine parses text for action verbs and keyword density
ATS score panel updates instantly with score and warning metrics
User requests rewriting recommendation
Next.js endpoint filters private PII data and prompts LLM to output STAR formats
Repo directory structure
resume-ai/
├── src/
│   ├── app/
│   │   └── api/
│   │       └── rewrite/route.ts # LLM gateway
│   ├── components/
│   │   ├── Sandbox.tsx         # Text editor
│   │   └── ScoreMetric.tsx    # Telemetry indicators
│   └── utils/
│       └── parser.ts          # Regular expressions

4. INTERACTIVE SIMULATOR WIDGET

Run active operations audits utilizing the custom sandbox telemetry receiver widget below.

5. ENGINEERING ARCHITECTURE DECISIONS (ADRs)

Decision ProfileSelect execution model for AI prompt rewrites
Context

We need to keep API running costs low while ensuring absolute privacy of candidate PII.

Alternatives Checked
  • Client-side local WASM LLM
  • Direct client-to-OpenAI key calls
  • Next.js proxy middleware with sanitization
Selected Decision

Next.js proxy middleware with sanitization

Advantages
  • Protects API credentials securely within backend routes
  • Enables custom PII scrubbing of names, emails, and phone numbers before routing
  • Allows caching common keyword sets
Disadvantages
  • Slightly higher server-side routing overhead compared to direct client calls
  • Requires server hosting logic
Trade-off details

Accepted minor server middleware delay to guarantee candidate privacy and secure our LLM access keys.

Future Scaling direction

Integrate client-side local WebGPU llama models to run rewrites completely on-device for zero API costs.

6. DETAILED TECHNOLOGY STACK

frontend
• React• TypeScript• TailwindCSS
backend
• Next.js Route Handlers
security
• PII Masking filters
testing
• Jest• LLM evaluation testbeds

7. SECURITY REVIEW & POSTURE

PII Scrubbing Heuristics

Uploading full resumes to cloud LLMs violates privacy policies and risks exposing candidate contact data.

Mitigation StrategyPre-processing pipeline removing phone numbers, email strings, and street addresses before API dispatch.

8. PERFORMANCE METRICS TELEMETRY

Scoring Latency<2ms

Optim:Direct client-side regex parsing bound to text input listeners.

Rewrite Turnaround1.2s

Optim:Streaming response parsing using server-sent event APIs.

9. ENGINEERING CHALLENGES & RESOLUTIONS

Vulnerability Bottleneck

AI rewriters often made up fictitious metrics (e.g. "Scaled systems by 90%"), causing candidates to submit false claims.

Root Cause:Standard LLM prompts lacked guidelines restricting the generation of fictitious numerical facts.

System Investigation

Analyzed output history and noted that prompts like "make this sound metric-oriented" led the LLM to invent placeholder percentages.

Engineering Solution

Restructured prompts to identify existing metrics and rewrite layouts to highlight those numbers, outputting `[Insert Metric]` brackets when no numbers were provided.

Trade-offs accepted

Required users to fill in their own metrics manually, adding a small task but ensuring absolute integrity.

Lessons Derived

Generative AI must be constrained by strict rules when accuracy is critical; it should frame truth, not invent it.

10. SYSTEM LESSONS LEARNED

Engineering Lessons

Always run LLM calls asynchronously; frontend editors must remain interactive during long API waits.

Architecture Lessons

Decoupling scoring logic from writing logic allowed us to provide free instant scoring without incurring LLM costs.

Business Lessons

Transparency is key; explaining WHY a score changed builds trust and helps candidates learn.

System Redesign Plans

I would implement a drag-and-drop PDF parser to extract data from existing files instantly.

11. ROADMAP & TECHNICAL DEBT

  • Add PDF resume parsing and generation directly in the workspace
  • Support multi-language translation and scoring targets
  • Provide role benchmarks derived from real LinkedIn job descriptions

12. GITHUB SOURCE EXPLORER

Audit raw repository script configurations directly inside the active terminal workspace.

HarizuAru/Portfoliomain
Open on GitHub
Workspace Files
1
Encoding: UTF-8Lines: 1
Let's discuss your project

Interested in building a secure auto-scaling platform similar to this?