# saifshamsi28/jobnet-a-smart-job-finder architecture

> Architecture diagram of the GitHub repository saifshamsi28/jobnet-a-smart-job-finder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saifshamsi28/jobnet-a-smart-job-finder
- Repository: https://github.com/saifshamsi28/jobnet-a-smart-job-finder

## Overview

##### Project Type and Purpose
- This is a full-stack mobile platform (“JobNet”) with three tiers:
- Android App (Java/XML + Room)
- Spring Boot backend (Java, JWT, MongoDB)
- Python/Flask microservices (Selenium scraper + resume parser)

##### File Structure
- Top level:
- app/ – Android client module (Activities, Adapters, API, Models, Database, Utils)
- Gradle scripts & wrapper – build and dependency management
- app/src/main/java/com/saif/jobnet:
- Activities – UI screens (Login, Main, JobList, JobDetail, Profile, etc.)
- Adapters – RecyclerViews for jobs, skills, saved jobs
- Api – Retrofit client & service interfaces
- Database – Room entities, DAOs, DatabaseClient
- Models – Data classes (Job, User, Resume, Skill, Education, etc.)
- Utils – Config, converters, watchers
- Resources: layouts, drawables, menus, animations for UI

##### README for Additional Insights
- Emphasizes key technologies: Android+Room, Retrofit, Spring Boot+MongoDB, Flask+Selenium, JWT, resume parsing

##### Main Components and Their Interactions
a. Android Client
- UI Layer (Activities + Layouts)
- Data Layer
– Local Cache: Room database
– Remote API: RetrofitClient → ApiService
- Image Loading: Glide (MyGlideModule)
b. Spring Boot Backend
- REST Controllers (jobs, auth, resume upload)
- Service Layer (JWT auth, business logic)
- Data Access: MongoDB (via Spring Data)
c. Flask Scraper Microservice
- Selenium-based scraper for Naukri/Indeed
- Exposes REST endpoint to fetch new jobs
d. Flask Resume Parser
- Parses uploaded resumes to extract skills/experience
- Called by Spring Boot for recommendations
e. Data Stores & External Systems
- MongoDB – primary data store for jobs, users, resumes
- External Job Sites – Naukri, Indeed

##### Architectural Patterns and Design Principles
- Android: MVC/MVVM-style separation (Activities → Adapters → Room)
- Repository Pattern for Room + Retrofit
- RESTful API between client and backend
- Microservices separation: scraper and parser decoupled from core API
- Caching Pattern: Room for offline, MongoDB for server-side cache
- JWT for stateless, secure authentication

- Left: Android App block
- Sub-blocks: UI (Activities), Offline Cache (Room), Network Client (Retrofit)
- Center: Spring Boot Backend block
- Sub-blocks: Auth Service, Job Service, Resume Service
- Right: Microservices & Data
- Flask Scraper (→ External Sites)
- Flask Resume Parser
- Far Right: External Systems

- Android → Spring Boot:
- GET /jobs → returns list (cached in Room)
- POST /login → returns JWT
- POST /resume → triggers resume parsing & recommendations
- Spring Boot → MongoDB: read/write jobs, users, resumes
- Spring Boot → Flask Scraper: “if job not in DB” → fetch fresh from Naukri/Indeed
- Flask Scraper → External Sites: web scrape via Selenium → return jobs
- Spring Boot → Flask Parser: send uploaded resume → receive parsed data
- Spring Boot → Android: deliver parsed recommendations

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Android App Layer
    subgraph "Android App" 
        direction TB
        UI["UI Layer (Activities)"]:::mobile
        Adapters["RecyclerView Adapters"]:::mobile
        Models["Data Models"]:::mobile
        Utils["Utilities"]:::mobile
        Glide["Image Loading (Glide)"]:::mobile
        subgraph "Local Cache (Room)" 
            direction TB
            AppDB["AppDatabase"]:::mobile
            DBClient["DatabaseClient"]:::mobile
            JobDAO["JobDao"]:::mobile
        end
        subgraph "Remote API (Retrofit)"
            direction TB
            RetrofitClient["RetrofitClient"]:::mobile
            ApiService["ApiService"]:::mobile
            SkillFetcher["SkillFetcher"]:::mobile
        end
        Resources["Resources (layout, drawable, menu, anim)"]:::mobile
    end

    %% Spring Boot Backend Layer
    subgraph "Spring Boot Backend" 
        direction TB
        Controllers["REST Controllers"]:::backend
        AuthService["Auth Service (JWT)"]:::backend
        JobService["Job Service"]:::backend
        ResumeService["Resume Service"]:::backend
    end

    %% Microservices Layer
    subgraph "Flask Microservices"
        direction TB
        Scraper["Flask Scraper"]:::micro
        Parser["Flask Resume Parser"]:::micro
    end

    %% Data Stores & External
    MongoDB["MongoDB"]:::external
    Naukri["Naukri (External Site)"]:::external
    Indeed["Indeed (External Site)"]:::external

    %% Data Flows
    UI -->|"reads/writes"| AppDB
    UI -->|"calls login/jobs/resume"| RetrofitClient
    RetrofitClient -->|"fetch/update jobs"| AppDB
    RetrofitClient -->|"REST API calls"| Controllers
    Controllers -->|"auth endpoints"| AuthService
    Controllers -->|"job endpoints"| JobService
    Controllers -->|"resume endpoints"| ResumeService
    JobService -->|"CRUD"| MongoDB
    AuthService -->|"CRUD"| MongoDB
    ResumeService -->|"store resumes"| MongoDB
    JobService -->|"if missing jobs"| Scraper
    Scraper -->|"scrape via Selenium"| Naukri
    Scraper -->|"scrape via Selenium"| Indeed
    Scraper -->|"return jobs"| JobService
    ResumeService -->|"send resume"| Parser
    Parser -->|"parsed skills/experience"| ResumeService
    ResumeService -->|"recommendations"| Controllers
    Controllers -->|"response"| RetrofitClient
    RetrofitClient -->|"return data"| UI

    %% Click Events - Android
    click UI "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/tree/main/app/src/main/java/com/saif/jobnet/Activities"
    click Adapters "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/tree/main/app/src/main/java/com/saif/jobnet/Adapters"
    click Models "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/tree/main/app/src/main/java/com/saif/jobnet/Models"
    click Utils "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/tree/main/app/src/main/java/com/saif/jobnet/Utils"
    click Glide "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/blob/main/app/src/main/java/com/saif/jobnet/MyGlideModule.java"
    click AppDB "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/blob/main/app/src/main/java/com/saif/jobnet/Database/AppDatabase.java"
    click DBClient "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/blob/main/app/src/main/java/com/saif/jobnet/Database/DatabaseClient.java"
    click JobDAO "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/blob/main/app/src/main/java/com/saif/jobnet/Database/JobDao.java"
    click RetrofitClient "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/blob/main/app/src/main/java/com/saif/jobnet/Api/RetrofitClient.java"
    click ApiService "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/blob/main/app/src/main/java/com/saif/jobnet/Api/ApiService.java"
    click SkillFetcher "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/blob/main/app/src/main/java/com/saif/jobnet/Api/SkillFetcher.java"
    click Resources "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/tree/main/app/src/main/res/layout"
    click Resources "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/tree/main/app/src/main/res/drawable"
    click Resources "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/tree/main/app/src/main/res/menu"
    click Resources "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/tree/main/app/src/main/res/anim"

    %% Click Event - Android Client Root
    click AndroidApp "https://github.com/saifshamsi28/jobnet-a-smart-job-finder/tree/main/app/src/main/java/com/saif/jobnet"

    %% Styles
    classDef mobile fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef backend fill:#d4edda,stroke:#333,stroke-width:1px
    classDef micro fill:#ffe5b4,stroke:#333,stroke-width:1px
    classDef external fill:#ebebeb,stroke:#333,stroke-width:1px
```
