From a1a302f22265181388f4327dbfd1f7e81c3096bf Mon Sep 17 00:00:00 2001
From: Rehan Ansari <rehanrehman389@gmail.com>
Date: Mon, 20 Oct 2025 11:17:02 +0530
Subject: [PATCH] feat: show job applications on frontend

---
 frontend/src/pages/JobApplications.vue | 234 +++++++++++++++++++++++++
 frontend/src/pages/JobDetail.vue       |  28 ++-
 frontend/src/router.js                 |   6 +
 lms/lms/api.py                         |  50 ++++++
 4 files changed, 317 insertions(+), 1 deletion(-)
 create mode 100644 frontend/src/pages/JobApplications.vue

diff --git a/frontend/src/pages/JobApplications.vue b/frontend/src/pages/JobApplications.vue
new file mode 100644
index 00000000..a54f6865
--- /dev/null
+++ b/frontend/src/pages/JobApplications.vue
@@ -0,0 +1,234 @@
+<template>
+	<div class="">
+		<header
+			class="sticky top-0 z-10 flex items-center justify-between border-b bg-surface-white px-3 py-2.5 sm:px-5"
+		>
+			<Breadcrumbs
+				class="h-7"
+				:items="[
+					{ label: __('Jobs'), route: { name: 'Jobs' } },
+					{
+						label: job.data?.job_title,
+						route: { name: 'JobDetail', params: { job: job.data?.name } },
+					},
+					{ label: __('Applications') },
+				]"
+			/>
+		</header>
+		<div v-if="job.data" class="max-w-4xl mx-auto pt-5 p-4">
+			<div class="mb-6">
+				<h1 class="text-2xl font-semibold text-ink-gray-9 mb-2">
+					{{ __('Applications for {0}').format(job.data.job_title) }}
+				</h1>
+				<p class="text-ink-gray-6">
+					{{ applications.data?.length || 0 }}
+					{{
+						applications.data?.length === 1
+							? __('application')
+							: __('applications')
+					}}
+				</p>
+			</div>
+
+			<div v-if="applications.data?.length" class="space-y-4">
+				<div
+					v-for="application in applications.data"
+					:key="application.name"
+					class="border rounded-lg p-4 hover:border-outline-gray-3"
+				>
+					<div class="flex items-start justify-between">
+						<div class="flex items-center space-x-3">
+							<img
+								v-if="application.user_image"
+								:src="application.user_image"
+								:alt="application.full_name"
+								class="w-10 h-10 rounded-full object-cover"
+							/>
+							<div
+								v-else
+								class="w-10 h-10 rounded-full bg-surface-gray-3 flex items-center justify-center"
+							>
+								<User class="w-5 h-5 text-ink-gray-6" />
+							</div>
+							<div>
+								<h3 class="font-medium text-ink-gray-9">
+									{{ application.full_name || application.user }}
+								</h3>
+								<p class="text-sm text-ink-gray-6">{{ application.email }}</p>
+								<p class="text-xs text-ink-gray-5 mt-1">
+									{{
+										__('Applied on {0}').format(
+											dayjs(application.creation).format('MMM DD, YYYY')
+										)
+									}}
+								</p>
+							</div>
+						</div>
+						<div class="flex items-center space-x-2">
+							<Button
+								v-if="application.resume_url"
+								@click="downloadResume(application.resume_url)"
+								variant="outline"
+								size="sm"
+							>
+								<template #prefix>
+									<Download class="w-4 h-4" />
+								</template>
+								{{ __('Resume') }}
+							</Button>
+							<Button
+								@click="openEmailModal(application)"
+								variant="solid"
+								size="sm"
+							>
+								<template #prefix>
+									<Mail class="w-4 h-4" />
+								</template>
+								{{ __('Email') }}
+							</Button>
+						</div>
+					</div>
+				</div>
+			</div>
+			<EmptyState v-else type="Applications" />
+		</div>
+
+		<Dialog
+			v-model="showEmailModal"
+			:options="{
+				title: __('Send Email to {0}').format(
+					selectedApplicant?.full_name || selectedApplicant?.user
+				),
+				size: 'lg',
+				actions: [
+					{
+						label: __('Send'),
+						variant: 'solid',
+						onClick: (close) => sendEmail(close),
+					},
+				],
+			}"
+		>
+			<template #body-content>
+				<div class="space-y-4">
+					<FormControl
+						v-model="emailSubject"
+						:label="__('Subject')"
+						:placeholder="__('Enter email subject')"
+						required
+					/>
+					<div>
+						<div class="text-sm text-ink-gray-5 mb-1">
+							{{ __('Message') }}
+						</div>
+						<TextEditor
+							:content="emailMessage"
+							@change="(val) => (emailMessage = val)"
+							:editable="true"
+							:fixedMenu="true"
+							editorClass="prose-sm max-w-none border-b border-x bg-surface-gray-2 rounded-b-md py-1 px-2 min-h-[7rem]"
+						/>
+					</div>
+				</div>
+			</template>
+		</Dialog>
+	</div>
+</template>
+
+<script setup>
+import {
+	Button,
+	Breadcrumbs,
+	Dialog,
+	FormControl,
+	TextEditor,
+	createResource,
+	usePageMeta,
+	toast,
+} from 'frappe-ui'
+import { User, Download, Mail } from 'lucide-vue-next'
+import { inject, ref } from 'vue'
+import { sessionStore } from '../stores/session'
+import EmptyState from '@/components/EmptyState.vue'
+
+const dayjs = inject('$dayjs')
+const { brand } = sessionStore()
+const showEmailModal = ref(false)
+const selectedApplicant = ref(null)
+const emailSubject = ref('')
+const emailMessage = ref('')
+
+const props = defineProps({
+	job: {
+		type: String,
+		required: true,
+	},
+})
+
+const job = createResource({
+	url: 'lms.lms.api.get_job_details',
+	params: { job: props.job },
+	cache: ['job', props.job],
+	auto: true,
+	onSuccess: () => {
+		applications.submit()
+	},
+})
+
+const applications = createResource({
+	url: 'lms.lms.api.get_job_applications',
+	params: { job: props.job },
+	auto: true,
+})
+
+const emailResource = createResource({
+	url: 'lms.lms.api.send_email_to_applicant',
+})
+
+const openEmailModal = (applicant) => {
+	selectedApplicant.value = applicant
+	emailSubject.value = `Job Application for ${job.data?.job_title} - ${
+		applicant.full_name || applicant.user
+	}`
+	emailMessage.value = ''
+	showEmailModal.value = true
+}
+
+const sendEmail = (close) => {
+	if (!emailSubject.value || !emailMessage.value) {
+		toast.error(__('Please fill in all fields'))
+		return
+	}
+
+	emailResource.submit(
+		{
+			applicant_email: selectedApplicant.value.email,
+			subject: emailSubject.value,
+			message: emailMessage.value,
+			job: props.job,
+		},
+		{
+			onSuccess: () => {
+				toast.success(__('Email sent successfully'))
+				close()
+			},
+			onError: (err) => {
+				toast.error(err.messages?.[0] || err)
+			},
+		}
+	)
+}
+
+const downloadResume = (resumeUrl) => {
+	window.open(resumeUrl, '_blank')
+}
+
+usePageMeta(() => {
+	return {
+		title: job.data
+			? `Applications - ${job.data.job_title}`
+			: 'Job Applications',
+		icon: brand.favicon,
+	}
+})
+</script>
diff --git a/frontend/src/pages/JobDetail.vue b/frontend/src/pages/JobDetail.vue
index dea21e94..4d337ac4 100644
--- a/frontend/src/pages/JobDetail.vue
+++ b/frontend/src/pages/JobDetail.vue
@@ -20,6 +20,23 @@
 				v-if="user.data?.name && !readOnlyMode"
 				class="flex items-center space-x-2"
 			>
+				<router-link
+					v-if="canManageJob"
+					:to="{
+						name: 'JobApplications',
+						params: { job: job.data?.name },
+					}"
+				>
+					<Button variant="outline">
+						<template #prefix>
+							<Users class="h-4 w-4 stroke-1.5" />
+						</template>
+						{{ __('Applications') }}
+						<Badge v-if="applicationCount.data" class="ml-2">
+							{{ applicationCount.data }}
+						</Badge>
+					</Button>
+				</router-link>
 				<router-link
 					v-if="user.data.name == job.data?.owner"
 					:to="{
@@ -146,7 +163,7 @@ import {
 	createResource,
 	usePageMeta,
 } from 'frappe-ui'
-import { inject, ref } from 'vue'
+import { inject, ref, computed } from 'vue'
 import { sessionStore } from '../stores/session'
 import JobApplicationModal from '@/components/Modals/JobApplicationModal.vue'
 import {
@@ -159,6 +176,7 @@ import {
 	FileText,
 	ClipboardType,
 	BriefcaseBusiness,
+	Users,
 } from 'lucide-vue-next'
 
 const user = inject('$user')
@@ -226,6 +244,14 @@ const redirectToWebsite = (url) => {
 	window.open(url, '_blank')
 }
 
+const canManageJob = computed(() => {
+	if (!user.data?.name || !job.data) return false
+	return (
+		user.data.name === job.data.owner ||
+		user.data.roles?.includes('System Manager')
+	)
+})
+
 usePageMeta(() => {
 	return {
 		title: job.data?.job_title,
diff --git a/frontend/src/router.js b/frontend/src/router.js
index 473f1776..9b0234f8 100644
--- a/frontend/src/router.js
+++ b/frontend/src/router.js
@@ -112,6 +112,12 @@ const routes = [
 		component: () => import('@/pages/JobDetail.vue'),
 		props: true,
 	},
+	{
+		path: '/job-openings/:job/applications',
+		name: 'JobApplications',
+		component: () => import('@/pages/JobApplications.vue'),
+		props: true,
+	},
 	{
 		path: '/courses/:courseName/edit',
 		name: 'CourseForm',
diff --git a/lms/lms/api.py b/lms/lms/api.py
index 11f025a9..8071f66c 100644
--- a/lms/lms/api.py
+++ b/lms/lms/api.py
@@ -1651,6 +1651,56 @@ def get_progress_distribution(progressList):
 	return distribution
 
 
+@frappe.whitelist()
+def get_job_applications(job):
+	"""Get job applications for a specific job. Only job owner or system manager can access."""
+	job_doc = frappe.get_doc("Job Opportunity", job)
+
+	if job_doc.owner != frappe.session.user and "System Manager" not in frappe.get_roles():
+		frappe.throw(_("You don't have permission to view applications for this job"))
+
+	applications = frappe.get_all(
+		"LMS Job Application",
+		filters={"job": job},
+		fields=[
+			"name",
+			"user",
+			"resume",
+			"creation",
+			"user.full_name as full_name",
+			"user.email as email",
+			"user.user_image as user_image",
+		],
+		order_by="creation desc",
+	)
+
+	for app in applications:
+		if app.resume:
+			file_url = frappe.db.get_value("File", {"file_name": app.resume}, "file_url")
+			if file_url:
+				app.resume_url = file_url
+
+	return applications
+
+
+@frappe.whitelist()
+def send_email_to_applicant(applicant_email, subject, message, job):
+	"""Send email to job applicant. Only job owners or system managers can send emails."""
+	if "System Manager" not in frappe.get_roles():
+		job_owner = frappe.db.get_value("Job Opportunity", job, "owner")
+		if job_owner != frappe.session.user:
+			frappe.throw(_("You don't have permission to send emails for this job"))
+
+	frappe.sendmail(
+		recipients=[applicant_email],
+		subject=subject,
+		message=message,
+		now=True,
+	)
+
+	return {"success": True, "message": "Email sent successfully"}
+
+
 @frappe.whitelist(allow_guest=True)
 def get_pwa_manifest():
 	title = frappe.db.get_single_value("Website Settings", "app_name") or "Frappe Learning"