Firewall Five — SAMFMS

Modular Fleet Management System

📚 Documentation

Note: Table of contents for SRS is broken, everything is there.

Demo 1	Demo 2	Demo 3	Demo 4
SRS & Architecture	SRS & Architecture	SRS & Architecture	SRS & Architecture
		Project Board	Project Board
		Coding Standards	Coding Standards
		Technical Installation	Technical Installation
		User Manual	User Manual
		Deployment Strategy	Deployment Strategy
		Service Contracts	Service Contracts
Branching Strategy	Branching Strategy	Branching Strategy	Branching Strategy
		Updated Domain Model	Domain Model
			Testing Policy

Older docs:

• Demo 2 Slides: Canva Presentation

Demo Video

👥 Team

Profile	Name (Student No.)	GitHub	LinkedIn	Focus
	Mr. Stefan Jansen van Rensburg (u22550055)	StefanJvRCodes	Stefan Jansen van Rensburg	Team lead, CI/CD, daemon & backend services (storage, CRUD, file I/O, server & user mgmt)
	Mr. Johan Jansen van Rensburg (u22590732)	22590732	Johan Jansen van Rensburg	UI engineering & design, frontend architecture, service integration
	Mr. Laird Glanville (u22541332)	Laird-G	Laird Glanville	Backend engineering, MCore development, modular SBlocks
	Mr. Morné van Heerden (u21482153)	Mornevanheerden	Morné van Heerden	DevOps & systems, repo maintenance, services engineering
	Mr. Herman Engelbrecht (u22512374)	herrie732	Herman Engelbrecht	Services engineering, loosely coupled SBlocks, frontend & DB management

---

🧭 Overview

SAMFMS is a modular fleet platform that avoids “buy-everything” bloat. Start with a lightweight core (MCore) and install only the features you need as plug-in modules (SBlocks): location tracking, trip planning, maintenance, and driver/vehicle management. Start lean. Scale smoothly.

• Install only what you need
• Clear separation of core, services, and UI
• Event-driven and scalable
• Developer-friendly monorepo with shared contracts

---

🧱 Architecture

MCore

• Auth hooks, configuration, service discovery, and shared contracts
• API routing and standards across services
• Event catalog & schemas for cross-module messaging

SBlocks (Modules)

• Independently deployable feature services that register with MCore
• Stable FastAPI interfaces & clear boundaries
• Examples: Location, Trips, Maintenance, Driver/Vehicle

Communication & Data

• FastAPI for REST + service-to-service calls
• RabbitMQ for async pub/sub between modules
• MongoDB for operational & historical data

Frontend

• React + Tailwind for a crisp, responsive UI
• Leaflet for live maps, positions, and routes

Deployment

• Dockerized services and Compose for local
• Environment-driven configuration & secrets
• Modules deploy independently in production

---

Notes:

• Issues in GitHub Issues
• Branching model: Strategy

---

🧰 Technology