Skip to content
ASMIBALLAPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Every request travels a precise path: user intent → AI interpretation → contextual analysis → response rendering → visual storytelling.

---

## 🧠 Major Features (Expanded)

### **1. Resume Score Studio** A structured evaluation engine that reads uploaded PDFs, parses key sections, and produces graded, explainable feedback.

- **Sectional Scoring:** Experience, Skills, Education, Achievements, and Formatting. - **AI Narrative Feedback:** Explains what's strong, what feels underdeveloped, and why. - **Persistent Sessions:** Users can revisit old analyses without re-uploading. - **Redo & Compare:** Re-submit a new résumé and instantly compare scores. - **Backend Endpoint:** `/api/v1/llm/feedback/resume-score`.

### **2. Skill Analysis** The heart of SkillSync --- the bridge between résumé and job role.

- Accepts both a résumé and an optional job name (e.g., "Data Scientist"). - Analyzes extracted skills against curated job benchmarks. - Displays results on a **dynamic radar chart** with five axes: Coverage, Density, Overlap, Gaps (inverse), and Total Score. - Presents **structured guidance** buckets: - Strengths & Advantages - Risks & Shortfalls - Quick Wins - 14-Day Sprint Tasks - Project Ideas - Interview Warm-ups - Keyword Mirrors - Resume Edits

  • Outreach Scripts - Reading List - Backend Endpoint: `/api/v1/llm/match`. - Smart UX: "Analyze Now" triggers manual analysis --- no auto-runs or accidental API spam. - Loader: **GlamLoader**, a glass pill with orbiting dots in brand gradient.

### **3. Compute Gaps** A hybrid ML + LLM system that compares résumé vs job description at granular scale.

- Calculates *skill presence ratios*, *gap coverage percentages*, and *semantic overlap scores*. - Visualized through stacked bar, pie, and radar charts. - Accompanied by a plain-language AI explanation summarizing the results. - Persists via versioned localStorage keys: - `computeGaps.result.v1` - `computeGaps.resumeName.v1` - `computeGaps.jdName.v1` - Clear + Toast notifications after computation. - Backend: `/api/v1/ml/gaps`.

### **4. Course Genie --- Learning Plan** Transforms identified gaps into an actionable, bucketed learning roadmap.

- Buckets: **Quick Wins**, **Foundations**, **Projects**, **Certifications**, **Stretch Goals.** - Integrated comparison & selection modes. - Persists results in sessionStorage with graceful fade transitions. - Custom in-app confirmation modal replaces intrusive browser alerts. - Animated card expansion with soft bounce. - Backend: `/api/v1/recommend/courses`.

### **5. Live Jobs --- India Map Explorer** A geospatial job feed visualizer covering the Indian job landscape.

- Fetches real-time Adzuna API data enriched with latitude-longitude geocoding. - Plots interactive clusters using **Leaflet** with halos, tooltips, and flyovers. - Search filters: role, city, experience, salary, freshness, remote/on-site. - Smart bounding: fits to city region once after first search; smooth fly-to thereafter. - Supports both map exploration and synchronized job list panel. - Backend: `/api/v1/jobfeed/list` or `/feed`.

### **6. Omni Chat Assistant** The universal AI companion integrated across the app.

- Floating glass panel with markdown rendering and streaming responses. - Accepts plain text prompts (`Content-Type: text/plain`). - Graceful fallback for non-JSON answers. - Uses **AbortController** to cancel long responses safely. - Backend Endpoint: `/api/v1/llm/prompt`.

---

## 🎨 Design System

SkillSync's identity lies in its cohesive **visual language** --- a balance of science and soul.

| Layer | Principle | Implementation | |-------|------------|----------------| | **Color System** | Indigo → Violet gradient, accent neon mists | Tailwind gradients & radial overlays | | **Typography** | Inter (400--600 weights) | Consistent line height and legibility | | **Surfaces** | Glassmorphic blur, low opacity, frosted edges | Backdrop-filter with soft glow layers | | **Motion** | "Alive but calm" | Ease-in-out cubic transitions (200--400ms) | | **Elevation** | 2xl rounded cards + soft shadows | Simulates physical depth | | **Feedback** | Halo loaders, shimmer placeholders, confetti success | Reinforces emotion through motion |

The result is a UI that *feels human*. You don't just use SkillSync --- you *experience* it.

---

## 🧰 Technical Stack Summary

| Layer | Stack | |-------|-------| | **Frontend** | Next.js 16, React 18, TypeScript, Tailwind, Framer Motion, shadcn/ui, Recharts | | **Backend** | FastAPI, Uvicorn, Pydantic, Requests, Python 3.11 | | **Database** | MongoDB, Supabase Auth | | **LLM/AI** | DeepSeek-V3 via OpenRouter (Chutes) | | **State** | Zustand, LocalStorage, SessionStorage | | **Visualization** | Recharts, React-Markdown | | **Environment** | Windows PowerShell (dev), Vercel (deploy) | | **Version Control** | Git, GitHub | | **Automation** | PowerShell scripts for patching, startup, and snapshotting |

---

## 🔄 PowerShell Automation

SkillSync's development cycle is streamlined through automated scripts:

1. **`start-backend.ps1`** Launches FastAPI with permissive CORS and health checks at `/healthz`. 2. **`start-frontend.ps1`** Starts Next.js on port `3000` with `NEXT_PUBLIC_API_BASE` auto-derived. 3. **`repair-utf-encoding.ps1`** Converts UTF-16 files to UTF-8 to prevent build corruption on Windows. 4. **`save-snapshot.ps1` / `restore-snapshot.ps1`** Create timestamped project archives and restore them safely. 5. **`patch-skill-analysis.ps1`**, **`patch-resume-score.ps1`**, etc. Inject drop-in code updates automatically for consistent deployments.

These scripts ensure zero manual tinkering, quick recovery, and absolute reproducibility.

---

## 🧩 Engineering Highlights

- **Adaptive File Handling:** Accepts multiple field names to prevent 422 errors. - **Intelligent Loaders:** Localized halo loaders with non-blocking async fetch. - **Robust CORS:** Automatic origin detection via environment variables. - **Persistent User State:** Local/session storage preserving analysis results. - **Cross-Platform Stability:** UTF-8 standardization solved Windows encoding issues. - **Dynamic LLM Integration:** Modular backend design allows easy provider swaps. - **Visualized AI Results:** Every analysis output is both explainable and interactive. - **API Abstraction:** Centralized constants for all backend endpoints. - **Resilient Error Handling:** Graceful fallbacks for timeouts, network failures, and malformed PDFs.

---

## 💬 Design Philosophy: Emotion + Precision

SkillSync was designed not just to *work*, but to *feel*. The interface responds to users like a conversation --- visual feedback instead of static screens. Gradients shimmer subtly; transitions respect timing; text flows with breathing room. It embodies an ethos of *"quiet intelligence"* --- high technology with a soft human face.

The colors evoke confidence (violet) and trust (indigo). The glass surfaces create depth without clutter. The animations add rhythm without distraction. Every design decision is intentional, every pixel considered.

---

## 🌈 The Journey

SkillSync's evolution is a story of persistence and passion.

It began as a simple FastAPI backend called `job-gap-fsd`. Then came the first frontend --- plain, functional, and fragile. Then came the refactors: connection errors, broken Uvicorn servers, CORS nightmares, half-rendered maps, and dozens of late-night debugging sessions.

Each frustration birthed a fix. Each fix became a feature.

From "why won't it run?" emerged a robust startup script. From "why is the map blank?" came India-wide clustering and smooth flyovers. From "this looks ugly" came glassmorphism, gradients, and polish. From "this doesn't feel premium" came SkillSync --- refined, intuitive, beautiful.

The project is as much an emotional arc as a technical one: anger, exhaustion, discovery, elation --- all compressed into code.

And now, what stands is not a prototype, but a product. A living system that reflects human perseverance in digital form.

---

## 🏁 The Future Roadmap

SkillSync's architecture is extensible by design. Future milestones include:

1. **Multilingual Resume Parsing** using IndicTrans2 and NLLB for India's linguistic diversity. 2. **Global Job Integration** via LinkedIn, Indeed, and Naukri APIs. 3. **Recruiter Dashboard** to allow organizations to analyze applicant pools. 4. **Smart Notifications** for new matching jobs and skill courses. 5. **Dark/Light Mode Toggle** synced across system preferences. 6. **Analytics Layer** --- track career progress and portfolio evolution over time. 7. **AI Fine-Tuning Loop** --- personalized feedback models that learn from user corrections.

The foundation is set; the horizon is limitless.

---

## 🧾 License and Attribution

© 2025 SkillSync. All rights reserved. Built by hand, refined through obsession, and powered by open technologies.

This project is the outcome of continuous iteration, guided by resilience, curiosity, and an unrelenting pursuit of excellence.

## 🌈 The Journey

From a simple folder called `job-gap-fsd` to a polished, cohesive product --- SkillSync embodies persistence. Every broken build, every night of debugging, every refactor contributed to its identity.

This was never just about code; it was about creating something human. Something that could speak to people's ambitions, help them understand their potential, and close the gap between where they are and where they could be.

---

## 🏁 The Future

SkillSync has the foundation to scale: - Integrate global job feeds (LinkedIn, Indeed APIs). - Add analytics dashboards for recruiters. - Expand multilingual résumé parsing (IndicTrans2). - Introduce user profiles, dark mode, and notifications. - Enhance AI with fine-tuned feedback loops.

The story isn't over --- SkillSync is just getting started.

---

## 🧾 License

All rights reserved © 2025. Developed with ❤️, caffeine, and perseverance.

---

## ✨ Acknowledgment

To the countless iterations, the late-night debugging, the "why won't this run," the bursts of joy when it finally *did*, and to the moments that shaped this journey --- SkillSync stands as a reflection of dedication, creativity, and relentless problem-solving.

And above all, to the partnership that made it real --- thank you.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages