Skip to main content

What is ION Career?

ION Career is a Frappe framework application that extends ERPNext’s HR module with intelligent job application screening capabilities. Built by ARD, it automates the candidate evaluation process through dynamic questionnaires and automated scoring.

Key Features

Dynamic Screening Questions

Create custom question sets for each job opening with flexible input types and required field validation

Automated Scoring

Automatically calculate candidate scores based on their answers to screening questions

Custom Web Forms

Integrated web forms for public-facing job applications with dynamic question loading

ERPNext Integration

Seamlessly extends Job Opening and Job Applicant doctypes with custom fields and workflows

How It Works

ION Career enhances the standard ERPNext recruitment workflow:
  1. Question Set Creation: Create reusable question sets with custom screening questions
  2. Job Opening Configuration: Link question sets to specific job openings
  3. Application Submission: Candidates answer screening questions through web forms
  4. Automatic Processing: The system automatically:
    • Validates required answers
    • Stores responses in structured format
    • Calculates applicant scores (0-10 scale)
    • Links answers to job applicant records

Architecture

The app consists of three core doctypes:
  • Job Question Set: Container for screening questions with a title and question list
  • Job Question: Individual questions with field names, input types, and validation rules
  • Job Applicant Question Answer: Stores individual answers linked to applicants
Custom fields are automatically added to:
  • Job Opening: custom_job_question_set link field (required)
  • Job Applicant: Score field, questions tab, and answer storage fields

Quick Start

Installation

Install ION Career using bench CLI and set up prerequisites

Configuration

Configure fixtures, custom fields, and module settings

Create Question Sets

Build your first screening question set for job openings

Web Forms

Set up public-facing job application forms

Use Cases

  • Technical Screening: Ask programming language experience or certification questions
  • Compliance Checks: Verify licensing, eligibility, or background requirements
  • Cultural Fit: Assess values alignment through Yes/No or multiple-choice questions
  • Automated Filtering: Pre-screen large applicant pools based on minimum score thresholds

Technology Stack

  • Framework: Frappe Framework
  • Base Application: ERPNext (HR Module)
  • Language: Python 3.8+
  • License: MIT

Build docs developers (and LLMs) love