onifadeayomikun/petmarketplace-ekiti

A pet marketplace # VetConnect Ekiti > Online Veterinary Service Booking & Information System for Ekiti State, Nigeria. VetConnect Ekiti is a full-stack web application that connects animal owners and livestock farmers in **Ikerre-Ekiti, Ado-Ekiti, Igede, Ise, Emure, Ikole** and surrounding communities in Ekiti State with the veterinary clinics that serve them. Today, finding a vet across these communities is often a word-of-mouth exercise: there is no central directory, no way to book ahead, no reliable preventive-care information, and no fast path to help in an emergency. VetConnect solves this with a single platform that provides a **centralised, searchable clinic directory**, **online appointment scheduling** with double-booking prevention, a **preventive-care information portal**, **vaccination reminders**, and an **emergency assistance** workflow that matches an animal in distress to the nearest emergency-capable clinic. The interface is **mobile-first** because the target users are overwhelmingly smartphone-primary. --- ## Table of Contents - Features by Role - Core Modules - Tech Stack - Monorepo Structure - Local Setup - npm Scripts - Documentation - Security & Performance Highlights --- ## Features by Role The platform recognises **four actors**. The first is unauthenticated; the other three map to the `user_role` enum (`OWNER`, `CLINIC_ADMIN`, `SUPER_ADMIN`). ### 1. Guest (unauthenticated) - Browse and search the public clinic **directory** (filter by town, service, animal type, emergency availability, rating). - View a clinic profile, its veterinarians, services, operating hours, map location and published reviews. - Find clinics **near me** via geolocation (Leaflet/OSM map + Haversine distance). - Read the **information portal** (preventive-care articles by category). - Submit an **emergency assistance** request and view the emergency contacts list. - Register / log in. ### 2. Animal Owner (`OWNER`) - Maintain a profile and a roster of **animals / livestock** ( …