{"id":29436941,"url":"https://github.com/imrahul05/crms-frontend","last_synced_at":"2025-09-02T10:35:15.216Z","repository":{"id":303981585,"uuid":"1017348025","full_name":"imRahul05/CRMS-frontend","owner":"imRahul05","description":"A comprehensive web application for managing employee referrals built with React and Vite. This system allows employees to submit candidate referrals and tracks these referrals through the hiring pipeline.","archived":false,"fork":false,"pushed_at":"2025-07-25T17:18:53.000Z","size":5794,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-25T19:07:31.429Z","etag":null,"topics":["bcrypt","expressjs","javascript","jwt-authentication","mongodb","nodejs","plotlyjs","rbac-roles","reactjs","tailwindcss","vite"],"latest_commit_sha":null,"homepage":"https://crms-frontend-theta.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imRahul05.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-10T11:54:44.000Z","updated_at":"2025-07-25T17:18:56.000Z","dependencies_parsed_at":"2025-07-10T20:32:51.782Z","dependency_job_id":null,"html_url":"https://github.com/imRahul05/CRMS-frontend","commit_stats":null,"previous_names":["imrahul05/crms-frontend"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/imRahul05/CRMS-frontend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imRahul05%2FCRMS-frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imRahul05%2FCRMS-frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imRahul05%2FCRMS-frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imRahul05%2FCRMS-frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imRahul05","download_url":"https://codeload.github.com/imRahul05/CRMS-frontend/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imRahul05%2FCRMS-frontend/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273271747,"owners_count":25075967,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-02T02:00:09.530Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bcrypt","expressjs","javascript","jwt-authentication","mongodb","nodejs","plotlyjs","rbac-roles","reactjs","tailwindcss","vite"],"created_at":"2025-07-13T05:41:18.330Z","updated_at":"2025-09-02T10:35:15.179Z","avatar_url":"https://github.com/imRahul05.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Candidate Referral Management System (CRMS)\n\nA comprehensive web application for managing employee referrals built with React and Vite. This system allows employees to submit candidate referrals and tracks these referrals through the hiring pipeline.\n\n![CRMS Dashboard](https://via.placeholder.com/800x400?text=CRMS+Dashboard)\n\n## API Documentation\n\nYou can view the full API documentation here:  \n👉 [Postman API Docs](https://documenter.getpostman.com/view/34815726/2sB34fm182)\n\n## Features\n\n### User Authentication\n- Secure login and registration system\n- JWT-based authentication\n- Role-based access control (Admin vs Regular User)\n- Persistent sessions with token storage\n\n### User Features\n- Submit candidate referrals with resume attachments\n- Track status of submitted referrals\n- View and filter referrals by status, job title, and more\n- Receive real-time notifications on status changes\n\n### Admin Features\n- Comprehensive dashboard with referral statistics\n- View, manage, and update all referrals\n- Change candidate status (Pending, Reviewed, Hired, Rejected)\n\n\n### UI/UX\n- Responsive design using Tailwind CSS\n- Toast notifications for feedback\n- User-friendly forms with validation\n- Dashboard with filtering capabilities\n\n## Tech Stack\n\n- **Frontend**: React, React Router, Context API\n- **Styling**: Tailwind CSS\n- **HTTP Requests**: Axios\n- **Notifications**: React-Toastify\n- **Build Tool**: Vite\n\n![Login](src/assets/login.png)\n![Register](src/assets/register.png)\n![Admin Dashboard](src/assets/admin_dashboard.png)\n![Profile Page](src/assets/profilePage.png)\n![Referral Form](src/assets/User_referral_form.png)\n\n## Project Structure\n\n```\nsrc/\n├── api/            # API service layer\n├── components/     # Reusable UI components\n├── contexts/       # React Context providers\n├── Pages/          # Page components\n│   ├── admin/      # Admin-specific pages\n│   └── user/       # User-specific pages\n```\n\n## Installation and Setup\n\n1. Clone the repository\n   ```bash\n   git clone https://github.com/yourusername/crms.git\n   cd crms\n   ```\n\n2. Install dependencies\n   ```bash\n   npm install\n   ```\n\n3. Set up environment variables\n   Create a `.env` file in the root directory:\n   ```\n   VITE_API_BASE_URL=http://localhost:8000\n   ```\n\n4. Start the development server\n   ```bash\n   npm run dev\n   ```\n\n## API Endpoints\n\nThe application connects to a backend API with the following endpoints:\n\n### Authentication\n\n| Endpoint | Method | Description | Request Body | Response |\n|----------|--------|-------------|-------------|----------|\n| `/api/user/signup` | POST | Register a new user | `{ name, email, password }` | `{ success: true, message }` |\n| `/api/user/login` | POST | Login a user | `{ email, password }` | `{ user, token }` |\n\n### User Referrals\n\n| Endpoint | Method | Description | Request Body | Response |\n|----------|--------|-------------|-------------|----------|\n| `/api/user/referal-submit` | POST | Submit a new referral | Form data with candidate details and resume | `{ success: true, referral }` |\n| `/api/user/my-referrals` | GET | Get all referrals made by the user | - | Array of referrals |\n\n### Admin Endpoints\n\n| Endpoint | Method | Description | Request Body | Response |\n|----------|--------|-------------|-------------|----------|\n| `/api/user/admin/referrals` | GET | Get all referrals (admin only) | - | Array of referrals |\n| `/api/user/admin/referrals/:id/status` | PUT | Update referral status | `{ status }` | `{ success: true, updatedReferral }` |\n| `/api/user/admin/referrals/:id` | DELETE | Delete a referral | - | `{ success: true, message }` |\n\n## Authentication\n\nAll API requests (except login and register) require authentication using JWT tokens. The token is included in the Authorization header:\n\n```\nAuthorization: Bearer [token]\n```\n\n## Usage\n\n1. Login using your credentials or register if you don't have an account\n2. Regular users can submit referrals using the Referral Form\n3. View your submitted referrals in the Dashboard\n4. Admin users have access to all referrals and can manage their status\n\n## Demo Credentials\n\nFor quick testing, use the following credentials:\n\n- **Admin Account**:\n  - Email: admin@gmail.com\n  - Password: admin@gmail.com\n\n- **Regular User**:\n  - Email: newUser@gmail.com\n  - Password: qwerty@123\n\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimrahul05%2Fcrms-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimrahul05%2Fcrms-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimrahul05%2Fcrms-frontend/lists"}