Skip to content

b-elamine/pharmaYou

Repository files navigation

💊 PharmaYou Pharmaceutical Management System

A full-featured web application developed for PharmaYou, a pharmaceutical company aiming to streamline its operations from prescription processing to client and delivery management. This system provides a central hub for pharmacists, delivery personnel, and administrators to manage workflows efficiently and securely.


📋 Table of Contents


📌 Overview

PharmaYou PMS is a React-based web application that digitizes and centralizes pharmaceutical operations. It handles prescriptions, client records, deliveries, partners, and statistics through modular views and role-based access.


🎯 Business Goals

  • 📑 Digitize prescription management (eliminate paper-based workflows)
  • 🚚 Optimize delivery logistics with real-time tracking
  • 🧑‍⚕️ Streamline client & partner interactions
  • 📈 Generate actionable insights with analytics
  • 🔐 Enforce role-based access for data privacy and integrity

🚀 Features & Modules

📄 Prescription Management

  • /ordonnance/recues: View and process incoming prescriptions.
  • /ordonnance/:id_commande: Link prescriptions to specific orders.
  • Workflow: Validate, edit, and track prescription statuses.

👥 Client Management

  • /client/particuliers: Manage individual customer records.
  • /client/particulier/:id_client: View client-specific history and prescriptions.
  • /client/professionnels (planned): Placeholder for corporate clients.

🚚 Delivery & Logistics

  • /livreurs: List all delivery personnel with detail views.
  • /livreurs/:id_livreur: Delivery agent profile and activity.
  • /livreurs/carte: Real-time map-based tracking (Leaflet/Google Maps).
  • /calendrier_tournées: Assign and view scheduled delivery rounds.

🤝 Partner Management

  • /partenaires: Add, edit, and manage pharmaceutical partners.
  • /partenaire/:id_partenaire: Track collaborations and contracts.

🛒 Orders & Invoicing

  • /commande/recues: View incoming orders linked to prescriptions.
  • /factures (placeholder): Future implementation for invoicing and billing.

📊 Admin & Analytics

  • /: Dashboard displaying key metrics (orders, revenue, delivery stats).
  • /stats: Detailed analytics and charts (ApexCharts/Chart.js).
  • Admin-only modules for user, role, and route management.

🧰 Technologies Used

Technology Purpose
React UI rendering and components
Redux App-wide state management
Axios API communication
Auth0 Authentication and roles
Leaflet/Google Maps Delivery map tracking
ApexCharts/Chart.js Analytics visualization
Vuexy Template Admin dashboard and UI toolkit

🔐 Authentication & Security

  • Auth0 integration with JWT tokens
  • Secure login/logout flows
  • Role-based access (Pharmacist, Delivery, Admin)
  • Route-based permission checks
  • Redirect URI: http://localhost:3000 (for development)

🏗️ Architecture

Frontend: React + Redux + Vuexy Template
|
|-- Modules: Ordonnance | Client | Livraison | Partenaire | Commande | Admin
|
Backend: Node.js/Express (https://ordo.pharmayou.fr:3003/)
|
|-- REST API: Secure endpoints for all data operations
|
Auth: Auth0 (Domain-configured for roles and sessions)

⚙️ Setup & Installation

🔧 Prerequisites

  • Node.js (v16+)
  • npm or yarn
  • Auth0 credentials
  • Access to the backend API (https://ordo.pharmayou.fr:3003/)

🛠️ Install Steps

git clone https://github.com/your-org/pharmayou-pms.git
cd pharmayou-pms
npm install

📁 Create .env file

REACT_APP_AUTH0_DOMAIN=your-auth0-domain
REACT_APP_AUTH0_CLIENT_ID=your-client-id
REACT_APP_API_BASE_URL=https://ordo.pharmayou.fr:3003/

▶️ Run App

npm start

Access via http://localhost:3000


📈 Future Enhancements

  • 📱 Mobile App for delivery personnel
  • ✍️ Digital e-signatures for prescriptions
  • 📦 Inventory & stock-level tracking
  • 🤖 AI for predictive analytics and demand forecasting
  • ⚙️ PWA features for offline access

Built with ❤️ to modernize pharmaceutical operations at PharmaYou. Authors : @b-elamine, @faycal-dev, akramou01-dev

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •