TheDurodola/MedCheck-Server

A robust Spring Boot backend designed to combat drug counterfeiting in Nigeria. Features a secure REST API architecture, JWT authentication, and RabbitMQ integration for real-time verification processing. # MedCheck-Server ## Overview MedCheck is an enterprise-grade pharmaceutical anti-counterfeiting backend system designed for the Nigerian supply chain ecosystem. It provides secure, transparent, and immutable tracking of pharmaceutical products across all tiers of distribution—from Manufacturers and Wholesalers to Retailers, Regulatory Investigators, and end Consumers. The system utilizes cryptographic verification codes on Batches, Packs, and Sachets to prevent counterfeit drugs from entering circulation, ensuring authentic medication reaches patients. --- ## Core Features - **End-to-End Supply Chain Traceability**: Complete tracking of pharmaceutical hierarchy (Batch to Pack to Sachet) from factory floor to consumer consumption. - **Role-Based Access Control (RBAC)**: Fine-grained access control enforcing distinct permissions for Administrators, Manufacturers, Wholesalers, Retailers, Investigators, and Consumers. - **Stateless JWT Authentication**: Custom Spring Security filter pipeline handling secure JSON Web Tokens with secret signing and configurable time-to-live. - **Hierarchical Batch & Code Management**: Automatic generation and verification of unique codes for batches, individual packs, and sachets. - **Asynchronous Event Processing**: Integration with RabbitMQ for event-driven workflows such as registration notifications and audit logging. - **Distributed Caching**: Redis integration for fast verification code lookups and performance optimization. - **Email Notifications**: Integration with Brevo API for system notifications and user verification alerts. --- ## Technology Stack - **Core Platform**: Java 21, Spring Boot 3.x - **Security & Auth**: Spring Security 6, Auth0 JWT (HMAC256) - **Database**: PostgreSQL 16 (JPA / Hibernate ORM) - **Caching**: Redis 8.0 - **Message Broker**: RabbitMQ 4 (AMQP Protocol) - **Email Provider**: Brevo (Sendinblue) API - **Containerization & Orchestration**: Docker, Docker Compose - **Build System**: Maven 3.9 --- …