Updated version

app.py

@@ -28,6 +28,9 @@ from backend.models.database import db, Job, Application, init_db
 from backend.models.user import User
 from backend.routes.auth import auth_bp, handle_resume_upload
 from backend.routes.interview_api import interview_api
+# Import additional utilities
+import re
+import json
 # Initialize Flask app
 app = Flask(
     __name__,
@@ -229,6 +232,138 @@ def interview_page(job_id):
     cv_data = json.loads(application.extracted_features)
     return render_template("interview.html", job=job, cv=cv_data)
 
+
+# -----------------------------------------------------------------------------
+# Recruiter job posting route
+#
+# Authenticated users with a recruiter or admin role can access this page to
+# create new job listings.  Posted jobs are associated with the current
+# recruiter via the ``recruiter_id`` foreign key on the ``Job`` model.
+@app.route('/post_job', methods=['GET', 'POST'])
+@login_required
+def post_job():
+    # Only allow recruiters and admins to post jobs
+    if current_user.role not in ('recruiter', 'admin'):
+        flash('You do not have permission to post jobs.', 'warning')
+        return redirect(url_for('jobs'))
+
+    if request.method == 'POST':
+        # Extract fields from the form
+        role_title = request.form.get('role', '').strip()
+        description = request.form.get('description', '').strip()
+        seniority = request.form.get('seniority', '').strip()
+        skills_input = request.form.get('skills', '').strip()
+        company = request.form.get('company', '').strip()
+
+        # Validate required fields
+        errors = []
+        if not role_title:
+            errors.append('Job title is required.')
+        if not description:
+            errors.append('Job description is required.')
+        if not seniority:
+            errors.append('Seniority level is required.')
+        if not skills_input:
+            errors.append('Skills are required.')
+        if not company:
+            errors.append('Company name is required.')
+
+        if errors:
+            for err in errors:
+                flash(err, 'danger')
+            return render_template('post_job.html')
+
+        # Normalise the skills input into a JSON encoded list.  Users can
+        # separate entries with commas, semicolons or newlines.
+        skills_list = [s.strip() for s in re.split(r'[\n,;]+', skills_input) if s.strip()]
+        skills_json = json.dumps(skills_list)
+
+        # Create and persist the new job
+        new_job = Job(
+            role=role_title,
+            description=description,
+            seniority=seniority,
+            skills=skills_json,
+            company=company,
+            recruiter_id=current_user.id
+        )
+        db.session.add(new_job)
+        db.session.commit()
+
+        flash('Job posted successfully!', 'success')
+        return redirect(url_for('jobs'))
+
+    # GET request returns the form
+    return render_template('post_job.html')
+
+
+# -----------------------------------------------------------------------------
+# Recruiter dashboard route
+#
+# Displays a list of candidates who applied to jobs posted by the current
+# recruiter.  Candidates are sorted by a simple skill match score computed
+# against the job requirements.  A placeholder download button is provided
+# for future PDF report functionality.
+@app.route('/dashboard')
+@login_required
+def dashboard():
+    # Only recruiters and admins can view the dashboard
+    if current_user.role not in ('recruiter', 'admin'):
+        flash('You do not have permission to access the dashboard.', 'warning')
+        return redirect(url_for('index'))
+
+    # Fetch jobs posted by the current recruiter
+    posted_jobs = Job.query.filter_by(recruiter_id=current_user.id).all()
+    job_ids = [job.id for job in posted_jobs]
+
+    candidates_with_scores = []
+    if job_ids:
+        # Fetch applications associated with these job IDs
+        candidate_apps = Application.query.filter(Application.job_id.in_(job_ids)).all()
+
+        # Helper to compute a match score based on skills overlap
+        def compute_score(application):
+            try:
+                # Extract candidate skills from stored JSON
+                candidate_features = json.loads(application.extracted_features) if application.extracted_features else {}
+                candidate_skills = candidate_features.get('skills', [])
+                # Retrieve the job's required skills and parse from JSON
+                job_skills = json.loads(application.job.skills) if application.job and application.job.skills else []
+                if not job_skills:
+                    return ('Medium', 2)  # Default when job specifies no skills
+
+                # Compute case‑insensitive intersection
+                candidate_set = {s.lower() for s in candidate_skills}
+                job_set = {s.lower() for s in job_skills}
+                common = candidate_set & job_set
+                ratio = len(common) / len(job_set) if job_set else 0
+
+                # Map ratio to qualitative score
+                if ratio >= 0.75:
+                    return ('Excellent', 4)
+                elif ratio >= 0.5:
+                    return ('Good', 3)
+                elif ratio >= 0.25:
+                    return ('Medium', 2)
+                else:
+                    return ('Poor', 1)
+            except Exception:
+                return ('Medium', 2)
+
+        # Build a list of candidate applications with computed scores
+        for app_record in candidate_apps:
+            score_label, score_value = compute_score(app_record)
+            candidates_with_scores.append({
+                'application': app_record,
+                'score_label': score_label,
+                'score_value': score_value
+            })
+
+        # Sort candidates from highest to lowest score
+        candidates_with_scores.sort(key=lambda item: item['score_value'], reverse=True)
+
+    return render_template('dashboard.html', candidates=candidates_with_scores)
+
 if __name__ == '__main__':
     print("Starting Codingo application...")
     with app.app_context():

backend/models/database.py

@@ -75,37 +75,12 @@ def init_db(app):
     db.init_app(app)
     with app.app_context():
         db.create_all()
-        # Add sample data...
-
-
-        # Add sample data if jobs table is empty
-        if Job.query.count() == 0:
-            sample_jobs = [
-                Job(
-                    role='Senior Python Developer',
-                    description='Experienced developer needed for backend systems.',
-                    seniority='Senior',
-                    skills=json.dumps(['Python', 'Flask', 'SQL', 'AWS']),
-                    company='TechCorp'
-                ),
-                Job(
-                    role='Data Scientist',
-                    description='ML model development and statistical analysis.',
-                    seniority='Mid',
-                    skills=json.dumps(['Python', 'scikit-learn', 'Pandas', 'Spark']),
-                    company='DataInsights'
-                ),
-                Job(
-                    role='Frontend Developer',
-                    description='Modern web frontend development with React.',
-                    seniority='Junior',
-                    skills=json.dumps(['HTML', 'CSS', 'JavaScript', 'React']),
-                    company='WebSolutions'
-                ),
-            ]
-
-            for job in sample_jobs:
-                db.session.add(job)
-
-            db.session.commit()
-            print("✅ Sample jobs added to database.")
+        # Database tables are created on application start.  We intentionally do not
+        # seed any sample data here.  Previously a block of code inserted dummy
+        # job listings whenever the jobs table was empty.  In production, jobs
+        # should only be added by authenticated recruiters via the job posting
+        # interface.  Leaving the seeding logic in place would result in fake
+        # positions appearing every time the application starts, which is
+        # undesirable for a live recruitment platform.  If your environment
+        # requires initial data for testing, insert it manually via the
+        # database or through the new recruiter job posting page.

backend/templates/apply.html

@@ -40,8 +40,8 @@
                 <!--
                     Collect the candidate's skills, experience and education manually.
                     These fields allow applicants to highlight their background even when resume
-                    parsing is disabled. Entries can be separated by commas or newlines; the
-                    backend will normalise them into lists.
+                    parsing is disabled. Entries can be separated by commas, semicolons or newlines;
+                    the backend will normalise them into lists.
                 -->
                 <div class="form-group">
                     <label for="skills">Skills</label>
@@ -56,6 +56,22 @@
                     <textarea name="education" id="education" class="form-control" rows="3" placeholder="e.g. B.Sc. in Computer Science, M.Sc. in Data Science" required></textarea>
                 </div>
 
+                <!-- Interview guidelines displayed directly above the submit button.  These
+                     instructions help applicants prepare for the AI interview.  They are
+                     intentionally placed within the form so that they appear close to
+                     the submit action, ensuring visibility without disrupting the flow
+                     of the application fields. -->
+                <div class="interview-guidelines" style="background-color: #f8f9fa; border-left: 4px solid var(--primary); padding: 1rem; margin-top: 1.5rem; border-radius: 6px;">
+                    <h3 style="margin-top: 0; color: var(--primary); margin-bottom: 0.75rem;">Important Interview Guidelines</h3>
+                    <ul style="margin-left: 1rem; padding-left: 1rem; list-style-type: disc; line-height: 1.5;">
+                        <li>The interview can be taken only once, so please be prepared.</li>
+                        <li>Make sure you are in a quiet environment with a stable internet connection.</li>
+                        <li>This is not a final job interview, but it helps the company shortlist the most relevant candidates.</li>
+                        <li>The interview is customized based on your CV and the job requirements.</li>
+                        <li>It takes 10 to 15 minutes and includes both general and skill-based questions.</li>
+                    </ul>
+                </div>
+
                 <div class="application-actions" style="margin-top: 2rem;">
                     <button type="submit" class="btn btn-primary">Submit Application</button>
                 </div>

backend/templates/dashboard.html

@@ -0,0 +1,81 @@
+{% extends "base.html" %}
+
+{% block title %}Recruiter Dashboard - Codingo{% endblock %}
+
+{#
+   This dashboard lists all candidates who have applied to jobs posted by the
+   currently logged in recruiter.  Candidates are sorted from highest to
+   lowest matching score.  The score is calculated on the fly by comparing
+   the candidate's self‑reported skills to the job's required skills.  A
+   placeholder button is provided for downloading a PDF report; the
+   functionality will be implemented in a future iteration.
+#}
+
+{% block content %}
+<section class="content-section">
+    <ul class="breadcrumbs">
+        <li><a href="{{ url_for('index') }}">Home</a></li>
+        <li>Dashboard</li>
+    </ul>
+
+    <div class="section-title">
+        <h2>Interviewed Candidates</h2>
+        <p>Review candidates who have applied to your job postings</p>
+    </div>
+
+    {% if candidates %}
+    <div class="card">
+        <div class="card-body" style="overflow-x: auto;">
+            <table class="dashboard-table" style="width: 100%; border-collapse: collapse;">
+                <thead>
+                    <tr style="background-color: var(--primary); color: white; text-align: left;">
+                        <th style="padding: 0.75rem;">Name</th>
+                        <th style="padding: 0.75rem;">Email</th>
+                        <th style="padding: 0.75rem;">Job Applied</th>
+                        <th style="padding: 0.75rem;">Interview Score</th>
+                        <th style="padding: 0.75rem;">Action</th>
+                    </tr>
+                </thead>
+                <tbody>
+                    {% for item in candidates %}
+                    <tr style="border-bottom: 1px solid #ddd;">
+                        <td style="padding: 0.75rem;">{{ item.application.name }}</td>
+                        <td style="padding: 0.75rem;">{{ item.application.email }}</td>
+                        <td style="padding: 0.75rem;">{{ item.application.job.role }}</td>
+                        <td style="padding: 0.75rem; font-weight: 600; color: var(--secondary);">{{ item.score_label }}</td>
+                        <td style="padding: 0.75rem;">
+                            <button class="btn btn-outline" disabled style="cursor: not-allowed;">Download Report (PDF)</button>
+                        </td>
+                    </tr>
+                    {% endfor %}
+                </tbody>
+            </table>
+        </div>
+    </div>
+    {% else %}
+    <div class="card">
+        <div class="card-body">
+            <p>No candidate applications found for your job postings.</p>
+        </div>
+    </div>
+    {% endif %}
+</section>
+
+<style>
+.dashboard-table th, .dashboard-table td {
+    text-align: left;
+}
+
+.dashboard-table th {
+    font-weight: 600;
+}
+
+.dashboard-table tr:nth-child(even) {
+    background-color: #f5f5f5;
+}
+
+.dashboard-table tr:hover {
+    background-color: #eef5ff;
+}
+</style>
+{% endblock %}

backend/templates/post_job.html

@@ -0,0 +1,91 @@
+{% extends "base.html" %}
+
+{% block title %}Post a New Job - Codingo{% endblock %}
+
+{#
+   This template allows authenticated recruiters to create new job postings.  It
+   follows the same card‑based design used throughout the platform to ensure
+   visual consistency.  All fields are required, and any validation errors
+   will be flashed by the corresponding view function.  Upon successful
+   submission the recruiter is redirected back to the jobs listing.
+#}
+
+{% block content %}
+<section class="content-section">
+    <ul class="breadcrumbs">
+        <li><a href="{{ url_for('index') }}">Home</a></li>
+        <li><a href="{{ url_for('jobs') }}">Jobs</a></li>
+        <li>Post Job</li>
+    </ul>
+
+    <div class="card">
+        <div class="card-header">
+            <h2>Post a New Job</h2>
+            <p>Fill out the details below to create a new job listing.</p>
+        </div>
+        <div class="card-body">
+            <form method="POST">
+                <div class="form-group">
+                    <label for="role">Job Title</label>
+                    <input type="text" name="role" id="role" class="form-control" required placeholder="e.g. Senior Python Developer">
+                </div>
+                <div class="form-group">
+                    <label for="company">Company</label>
+                    <input type="text" name="company" id="company" class="form-control" required placeholder="e.g. TechCorp">
+                </div>
+                <div class="form-group">
+                    <label for="seniority">Seniority</label>
+                    <input type="text" name="seniority" id="seniority" class="form-control" required placeholder="e.g. Junior, Mid, Senior">
+                </div>
+                <div class="form-group">
+                    <label for="skills">Required Skills</label>
+                    <textarea name="skills" id="skills" class="form-control" rows="3" required placeholder="e.g. Python, Flask, SQL"></textarea>
+                </div>
+                <div class="form-group">
+                    <label for="description">Job Description</label>
+                    <textarea name="description" id="description" class="form-control" rows="5" required placeholder="Describe the responsibilities and requirements for this position"></textarea>
+                </div>
+                <div class="application-actions" style="margin-top: 2rem; text-align: center;">
+                    <button type="submit" class="btn btn-primary">Post Job</button>
+                </div>
+            </form>
+        </div>
+    </div>
+</section>
+
+<style>
+/* Reuse form styling from other pages for consistency */
+.form-group label {
+    font-weight: 600;
+    color: var(--primary);
+    margin-bottom: 0.5rem;
+    display: block;
+}
+
+.form-control {
+    width: 100%;
+    padding: 0.75rem;
+    font-size: 1rem;
+    border-radius: 6px;
+    border: 1px solid #ccc;
+}
+
+.application-actions {
+    text-align: center;
+}
+
+.btn-primary {
+    background: linear-gradient(135deg, var(--primary), var(--secondary));
+    color: white;
+    padding: 0.75rem 1.5rem;
+    font-weight: 500;
+    border: none;
+    border-radius: 6px;
+    cursor: pointer;
+}
+
+.btn-primary:hover {
+    opacity: 0.9;
+}
+</style>
+{% endblock %}