Project Overview

Project Overview

The CARE Initiative Global is a comprehensive web-based platform designed to support case assessment and resolution for Indian citizens in GCC countries (Saudi Arabia, UAE, Kuwait, Qatar, Bahrain, and Oman).

Key Objectives

  • Streamline case registration and assessment process
  • Enable real-time case tracking for applicants
  • Provide comprehensive tools for assessment and field officers
  • Ensure secure user authentication and authorization
  • Maintain detailed audit trails and reporting

Core Features

Multi-Role Authentication

Admin, Assessment Officer, and Field Officer roles with role-based access control

OTP Verification

Secure phone-based OTP verification for case registration

7 Case Types

Documentation, Financial, Labour, Legal, Repatriation, Medical, Detention

Application Tracking

Real-time status tracking with timeline and officer information

Document Management

Support for PDF, Images, and Email files with drag-and-drop upload

Assessment Workflow

Three assessment actions: Approve, Request Info, or Close case

Project Information

Version: 1.0.0

Release Date: April 2026

Supported Countries: Saudi Arabia, UAE, Kuwait, Qatar, Bahrain, Oman

Languages: English, Arabic (RTL)

Platform: Web-based (No installation required)

System Architecture

Technology Stack

Component Technology Purpose
Frontend HTML5, CSS3, JavaScript (Vanilla) User interface and interactions
Styling CSS3 Variables, Glassmorphism Modern, responsive design
Icons FontAwesome 6.4.0 UI icons and symbols
Data Storage localStorage & sessionStorage Client-side data persistence
Animations CSS3 Keyframes & Transitions Smooth visual effects

Architecture Layers

Presentation Layer

HTML & CSS components, user interfaces, responsive design

Business Logic Layer

JavaScript controllers, state management, workflows

Data Layer

localStorage (persistent), sessionStorage (session-based)

Component Structure

Public Pages: country-selection.html, home.html, register-case.html, track-application.html

Admin Dashboard: admin-login.html, admin-panel.html, admin-dashboard.html

Field Officer: field-officer-dashboard.html

Stylesheets: Shared admin-styles.css, field-officer-styles.css, case-styles.css

Scripts: Individual JavaScript files per module with modular design

User Roles & Access Control

The platform supports three distinct user roles with different access levels and responsibilities:

Role Responsibilities Access Dashboard
Admin System & user management Full system access admin-panel.html
Assessment Officer Review & assess applications Application review & assignment admin-dashboard.html
Field Officer Conduct investigations Case investigation & reporting field-officer-dashboard.html

Access Control Details

Admin Role

  • Create, edit, delete user accounts
  • Change user roles and permissions
  • Enable/Disable user accounts
  • Reset user passwords
  • View system statistics and settings

Assessment Officer Role

  • View all pending applications
  • Approve cases for investigation
  • Request additional information
  • Close out-of-scope cases
  • Assign cases to field officers

Field Officer Role

  • View assigned cases
  • Update investigation status
  • Add investigation notes
  • Record case outcomes
  • View performance reports

Complete Features Overview

Public Features (All Users)

Country Selection

Landing page with animated country picker for Saudi Arabia, UAE, Kuwait, Qatar, Bahrain, and Oman

Home Page

Service overview, hero section, workflow visualization, and call-to-action buttons

Case Registration

Three-step process: OTP verification, case type selection, dynamic form completion

Application Tracking

Real-time status tracking with timeline, officer information, and documents

Admin Features

  • User Management: Create, edit, delete, search users
  • Role Assignment: Assign/change user roles with validation
  • Account Control: Enable/disable accounts, lock/unlock users
  • Password Management: Reset passwords with validation
  • System Settings: Configure security policies and settings

Assessment Officer Features

  • Application Dashboard: View all pending applications
  • Application Review: Access full applicant info and documents
  • Assessment Actions: Approve, request info, or close cases
  • Case Assignment: Assign approved cases to field officers
  • Statistics: View pending, approved, and closed case counts

Field Officer Features

  • Case Management: View assigned and in-progress cases
  • Investigation Tracking: Update status, add notes, record outcomes
  • Documentation: Attach investigation reports and findings
  • Performance Reports: Monthly statistics and case metrics
  • Profile: View officer information and career statistics

Admin Panel Features

The Admin Panel (admin-panel.html) provides comprehensive user management and system administration capabilities.

User Management Operations

Full User CRUD
  • Create new user accounts with username and password
  • Edit existing user information (password, role, email, phone)
  • Change user roles dynamically (Admin, Assessment, Field Officer)
  • Enable/Disable user accounts to control access
  • Reset user passwords without knowing current password
  • Delete user accounts permanently
  • Filter users by role and status
  • Search users by username instantly

Admin Role Restrictions

Important Security Policy

Only usernames exactly matching "admin" can be assigned the Admin role. This restriction ensures secure administration and prevents unauthorized privilege escalation. Multiple admin accounts can exist (admin, admin2, etc.) but must follow this naming convention.

System Statistics

Total Users

Display count of all user accounts in the system

Active Users

Count of enabled user accounts

Role Distribution

Breakdown of users by role (Admin, Assessment, Field Officer)

System Health

Overall system status and configuration summary

Assessment Officer Dashboard

The Assessment Officer Dashboard (admin-dashboard.html) enables officers to review applications and assign them to field officers.

Dashboard Metrics

Pending Review

Applications awaiting assessment

Approved

Cases approved for investigation

Need Info

Cases requesting additional information

Closed

Out-of-scope closed cases

Three Assessment Actions

Approve for Investigation

Approve the case and assign it to a field officer for investigation. Must select an available field officer from the system.

Request Additional Information

Request more information from the applicant. Add feedback and remarks that will be communicated back to the applicant.

Close - Out of Scope

Close the case as out of scope. Add remarks explaining why the case cannot be assisted.

Assessment Workflow

  1. View list of all active applications in table format
  2. Filter applications or search by Application ID
  3. Click "Review" button to open application details modal
  4. Navigate through tabs to review applicant info, case details, and documents
  5. Go to Assessment tab and choose one of three actions
  6. Enter remarks (mandatory for all actions)
  7. If approving, select field officer from dropdown list
  8. Submit assessment and return to application list

Field Officer Dashboard

The Field Officer Dashboard (field-officer-dashboard.html) enables officers to conduct investigations on assigned cases.

Dashboard Sections

My Assigned Cases

View all cases assigned by assessment officers with priority indicators

Cases in Progress

Track active investigations with visual progress bars

Completed Cases

Archive of finished investigations with recorded outcomes

Reports

Performance metrics, monthly statistics, and case distribution

Case Investigation Workflow

  1. View assigned cases in "My Cases" section
  2. Priority levels automatically calculated based on assignment date
  3. Click case to open investigation detail modal
  4. Review applicant information, case details, and assessment officer remarks
  5. Navigate to Investigation tab
  6. Update case status (New, Under Review, Investigating, Resolved, Closed)
  7. Add detailed investigation notes and findings
  8. Select case outcome (Successfully Assisted, Partially Resolved, Referred, Unable to Assist)
  9. Optionally attach investigation report (PDF, DOC, DOCX)
  10. Submit investigation update to complete or progress case

Performance Reports

  • Cases Completed This Month: Real-time count of completed investigations
  • Average Days per Case: Average duration from assignment to completion
  • Case Resolution Rate: Percentage of cases successfully resolved
  • Positive Outcomes: Count of successfully assisted cases
  • Monthly Performance Chart: Visual graph of cases handled per month
  • Case Type Distribution: Breakdown by case type

Authentication & Session Management

Single Login Interface

All users (Admin, Assessment Officers, Field Officers) login through the same page (admin-login.html). The system automatically determines user role and redirects to the appropriate dashboard.

Authentication Flow

  1. Input: User enters username and password
  2. Validation: System validates credentials against stored database
  3. Status Check: System checks if account is enabled
  4. Role Detection: System determines user role (Admin/Assessment/Field Officer)
  5. Session Creation: Unique session token generated and stored
  6. Redirection: User redirected to appropriate dashboard

Session Management

Component Storage Duration Purpose
User Session sessionStorage Browser session Current login session
Remember Me localStorage 30 days Auto-fill username on login
Applications localStorage Indefinite Persistent application storage
Draft Cases localStorage Indefinite Save and resume case registration

Security Features

  • All protected pages check for valid session before allowing access
  • Invalid or expired sessions redirect to login page
  • Logout clears session and invalidates all access
  • Disabled accounts prevent login even with correct credentials
  • Session tokens generated using secure random methods
  • Password minimum length enforced (6 characters)
  • Role-based access control enforced on every page

Case Management System

Case Registration Process

Step 1: Phone Verification

User enters mobile number and receives OTP via SMS. Demo OTP is 123456. Users can also resume existing applications using previous Application ID.

Step 2: Case Type Selection

User selects from 7 case types, each with specific requirements and documentation needs.

Step 3: Application Form

User fills case-specific form with personal information, case description, and supporting documents. Can save as draft and resume later.

Seven Case Types

Documentation/Immigration

Visa issues, work permits, immigration status. Fields: issue type, visa expiry, current status

Financial/Fines

Fine-related matters and financial disputes. Fields: fine amount, fine type, fine date

Labour/Employment

Employer disputes and employment issues. Fields: company name, employment issue, end date

Legal Process

Court proceedings and legal matters. Fields: court name, case number, issue type

Repatriation/Exit

Return to home country assistance. Fields: destination, reason, financial assistance needed

Medical/Humanitarian

Health emergencies and medical assistance. Fields: condition, treatment, urgency level

Document Management

Supported File Formats

  • PDF Documents (.pdf)
  • Images (.jpg, .jpeg, .png)
  • Email Files (.msg, .eml)

Upload Features

  • Drag and drop support for easy uploading
  • Multiple file selection
  • File size display
  • Remove individual files before submission
  • Validation for file types

Application ID Format

CI-[COUNTRY]-[YEAR]-[MONTH]-[XXXXX] Example: CI-KSA-2026-04-00123 Components: - CI: CARE Initiative prefix - Country: KSA (Saudi Arabia), AE (UAE), KW (Kuwait), QA (Qatar), BH (Bahrain), OM (Oman) - Year: Full year (2026) - Month: 01-12 - Sequence: 5-digit number (00001-99999)

Application Tracking

How to Track

Go to track-application.html and enter:

  • Application ID (e.g., CI-KSA-2026-04-00123)
  • Registered mobile number

Displays

  • Complete applicant information
  • Current case status and stage
  • Progress timeline (5 stages)
  • Assigned case officer details (if applicable)
  • All attached documents
  • Expected completion timeline

Demo Credentials

Use these credentials to test the platform. Each account has access to different features based on role.

Admin Accounts

Username Password Dashboard Access
admin admin123 admin-panel.html User management, system settings
admin2 admin456 admin-panel.html User management, system settings

Assessment Officer Accounts

Username Password Dashboard Access
assessment1 assessment123 admin-dashboard.html Review & assess applications
assessment2 assessment456 admin-dashboard.html Review & assess applications

Field Officer Accounts

Username Password Region Dashboard
field1 field123 Saudi Arabia field-officer-dashboard.html
field2 field456 UAE field-officer-dashboard.html
field3 field789 Kuwait field-officer-dashboard.html
field4 field321 Qatar field-officer-dashboard.html

Demo OTP

For Case Registration: Use 123456 as the OTP when registering a case

Testing Tips

  • Start with admin account to create or modify users
  • Use assessment account to review and approve sample cases
  • Use field officer account to investigate assigned cases
  • Register a test case using the public registration page
  • Track the case using the tracking page

Installation & Deployment

Local Development Setup

  1. Extract careinitiativeglobal-complete.zip
  2. Open country-selection.html in a web browser
  3. Use demo credentials to test platform functionality
  4. Register a test case using OTP 123456
  5. Test each user role's dashboard

Server Deployment

  1. Set up web server (Apache, Nginx) to serve static files
  2. Implement backend API for data persistence
  3. Set up secure database (PostgreSQL, MongoDB)
  4. Implement authentication backend (JWT, OAuth2)
  5. Configure HTTPS/TLS certificates
  6. Set up environment variables for configuration
  7. Implement rate limiting and security headers
  8. Set up monitoring and logging

Production Recommendations

Authentication

Use password hashing (bcrypt, scrypt), implement JWT tokens with expiration

Security

Use HTTPS for all communications, implement rate limiting, use security headers

Monitoring

Implement audit logging for all actions, set up monitoring and alerting

Scaling

Use CDN for static files, implement caching strategies, use load balancing

Browser Compatibility

Supported Browsers

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

Requirements

  • JavaScript enabled
  • localStorage enabled
  • sessionStorage enabled
  • Cookies enabled (for session management)

Platform Compatibility

Platform Support Notes
Desktop ✓ Full Support All features available
Tablet ✓ Full Support Responsive layout, touch optimized
Mobile ✓ Full Support Mobile-first responsive design

Frequently Asked Questions

User Management

Q: Can I create multiple admin accounts?

A: Yes, but only usernames matching "admin" (admin, admin2, admin3, etc.) can have Admin role. This is a security restriction to prevent unauthorized privilege escalation.

Q: How do I reset a user password?

A: Login as Admin, go to User Management, click "Actions" for the user, select "Reset Password", enter new password, and submit.

Q: What happens if I disable a user account?

A: The user cannot login even with correct credentials. You can re-enable the account anytime by toggling the status.

Cases & Applications

Q: What is the demo OTP for case registration?

A: The demo OTP is 123456. This works for any mobile number in the system.

Q: Can I save a case and resume it later?

A: Yes. During case registration, you can click "Save & Resume Later" to save the draft. Use the generated Application ID to resume the case.

Q: How do I track an application status?

A: Go to track-application.html, enter your Application ID and registered mobile number. The system displays current status, timeline, and officer information.

Security & Access

Q: What is a session token?

A: A unique identifier generated after successful login. It's stored in sessionStorage and used to verify your identity throughout your session.

Q: What happens when I logout?

A: Your session is cleared from sessionStorage, and you're redirected to the login page. You must login again to access the system.

Q: Is the platform secure?

A: This is a demo version. Production deployment should use HTTPS, password hashing, JWT tokens, rate limiting, and comprehensive audit logging.

Technical Support

Q: What should I do if I encounter an error?

A: Check the browser console (F12) for error messages. Clear browser cache and localStorage if you're experiencing persistent issues. Try a different browser if applicable.

Q: Can I use this on mobile devices?

A: Yes. The platform is fully responsive and works on mobile, tablet, and desktop browsers. All features are available on all devices.

Q: Is my data saved permanently?

A: Data is stored in browser localStorage, which persists until manually cleared. In production, data should be stored in a secure backend database.

Security & Data Management

Data Storage

Data Type Storage Location Persistence Purpose
User Credentials In-memory (plaintext) Demo only User authentication
User Sessions sessionStorage Browser session Current login tracking
Applications localStorage Indefinite Case data persistence
Draft Cases localStorage Indefinite Save & resume functionality
Assessment Records In-memory Session duration Assessment history tracking

Security Considerations

Demo Version Limitations

This is a demo/prototype version with the following security considerations:

  • Passwords stored in plaintext (not hashed)
  • Credentials stored in-memory and localStorage
  • No encryption for data at rest or in transit
  • No rate limiting on login attempts
  • No audit logging for administrative actions
  • Sessions stored in browser storage (not httpOnly cookies)

Current Security Features

  • Role-based access control (RBAC) on frontend
  • Session token generation using random methods
  • Account enable/disable status checks
  • Password minimum length validation (6 characters)
  • Disabled accounts prevent login
  • Session validation on protected pages
  • Admin role restricted to "admin" usernames

Production Security Recommendations

Password Security

Use bcrypt or scrypt for password hashing. Enforce strong password policies (min 12 chars, mixed case, numbers, symbols).

Transport Security

Use HTTPS/TLS for all communications. Implement HSTS headers. Use secure cookies with HttpOnly flag.

Session Management

Implement JWT tokens with expiration (15-30 min). Use refresh tokens for longer sessions. Implement timeout mechanisms.

Access Control

Implement server-side authorization checks. Use rate limiting on login attempts. Monitor for suspicious activity.

Audit Logging

Log all user actions, especially administrative actions. Maintain immutable audit trail. Monitor logs for anomalies.

Data Protection

Use encryption for sensitive data. Implement data access controls. Regular backups and disaster recovery plans.

Data Privacy

Sensitive Data Handling

  • Applications contain personal information (names, passport numbers, phone numbers)
  • Case details may include health information or financial data
  • Assessment notes and investigation records are confidential
  • All data should be encrypted at rest and in transit
  • Implement role-based access to data (users see only their assigned cases)
  • Maintain GDPR/data protection compliance where applicable