{"id":30187053,"url":"https://github.com/johnmwendwa/vet-management-system","last_synced_at":"2025-08-12T15:24:59.499Z","repository":{"id":198310880,"uuid":"700511473","full_name":"JohnMwendwa/vet-management-system","owner":"JohnMwendwa","description":"This is an admin dashboard built for managing hospital/vet services","archived":false,"fork":false,"pushed_at":"2024-06-28T07:09:11.000Z","size":560,"stargazers_count":190,"open_issues_count":3,"forks_count":38,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-08-03T04:37:56.270Z","etag":null,"topics":["admin-dashboard","authentication"],"latest_commit_sha":null,"homepage":"https://vet-management-system.vercel.app","language":"TypeScript","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/JohnMwendwa.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}},"created_at":"2023-10-04T18:21:05.000Z","updated_at":"2025-07-28T21:15:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"e8e3c7db-8c22-4432-9c3d-4a61beb25bd1","html_url":"https://github.com/JohnMwendwa/vet-management-system","commit_stats":null,"previous_names":["johnmwendwa/vet-management-system"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/JohnMwendwa/vet-management-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnMwendwa%2Fvet-management-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnMwendwa%2Fvet-management-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnMwendwa%2Fvet-management-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnMwendwa%2Fvet-management-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JohnMwendwa","download_url":"https://codeload.github.com/JohnMwendwa/vet-management-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnMwendwa%2Fvet-management-system/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270084695,"owners_count":24524228,"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-08-12T02:00:09.011Z","response_time":80,"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":["admin-dashboard","authentication"],"created_at":"2025-08-12T15:24:52.272Z","updated_at":"2025-08-12T15:24:59.487Z","avatar_url":"https://github.com/JohnMwendwa.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Project Screenshot\n\n![vet-management-system vercel app_dashboard (1)](https://github.com/JohnMwendwa/vet-management-system/assets/72663882/104f8d8d-6309-48a7-8a70-3047f3a7103a)\n\n## Technologies Used \u003cimg src=\"https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Hammer%20and%20Wrench.png\" alt=\"Hammer and Wrench\" width=\"30\" height=\"30\" /\u003e\n\n- Material-tailwind/react (UI)\n- Next.js (Full stack app)\n- Next-auth (Authorization \u0026 Authentication)\n- MongoDB (Storage of app data)\n- Faker-js (Dummy data)\n- Nodemailer (Sending emails)\n- Mongoose (Database schema)\n- Bcrypt (Hashing passwords before they're stored in the database)\n- Fullcalendar (Booking and keeping track of appointments)\n\nThis is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).\n\n## Getting Started \u003cimg src=\"https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Travel%20and%20places/Parachute.png\" alt=\"Parachute\" width=\"30\" height=\"30\" /\u003e\n\nFirst, install the dependencies\n\n```bash\nnpm install\n```\n\nThen create a `.env.local` file with the following environment variables\n\n```bash\nLOCAL_URL=Your Local mongoDB URL\nMONGO_URL=Production mongoDB URL\nNEXTAUTH_URL=http://localhost:3000/ | YOUR APP STARTING POINT URL\nNEXTAUTH_SECRET=Secret to hash your tokens\n```\n\nBefore running the app, ensure your local mongodb server is running or skip this part if you're using an online database\n\n```bash\n# In your command-line, go to where your mongodb bin is installed by running the following command (Tweak in accordance with your mongodb installation folder)\n\ncd ../../mongodb/bin\n\n# Then start the mongodb server by running the following command\n\nnet start mongodb\n\n```\n\nThen, run the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n# or\npnpm dev\n# or\nbun dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\nThis project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.\n\n## User Roles and permissions\n\nThe app has 3 types of users, namely :\n\n1.  Doctors\n2.  Nurses\n3.  Clients\n\nUpon creating an account (by signing up), the default role assigned to the newly created account is that of a client.\n\nThe 3 users have the following permissions:\n\nI. Doctor\n\n- A doctor has full admin rights to **CREATE**, **EDIT**, **DELETE** a user account, and can assign any role to that account i.e, the doctor can assign that newly created account the role of a doctor, nurse or client.\n\n- A doctor also has full admin rights to **ADD**, **EDIT** and **REMOVE** employees\n\nII. Nurses\n\n- Nurses still don't have any admin rights at the moment but that is bound to change in the future. They only have the permission to edit their details i.e they can **EDIT** and **DELETE** their user details but can't change their roles.\n\nIII. Client\n\n- Clients don't posses any admin rights but can only **CREATE**, **EDIT** and **DELETE** their accounts whenever they wish to.\n\n## How to assign yourself **Full Admin Rights**\n\nOnce you fork this repo, signup atleast one account and then go to your database and change the role of that account to \"doctor\" and that's it, you have full admin rights.\n\n## Learn More \u003cimg src=\"https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Open%20Book.png\" alt=\"Open Book\" width=\"25\" height=\"25\" /\u003e\n\nTo learn more about Next.js, take a look at the following resources:\n\n- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.\n- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.\n\nYou can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!\n\n## Deploy on Vercel \u003cimg src=\"https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Travel%20and%20places/Rocket.png\" alt=\"Rocket\" width=\"30\" height=\"30\" /\u003e\n\nThe easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template\u0026filter=next.js\u0026utm_source=create-next-app\u0026utm_campaign=create-next-app-readme) from the creators of Next.js.\n\nCheck out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnmwendwa%2Fvet-management-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnmwendwa%2Fvet-management-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnmwendwa%2Fvet-management-system/lists"}