hamzaMissewi/Coldchain-Logistics-Full-Stack-Spring

A real-time cold chain logistics monitoring SaaS platform built specifically for Tunisian businesses exporting temperature-sensitive goods (pharmaceuticals, agri-food, seafood) to European markets. # ColdChain Monitor Tunisia A real-time cold chain logistics monitoring SaaS platform built specifically for Tunisian businesses exporting temperature-sensitive goods (pharmaceuticals, agri-food, seafood) to European markets. ## Problem Solved Tunisian exporters face strict EU temperature compliance requirements but lack affordable real-time monitoring solutions. This leads to: - Product spoilage due to temperature breaches - Rejected shipments at EU borders - High penalty costs - Lack of audit trails for regulatory compliance ## Solution ColdChain Monitor provides: - **Real-time temperature monitoring** via IoT sensors - **Instant alerts** for temperature violations - **Shipment tracking** with full audit trails - **EU compliance reporting** for customs - **Web dashboard** for logistics managers - **Mobile-responsive** for field operators ## Tech Stack ### Backend - Java 17 + Spring Boot 3.2 - PostgreSQL 15 - Spring Security + JWT - WebSocket (STOMP) for real-time updates - Flyway migrations - OpenAPI/Swagger documentation - Caffeine Cache for performance - OpenCSV for report generation - Spring Boot Actuator for health checks ### Frontend - Next.js 14 + React 18 - TypeScript - Tailwind CSS - TanStack Query (React Query) - Zustand state management - Recharts for data visualization - WebSocket client (STOMP.js) ## Project Structure ``` coldchain-logistics/ ├── backend/ │ ├── src/main/java/tn/coldchain/ │ │ ├── entity/ # JPA entities │ │ ├── repository/ # Spring Data repositories │ │ ├── service/ # Business logic │ │ ├── controller/ # REST controllers │ │ ├── security/ # JWT & Spring Security │ │ ├── dto/ # Data transfer objects │ │ ├── websocket/ # WebSocket config │ │ └── scheduler/ # Scheduled tasks │ └── src/main/resources/ │ └── db/migration/ # Flyway migrations ├── frontend/ │ ├── app/ │ │ ├── components/ # React components │ │ …