1. Core Functionalities Implemented

In-depth breakdown of the 5 prioritized engineering modules engineered for the mobile recruitment application.

Mobile ATS & Pipeline Management

Interactive Kanban Pipeline: Swipe-friendly stage transitions (Applied, Screened, Technical Interview, Manager Interview, Offered, Hired, Archived).
Real-Time Stage Sync: Immediate state synchronization across mobile recruiter apps, candidate status portals, and hiring manager dashboards.
Batch Candidate Actions: Ability to fast-track, reject, or re-assign multiple candidate dossiers with single gesture controls.
Custom Hiring Stages: Dynamic configuration of recruitment workflows per department or specialized requisition.
Automated Audit Trail: Complete historical timestamping of all candidate status transitions and stage durations.

Centralized In-App Communication Hub

Multi-Channel Unified Inbox: Aggregates in-app instant chat, SMS text alerts, and email threads inside the candidate’s unified dossier.
Smart Template Dispatcher: Rapid 1-tap dispatch of interview invitations, prep guides, and status notifications with personalized dynamic variables.
Internal Collaboration Notes: Private @mention threads between recruiters and hiring managers attached to candidate profiles.
Instant Push Notifications: High-priority alerts for new messages, interview confirmations, and urgent candidate responses.
Communication Privacy Shield: Masks personal phone numbers and routes interactions securely through cloud telephony and socket channels.

Digital Offer & E-Signatures

Dynamic Offer Package Builder: Auto-populates base salary, bonuses, equity, benefits, joining date, and departmental terms from verified templates.
Pre-Offer Approval Gate: Automatic sequential routing for management and financial sign-off before candidate release.
Mobile-Native Digital E-Signing: Candidates can review terms and sign legally binding digital agreements directly on smartphone screens.
Live Offer Tracking & Expiry: Real-time status indicators (Draft, Pending Approval, Sent, Viewed, Signed, Expired) with automated reminder triggers.
Automated Pre-Onboarding Handshake: Instantly generates counter-signed PDF packages and triggers pre-boarding asset provisioning upon acceptance.

Talent Pooling & Analytics

Silver-Medalist Talent Pools: Automated segmentation of runner-up candidates tagged by skill sets, past scores, and seniority for instant future redispatch.
Smart Tagging & Fast Search: Instant filterable query engine by skill tag, experience tier, location preference, and availability status.
Executive KPI Dashboard: Real-time mobile visualizations for Time-to-Fill, Cost-per-Hire, Funnel Conversion Velocity, and Sourcing Efficiency.
Hiring Velocity Metrics: Stage-by-stage bottleneck detection revealing turnaround times across interviewers and approvers.
Talent Community Re-engagement: 1-click broadcast campaigns to re-engage qualified archived candidates when matching requisitions open.

One-Tap In-App Approval Workflows

Instant Mobile Sign-Offs: Executive approvers review salary bands, headcount requisitions, and offer letters with single-tap biometric confirmation (FaceID / TouchID).
Sequential & Parallel Routing: Supports configurable multi-tier approval chains (Hiring Manager -> Department Head -> HR Director -> CFO).

Contextual Rich Approval Cards: Summarizes candidate profile, market salary benchmark comparisons, budget variance, and justification notes on a single mobile screen.
Instant Feedback & Revision Loop: Approvers can request revisions with inline comments or reject with structured reasons instantly notifying recruiters.

2. System Actors & Roles

The mobile recruitment system defines 4 distinct human user roles and 1 automated system engine that collaborate continuously.

1. Candidate

Job Seeker / Applicant

Submits applications & cloud resumes.
Tracks real-time hiring stage progress.
Directly chats with recruiters.
Self-schedules interview slots.
Reviews & e-signs digital offer letters.

2. Recruiter

Talent Acquisition Lead

Manages visual ATS Kanban pipeline.
Dispatches template & custom messages.
Builds and routes offer packages.
Tags & sources from talent pools.
Monitors hiring speed and KPIs.

3. Hiring Manager

Department Lead / Evaluator

Initiates job requisitions & headcount.
Evaluates candidate profiles on mobile.
Submits digital scorecards & notes.
Participates in internal team chats.
Recommends candidate offer terms.

4. Approver

HR Director / VP / Finance

Receives priority approval notifications.
Inspects salary variance & budgets.
Authorizes job requisitions & offers with 1-tap.
Requests revisions with inline remarks.
Audits compliance and hiring KPIs.

3. Detailed Operations Matrix Across Functionalities

Comprehensive mapping of operations performed by each actor across all 5 core functionalities, linked directly to the underlying transactional entities.

Functionality 1: Mobile Applicant Tracking & Pipeline (ATS)

Candidate Operations:

Submit mobile job application with profile data. [APPLICATION]
View real-time stage badge in applicant tracker. [STAGE_LOG]
Receive automated push updates upon stage progression.

Recruiter Operations:

Drag-and-drop or swipe candidate cards between stages. [STAGE_LOG]
Filter pipeline by job requisition, rating, or stage.
Bulk-transition or reject candidates with auto-feedback templates.

Hiring Manager Operations:

Review shortlisted candidate profile summaries & resumes.
Move candidate to "Interview Scheduled" or "Decision Pending".
Archive unsuitable candidates with rejection rationale tags.

Functionality 2: Centralized In-App Communication Hub

Candidate Operations:

Send direct inquiries to assigned recruiter via in-app chat. [MESSAGE]
Receive interactive interview reminders with response buttons.
Access historical conversation thread anytime.

Recruiter Operations:

Broadcast interview invites via unified SMS/Email/Chat channels. [COMM_LOG]
Trigger pre-written personalized response templates.
Tag Hiring Managers in private candidate discussion threads.

Hiring Manager Operations:

Post private evaluation notes and @mentions for recruiters. [NOTE]
Clarify candidate availability and interview logistics directly.
Review full communication history before conducting interviews.

Functionality 3: Digital Offer Management & E-Signatures

Recruiter Operations:

Generate offer package from dynamic compensation templates. [OFFER]
Initiate approval request chain to Approvers. [APPROVAL_REQ]
Dispatch approved digital offer with custom expiration timer.

Candidate Operations:

Review interactive compensation and benefit breakdown.
Sign legally binding offer contract using mobile touchscreen signature. [E_SIGNATURE]
Download executed PDF contract and receive pre-onboarding checklist.

Approver Operations:

Inspect offer salary against approved budget bands.
Approve or reject compensation packages via 1-tap verification.
Receive confirmation of signed acceptance to update headcount.

Functionality 4: Talent Pooling & Recruitment Analytics

Recruiter Operations:

Tag high-potential runner-up candidates into specialized Talent Pools. [TALENT_POOL]
Execute multi-attribute search across skills, ratings, and past stages.
Redispatch new job opportunities to pooled talent in 1-tap campaigns.

Hiring Manager Operations:

Monitor department Time-to-Hire and Offer Acceptance ratios. [METRIC_LOG]
Identify interview bottlenecks and evaluation turnaround delays.
Source directly from pre-vetted department talent pools.

Approver / Exec Operations:

Analyze enterprise recruitment spend, agency costs, and Cost-per-Hire.
Evaluate hiring channel effectiveness (Referrals vs. Inbound vs. Outbound).
Review talent pipeline health against quarterly corporate growth targets.

Functionality 5: One-Tap In-App Approval Workflows

Hiring Manager Operations:

Submit new headcount / job requisition request with budget range. [REQUISITION]
Request compensation exception for exceptional candidates.
Track real-time approval status across executive sign-off chain.

Approver Operations:

Receive actionable rich push notification on mobile device. [APPROVAL_REQ]
Inspect candidate dossier, salary comparison, and ROI justification.
Authorize with 1-Tap Biometric Confirmation or reject with revision note.

Recruiter Operations:

Receive instantaneous clearance notification to publish job or issue offer.
View approver timestamps and comments directly inside the audit history.
Resubmit modified proposals if revision requested by executive approver.

4. Information Flow & System Architecture Diagram

Visual representation of the end-to-end data flow, event triggers, and inter-actor communication protocols across all 5 recruitment functionalities.

Recruitment Mobile Information Flow Diagram

Swimlane information and action flow across Candidate, Recruiter, Hiring Manager, Approver, and the ATS Engine.

Recruitment Architecture & Actor Information Flow Diagram

Stage 01

Requisition & Approval

Manager submits headcount -> Approver gives 1-tap mobile signoff -> Job published.

Stage 02

Apply & Sourcing

Candidate applies via cloud resume or recruiter sources from talent pool.

Stage 03

Pipeline & Chat

Recruiter advances ATS Kanban -> In-app direct chat coordinates interview schedules.

Stage 04

Offer & E-Sign

Exec approves offer package -> Candidate reviews terms and e-signs on mobile.

Stage 05

Pooling & Analytics

Silver-medalists tagged to pool -> Executive dashboard aggregates recruitment KPIs.

5. Proposed Data Models & JSON Schemas

Complete architectural specifications for the Master and Transactional entities driving the 5 recruitment functionalities.

Master Data Schemas

Core entities containing system profiles, job requisitions, and talent taxonomies.

1. USER & CANDIDATE_PROFILE

{
  "userId": "uuid",
  "email": "candidate@example.com",
  "fullName": "Alex Morgan",
  "role": "CANDIDATE | RECRUITER | HIRING_MANAGER | APPROVER",
  "candidateProfile": {
    "phone": "+1-555-0199",
    "resumeUrl": "https://storage/resumes/alex_morgan.pdf",
    "skills": ["Flutter", "Dart", "Firebase", "REST APIs"],
    "experienceYears": 5.5,
    "talentPoolTags": ["#SeniorFlutter", "#MobileLead", "#SilverMedalist"]
  }
}

2. JOB_REQUISITION

{
  "requisitionId": "REQ-2026-088",
  "title": "Lead Mobile Engineer",
  "department": "Engineering",
  "hiringManagerId": "uuid-mgr-01",
  "salaryBand": { "min": 140000, "max": 175000, "currency": "USD" },
  "approvalStatus": "APPROVED",
  "activeStagePipeline": ["APPLIED", "SCREENED", "TECH_INTERVIEW", "OFFER", "HIRED"]
}

Transactional Event Schemas

High-velocity event entities tracking pipeline stages, chats, offers, and approvals.

1. OFFER_PACKAGE & E_SIGNATURE

{
  "offerId": "OFR-99321",
  "candidateId": "uuid-cand-01",
  "requisitionId": "REQ-2026-088",
  "baseSalary": 165000,
  "signingBonus": 15000,
  "startDate": "2026-09-15",
  "status": "SIGNED",
  "eSignature": {
    "signerIp": "192.168.1.45",
    "timestamp": "2026-08-18T14:30:00Z",
    "signaturePayload": "data:image/svg+xml;base64,..."
  }
}

2. ONE_TAP_APPROVAL_REQUEST

{
  "requestId": "APR-4401",
  "type": "OFFER_SIGN_OFF | HEADCOUNT_REQ",
  "targetEntityId": "OFR-99321",
  "approverId": "uuid-exec-04",
  "decision": "APPROVED",
  "biometricVerified": true,
  "decisionTimestamp": "2026-08-18T12:15:00Z",
  "comments": "Approved compensation within Tier 1 bracket."
}

1. Core Data Structures & Models

Comprehensive definition of the relational entities, domain schemas, and state objects powering the mobile recruitment system.

1. UserAccount & AuthSession

Core identity, RBAC authorization, and push notification device registration for all system actors.

{
  "userId": "usr_99812_uuid",
  "email": "sarah.recruiter@techcorp.com",
  "fullName": "Sarah Jenkins",
  "role": "RECRUITER", // CANDIDATE | RECRUITER | HIRING_MANAGER | APPROVER
  "department": "Talent Acquisition",
  "avatarUrl": "https://cdn.52apps.com/avatars/sarah.jpg",
  "fcmDeviceToken": "fcm_token_mobile_abc123",
  "biometricEnabled": true,
  "isActive": true,
  "createdAt": "2026-08-19T09:00:00Z"
}

2. CandidateProfile & ResumeData

Rich applicant dossiers including cloud resume links, extracted skills, and talent tags.

{
  "candidateId": "cand_44011_uuid",
  "userId": "usr_77123_uuid",
  "headline": "Lead Flutter & Cross-Platform Engineer",
  "phone": "+1-555-0199",
  "location": "Austin, TX (Open to Remote)",
  "skills": ["Flutter", "Dart", "Firebase", "Clean Architecture", "Go"],
  "totalExperienceYears": 6.5,
  "resumeCloudUrl": "https://storage.52apps.com/resumes/cand_44011.pdf",
  "portfolioUrl": "https://github.com/alexmorgan",
  "talentPoolTags": ["#SeniorFlutter", "#SilverMedalist", "#ImmediateJoiner"]
}

3. JobRequisition

Defines open headcount requisitions, compensation boundaries, and active hiring workflow stages.

{
  "requisitionId": "REQ-2026-088",
  "title": "Lead Mobile Application Developer",
  "department": "Engineering",
  "hiringManagerId": "usr_mgr_8812",
  "headcountCount": 2,
  "salaryBand": {
    "min": 140000,
    "max": 175000,
    "currency": "USD"
  },
  "requisitionStatus": "OPEN", // DRAFT | PENDING_APPROVAL | OPEN | FILLED | CLOSED
  "pipelineStages": ["APPLIED", "SCREENED", "TECH_INTERVIEW", "MGR_INTERVIEW", "OFFER", "HIRED"]
}

4. Application & StageTracker

Tracks candidate state in the ATS Kanban pipeline with transition logs and evaluation scorecards.

{
  "applicationId": "app_55990_uuid",
  "requisitionId": "REQ-2026-088",
  "candidateId": "cand_44011_uuid",
  "currentStage": "TECH_INTERVIEW",
  "overallScore": 4.8,
  "stageTransitions": [
    { "stage": "APPLIED", "timestamp": "2026-08-17T10:00:00Z", "actorId": "cand_44011_uuid" },
    { "stage": "SCREENED", "timestamp": "2026-08-18T14:30:00Z", "actorId": "usr_rec_1120" },
    { "stage": "TECH_INTERVIEW", "timestamp": "2026-08-19T11:00:00Z", "actorId": "usr_rec_1120" }
  ],
  "scorecards": [
    { "interviewerId": "usr_mgr_8812", "technicalRating": 5, "culturalRating": 4, "notes": "Strong architecture skills." }
  ]
}

5. CommunicationLog & Message

Multi-channel message threads between candidate and hiring team, plus internal @mention notes.

{
  "conversationId": "conv_33100_uuid",
  "applicationId": "app_55990_uuid",
  "participants": ["usr_77123_uuid", "usr_rec_1120"],
  "channel": "IN_APP_CHAT", // IN_APP_CHAT | SMS | EMAIL | INTERNAL_NOTE
  "messages": [
    {
      "messageId": "msg_001",
      "senderId": "usr_rec_1120",
      "content": "Hi Alex, your interview with Dave is scheduled for tomorrow at 2 PM.",
      "sentAt": "2026-08-19T11:15:00Z",
      "isRead": true
    }
  ]
}

6. DigitalOfferPackage & ESignature

Comprehensive compensation package with legally binding digital e-signature payload and audit log.

{
  "offerId": "OFR-99321",
  "applicationId": "app_55990_uuid",
  "candidateId": "cand_44011_uuid",
  "baseSalary": 165000,
  "signingBonus": 15000,
  "equityUnits": 5000,
  "startDate": "2026-09-15",
  "offerStatus": "SIGNED", // DRAFT | PENDING_APPROVAL | SENT | VIEWED | SIGNED | EXPIRED
  "eSignatureRecord": {
    "signerFullName": "Alex Morgan",
    "signerIpAddress": "198.51.100.22",
    "signedTimestamp": "2026-08-19T14:45:10Z",
    "signatureDataSvg": "data:image/svg+xml;base64,PHN2Zy...",
    "contractSha256Hash": "a4f89d31b2e847c9..."
  }
}

7. OneTapApprovalRequest

Event record capturing executive mobile sign-offs with biometric authentication verification.

{
  "approvalRequestId": "APR-4401",
  "approvalType": "OFFER_SIGN_OFF", // HEADCOUNT_REQ | OFFER_SIGN_OFF | SALARY_VARIANCE
  "targetEntityId": "OFR-99321",
  "approverUserId": "usr_exec_004",
  "requestedByUserId": "usr_rec_1120",
  "decision": "APPROVED", // PENDING | APPROVED | REVISION_REQUESTED | REJECTED
  "biometricVerified": true,
  "decisionTimestamp": "2026-08-19T13:20:00Z",
  "justificationNotes": "Offer is well within standard Senior Lead budget bracket."
}

8. TalentPool & AnalyticsMetric

Silver-medalist talent repository and recruitment KPI telemetry tracking speed and conversion.

{
  "talentPoolId": "pool_mobile_silver_01",
  "poolName": "Top Mobile Engineers - 2026",
  "tags": ["#FlutterSenior", "#SilverMedalist", "#HighRating"],
  "candidateCount": 38,
  "kpiMetrics": {
    "avgTimeToHireDays": 18.4,
    "offerAcceptanceRatePercent": 91.2,
    "costPerHireUSD": 2840,
    "funnelConversion": { "appliedToScreen": 0.28, "screenToInterview": 0.45, "interviewToOffer": 0.70 }
  }
}

2. REST & WebSocket API Architecture

Detailed API interface endpoints, authorized roles, request structures, and response specifications across all 5 recruitment functionalities.

A. Authentication & Device APIs

Method	Endpoint	Roles	Request Payload / Params	Response	Description
POST	/api/v1/auth/login	All Actors	{ email, password }	{ token, user }	Authenticates user and returns JWT token with role claims.
POST	/api/v1/auth/register-candidate	Public	{ email, password, fullName, phone }	{ token, candidateId }	Creates candidate user account and initial empty profile.
PUT	/api/v1/users/device-token	All Actors	{ fcmDeviceToken, platform }	{ success: true }	Registers mobile device FCM token for high-priority push alerts.
GET	/api/v1/users/me	All Actors	Headers: Bearer Token	{ user, profile }	Fetches profile, notification preferences, and permissions.

B. Mobile ATS & Pipeline APIs

Method	Endpoint	Roles	Request Payload / Params	Response	Description
POST	/api/v1/jobs/:jobId/apply	Candidate	{ resumeCloudUrl, skills, portfolio }	{ applicationId, stage: "APPLIED" }	Submits job application and initiates ATS pipeline record.
GET	/api/v1/candidate/applications	Candidate	None	[ { applicationId, jobTitle, currentStage } ]	Fetches real-time status tracker cards for the candidate's mobile view.
GET	/api/v1/ats/pipeline/:requisitionId	Recruiter, Manager	Query: ?stage=&sort=	{ stages: { APPLIED: [...], SCREENED: [...] } }	Populates mobile Kanban board with candidate summaries by stage.
PATCH	/api/v1/ats/applications/:appId/stage	Recruiter, Manager	{ targetStage, transitionNotes }	{ success: true, updatedStage }	Drag-and-drop or swipe transition moving candidate to new stage.
POST	/api/v1/ats/applications/:appId/scorecard	Manager, Recruiter	{ technicalScore, culturalFit, notes }	{ scorecardId, avgScore }	Submits structured digital interview evaluation scorecard.

C. Communication Hub & Messaging APIs

Method	Endpoint	Roles	Request Payload / Params	Response	Description
GET	/api/v1/chat/conversations	All Actors	None	[ { conversationId, lastMessage, unreadCount } ]	Retrieves unified mobile inbox list across all candidate threads.
POST	/api/v1/chat/conversations/:convoId/messages	Candidate, Recruiter	{ content, attachmentUrl }	{ messageId, sentAt }	Dispatches direct message in thread and triggers high-priority push.
POST	/api/v1/comm/dispatch-template	Recruiter	{ templateId, candidateId, dynamicVars }	{ dispatchedCount: 1, channel: "SMS_EMAIL" }	Dispatches automated SMS/Email interview invite or status update.
POST	/api/v1/chat/internal-notes	Recruiter, Manager	{ applicationId, note, taggedUserIds }	{ noteId, timestamp }	Creates private internal team discussion note hidden from candidate.
WS	/ws/chat?token=:jwt	All Actors	WebSocket JSON Frame { event, payload }	{ event: "NEW_MSG", ... }	Real-time bi-directional socket for instant chat delivery & typing flags.

D. Digital Offer & E-Signature APIs

Method	Endpoint	Roles	Request Payload / Params	Response	Description
POST	/api/v1/offers/generate	Recruiter	{ applicationId, baseSalary, bonus, startDate }	{ offerId, status: "PENDING_APPROVAL" }	Builds offer package and routes for executive approval.
GET	/api/v1/offers/:offerId	Candidate, Recruiter, Approver	None	{ offerId, compensation, terms, status }	Fetches interactive mobile offer letter and contractual terms.
POST	/api/v1/offers/:offerId/sign	Candidate	{ signatureDataSvg, signerFullName }	{ status: "SIGNED", signedPdfUrl }	Submits digital e-signature; generates tamper-proof signed PDF.
GET	/api/v1/offers/:offerId/download-pdf	Candidate, Recruiter, Manager	None	Binary PDF Stream	Downloads completed counter-signed legal offer agreement.

E. Talent Pooling & Analytics APIs

Method	Endpoint	Roles	Request Payload / Params	Response	Description
GET	/api/v1/talent-pools	Recruiter, Manager	None	[ { poolId, poolName, memberCount } ]	Lists available categorized talent communities and silver-medalist pools.
POST	/api/v1/talent-pools/tag-candidate	Recruiter	{ candidateId, poolId, tags: ["#SilverMedalist"] }	{ success: true }	Adds candidate to talent pool with custom searchable skill tags.
POST	/api/v1/talent-pools/search	Recruiter, Manager	{ skills: ["Flutter"], minExp: 5, tags: [...] }	[ { candidateId, headline, score } ]	Executes multi-criteria search over pre-screened talent database.
GET	/api/v1/analytics/dashboard	Manager, Approver, Recruiter	Query: ?timeframe=30d&dept=eng	{ timeToHire, acceptanceRate, funnel }	Aggregates mobile analytics metrics on pipeline velocity and cost.

F. One-Tap In-App Approval APIs

Method	Endpoint	Roles	Request Payload / Params	Response	Description
POST	/api/v1/approvals/request	Manager, Recruiter	{ type: "OFFER", targetId, approverIds }	{ requestId, status: "PENDING" }	Initiates multi-tier approval chain and dispatches rich push notifications.
GET	/api/v1/approvals/pending	Approver	None	[ { requestId, type, summaryCard } ]	Fetches executive pending approval list with contextual comparison cards.
POST	/api/v1/approvals/:reqId/decision	Approver	{ decision: "APPROVED", biometricSig, notes }	{ success: true, updatedStatus }	Authorizes or rejects request with 1-Tap Biometric Confirmation.

3. Role-Based Access Control (RBAC) & Permission Module

Enterprise security architecture mapping system Actors to Granular Permissions, Screen Access rules, Master Data Models, and Transactional Security Audit structures.

A. Actor vs. Permission Matrix

Granular permission breakdown across all 5 system actors controlling operational execution boundaries.

Permission Code	Functional Scope	Hiring Mgr	Approver
JOB_APPLY_SUBMIT	Browse jobs & submit cloud resumes
ATS_PIPELINE_VIEW	Access visual Kanban candidate board	(Dept)	(Read)
ATS_STAGE_TRANSITION	Swipe/advance candidate across stages
SCORECARD_SUBMIT	Log structured interview ratings
COMM_DIRECT_CHAT	1-on-1 direct messaging in candidate thread
COMM_INTERNAL_NOTE	Post private internal @mention team notes
OFFER_PACKAGE_BUILD	Draft compensation package & terms
OFFER_SIGN_DIGITAL	E-sign binding offer letter on mobile
ONE_TAP_BIOMETRIC_APPROVE	Execute executive 1-tap sign-off
TALENT_POOL_MANAGE	Tag, search & re-engage silver medalists	(Search)
ANALYTICS_EXECUTIVE_VIEW	Access enterprise KPI, velocity & spend	(Dept)	(Global)
RBAC_ADMIN_MANAGE	Configure roles, permissions & overrides

B. Screen Definition & Access Mapping

Mapping mobile UI views to mandatory permission claims enforced at navigation routers.

Screen Name	Mobile Route Path	Required Permission	Authorized Roles	UI Component Protections
Candidate Dashboard	/candidate/home	JOB_APPLY_SUBMIT	Candidate	Restricts recruiter pipeline cards.
Interactive Kanban Pipeline	/ats/kanban/:reqId	ATS_PIPELINE_VIEW	Recruiter, Manager, Admin	Drag gesture disabled for View-Only roles.
Unified Chat Hub	/comm/conversations	COMM_DIRECT_CHAT	Candidate, Recruiter, Manager	Hides internal @notes from Candidate view.
Digital Offer Signing Screen	/offers/sign/:offerId	OFFER_SIGN_DIGITAL	Candidate	Enables HTML5/Flutter touch signature canvas.
1-Tap Executive Approval Queue	/approvals/queue	ONE_TAP_BIOMETRIC_APPROVE	Approver, Admin	Requires FaceID/TouchID prompt on action.
Talent Pool Explorer	/talent-pools/search	TALENT_POOL_MANAGE	Recruiter, Admin	Enables bulk tag & 1-click email campaigns.
Recruitment Analytics Telemetry	/analytics/dashboard	ANALYTICS_EXECUTIVE_VIEW	Recruiter, Manager, Approver	Filters financial metrics by role hierarchy.

C. Master Data Models (Permission Module)

Structural master entities defining static roles, permission catalogs, and screen definitions.

1. ROLE & PERMISSION Models

Defines system role identifiers and granular atomic permission capabilities.

// Master Entity: ROLE
{
  "roleId": "rol_recruiter_01",
  "roleCode": "RECRUITER",
  "roleName": "Talent Acquisition Specialist",
  "description": "Manages candidate pipeline, sourcing, and offer drafting.",
  "isSystemRole": true,
  "createdAt": "2026-08-19T00:00:00Z"
}

// Master Entity: PERMISSION
{
  "permissionId": "prm_ats_002",
  "permissionCode": "ATS_STAGE_TRANSITION",
  "module": "MOBILE_ATS",
  "description": "Allows transitioning candidate cards across hiring stages.",
  "riskLevel": "MEDIUM",
  "createdAt": "2026-08-19T00:00:00Z"
}

2. SCREEN_DEFINITION & ROLE_PERMISSION

Maps UI routes to permission requirements and assigns default permissions to roles.

// Master Entity: SCREEN_DEFINITION
{
  "screenId": "scr_approval_001",
  "screenCode": "EXECUTIVE_APPROVAL_QUEUE",
  "screenName": "1-Tap Executive Approval Queue",
  "routePath": "/approvals/queue",
  "module": "APPROVAL_WORKFLOWS",
  "requiredPermissionCode": "ONE_TAP_BIOMETRIC_APPROVE"
}

// Master Entity: ROLE_PERMISSION (Cross-Reference)
{
  "rolePermissionId": "rp_rec_099",
  "roleId": "rol_recruiter_01",
  "permissionId": "prm_ats_002",
  "grantedAt": "2026-08-19T00:00:00Z",
  "grantedBy": "usr_system_root"
}

D. Transactional Data Models (Permission Module)

High-velocity operational entities capturing user role assignments, custom overrides, and security audit ledgers.

1. USER_ROLE_ASSIGNMENT & OVERRIDE

Tracks scoped role allocations and temporary granular capability grants.

// Transaction Entity: USER_ROLE_ASSIGNMENT
{
  "assignmentId": "ura_88120_uuid",
  "userId": "usr_mgr_8812",
  "roleId": "rol_hiring_manager_01",
  "scopeType": "DEPARTMENT", // GLOBAL | DEPARTMENT | REQUISITION
  "scopeId": "dept_engineering_01",
  "assignedBy": "usr_admin_001",
  "assignedAt": "2026-08-19T10:00:00Z",
  "expiresAt": null
}

// Transaction Entity: USER_PERMISSION_OVERRIDE
{
  "overrideId": "upo_33100_uuid",
  "userId": "usr_mgr_8812",
  "permissionId": "prm_offer_001", // Special override to draft offers
  "overrideType": "GRANT", // GRANT | REVOKE
  "justification": "Acting Talent Lead for Q3 Engineering Drive.",
  "grantedBy": "usr_admin_001",
  "createdAt": "2026-08-19T10:30:00Z",
  "expiresAt": "2026-09-30T23:59:59Z"
}

2. PERMISSION_AUDIT_LOG & SESSION_TOKEN

Immutable access logs and cryptographic session claim verification snapshots.

// Transaction Entity: PERMISSION_AUDIT_LOG
{
  "auditLogId": "pal_99011_uuid",
  "userId": "usr_exec_004",
  "targetResourceId": "OFR-99321",
  "actionAttempted": "ONE_TAP_BIOMETRIC_APPROVE",
  "permissionChecked": "ONE_TAP_BIOMETRIC_APPROVE",
  "isGranted": true,
  "clientIpAddress": "198.51.100.22",
  "userAgent": "52Recruit-Mobile-iOS/1.4 (iPhone15,2; iOS 19.4)",
  "timestamp": "2026-08-19T13:20:00Z"
}

// Transaction Entity: USER_SESSION_ACCESS_TOKEN
{
  "sessionId": "ses_44011_uuid",
  "userId": "usr_exec_004",
  "activeRoleId": "rol_approver_01",
  "effectivePermissionsHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "issuedAt": "2026-08-19T08:00:00Z",
  "expiresAt": "2026-08-19T20:00:00Z",
  "revokedAt": null
}

Screen	Candidate	Recruiter	Hiring Mgr	Approver
① Onboarding / Login	✓	✓	✓	✓
② Candidate Dashboard	✓	—	—	—
③ ATS Kanban Pipeline	—	Full	View	View
④ Communication Hub	Chat	+Notes	+Notes	—
⑤ Offer & E-Signature	Sign	Build	—	—
⑥ Approval Queue	—	—	—	Biometric
⑦ Talent Pool	—	Full	Search	—
⑧ Analytics	—	Dept	Dept	Global

Step	Action	Scope / Target Service	Execution
a	Create / Verify GCP Project	`${GCP_PROJECT_ID}`	Automated
b	Link Billing Account	`${BILLING_ACCOUNT_ID}`	Automated
c	Enable Core APIs	Cloud Functions, API Gateway, Firestore, Firebase, IAM	Automated
d	Create API Gateway Service Account	Dedicated caller identity	Automated
e	Create Cloud Function Service Account	Firebase Admin SDK & Firestore runtime	Automated
f	Grant IAM Roles & Permissions	`roles/cloudfunctions.invoker`, `roles/datastore.user`	Automated
g	Initialize Firebase Project & iOS App	`${IOS_BUNDLE_ID}`	Automated
h	Provision Firestore Database	Native Mode in `${GCP_REGION}`	Automated
i	Enable Email/Password Provider	Firebase Authentication Console check	1-Click Manual
j	Seed Master Data & Sample Actors	Executes `seed_firestore.py`	Automated
k	Configure Flutter Mobile Client	`flutterfire configure` command generator	Automated

Collection	Type	Key Schema Fields	Access Governance
users	Master	userId, email, fullName, role, department, fcmDeviceToken, biometricEnabled	Self (Read/Write), Admin
candidateProfiles	Master	candidateId, userId, skills, experienceYears, resumeCloudUrl, talentPoolTags	Candidate, Recruiter, Manager
jobRequisitions	Master	requisitionId, title, department, hiringManagerId, salaryBand, status, pipelineStages	Recruiter, Manager, Approver
applications	Transaction	applicationId, requisitionId, candidateId, currentStage, overallScore, stageTransitions, scorecards	Candidate (Self), Staff
communicationLogs	Transaction	conversationId, applicationId, participants, channel, messages[sender, content, isInternal]	Participants (internal masked)
digitalOfferPackages	Transaction	offerId, candidateId, baseSalary, bonus, status, eSignature{svg, biometricHash, signedAt}	Candidate (Sign), Recruiter
approvalRequests	Transaction	requestId, type, targetEntityId, approverId, decision, biometricVerified, timestamp	Approver, Admin
talentPools	Master	poolId, poolName, candidateIds[], tags, departmentScope	Recruiter, Manager (Search)
analyticsMetrics	Transaction	metricId, metricType, value, period, departmentId, calculatedAt	Recruiter, Manager, Approver
roles & permissions	RBAC Master	roleId, roleCode, permissionId, permissionCode, module, riskLevel	System Read, Admin Manage
permissionAuditLogs	Audit	auditLogId, userId, actionAttempted, isGranted, clientIp, userAgent, timestamp	Immutable — Append Only

Package	Purpose
firebase_core	Firebase platform initialization
firebase_ui_auth	Native Firebase Authentication UI screens
cloud_firestore	Real-time chat & data synchronisation
local_auth	iOS FaceID & TouchID biometric challenge
flutter_secure_storage	Encrypted token & credential storage
go_router	Declarative routing with RBAC guards
signature	Vector touch signature capture canvas
fl_chart	Recruitment analytics & hiring funnel

Project Vision & Core Functionalities

Mobile Applicant Tracking & Pipeline (ATS)

Frictionless Mobile-First Job Application

AI-Powered Resume Parsing & Matching

Instant Interview Scheduling & Calendar Sync

Real-Time Push Notifications & Live Alerts

Centralized In-App Communication Hub

Mobile Interview Kits & Digital Scorecards

One-Tap In-App Approval Workflows

Digital Offer Management & E-Signatures

Talent Pooling & Recruitment Analytics

1. Core Functionalities Implemented

Mobile ATS & Pipeline Management

Centralized In-App Communication Hub

Digital Offer & E-Signatures

Talent Pooling & Analytics

One-Tap In-App Approval Workflows

2. System Actors & Roles

1. Candidate

2. Recruiter

3. Hiring Manager

4. Approver

3. Detailed Operations Matrix Across Functionalities

Functionality 1: Mobile Applicant Tracking & Pipeline (ATS)

Candidate Operations:

Recruiter Operations:

Hiring Manager Operations:

Functionality 2: Centralized In-App Communication Hub

Candidate Operations:

Recruiter Operations:

Hiring Manager Operations:

Functionality 3: Digital Offer Management & E-Signatures

Recruiter Operations:

Candidate Operations:

Approver Operations:

Functionality 4: Talent Pooling & Recruitment Analytics

Recruiter Operations:

Hiring Manager Operations:

Approver / Exec Operations:

Functionality 5: One-Tap In-App Approval Workflows

Hiring Manager Operations:

Approver Operations:

Recruiter Operations:

4. Information Flow & System Architecture Diagram

Recruitment Mobile Information Flow Diagram

Requisition & Approval

Apply & Sourcing

Pipeline & Chat

Offer & E-Sign

Pooling & Analytics

5. Proposed Data Models & JSON Schemas

Master Data Schemas

Transactional Event Schemas

1. Core Data Structures & Models

1. UserAccount & AuthSession

2. CandidateProfile & ResumeData

3. JobRequisition

4. Application & StageTracker

5. CommunicationLog & Message

6. DigitalOfferPackage & ESignature

7. OneTapApprovalRequest

8. TalentPool & AnalyticsMetric

2. REST & WebSocket API Architecture

A. Authentication & Device APIs

B. Mobile ATS & Pipeline APIs

C. Communication Hub & Messaging APIs

D. Digital Offer & E-Signature APIs

E. Talent Pooling & Analytics APIs

F. One-Tap In-App Approval APIs

3. Role-Based Access Control (RBAC) & Permission Module

A. Actor vs. Permission Matrix

B. Screen Definition & Access Mapping

C. Master Data Models (Permission Module)

1. ROLE & PERMISSION Models

2. SCREEN_DEFINITION & ROLE_PERMISSION

D. Transactional Data Models (Permission Module)

1. USER_ROLE_ASSIGNMENT & OVERRIDE

2. PERMISSION_AUDIT_LOG & SESSION_TOKEN

Mobile Screen Architecture & UI Design

📋 Screen Inventory — 8 Core Mobile Screens