bmiadmin
Repositories Projects Packages
26
 Public activity Starred repositories

factory/shape-tracking (0.4.1)

Published 2026-08-16 13:48:17 +00:00 by bmiadmin

Installation

{
	"repositories": [{
			"type": "composer",
			"url": ""
		}
	]
}
composer require factory/shape-tracking:0.4.1

About this package

Shape C: geo-tracking. Trips, vehicles, stops, live positions feed and check-in events (SchoolBus, BustApp, CityBus, TrucksUp, TrackEmployee).

factory/shape-tracking — v0.1.0

Shape C — a live position drives alerts (SchoolBus, BustApp, CityBus, TrucksUp, TrackEmployee). Trips run the product's configured lifecycle through the kernel FSM; positions stream in from the driver/device app; check-ins are the audited proof trail (pickups, drops, shift events).

Endpoints (all under /api)

Method Path Body / notes Response
GET /vehicles ?kind= {ok, data:[Vehicle], meta}
GET /trips ?status= {ok, data:[Trip], meta}
POST /trips route_label, scheduled_label?, vehicle_id?, stops:[{name, lat, lng, eta_label?}]? flat Trip, 201
GET /trips/{id} flat Trip (incl. last_position, stops)
PATCH /trips/{id} status (guarded forward-only, audited) flat Trip
GET /trips/{id}/positions ?since_ms= incremental feed (≤500) {ok, data:[{lat, lng, heading, speed_kph, recorded_at_ms}]}
POST /trips/{id}/positions lat, lng, heading?, speed_kph? flat Position, 201
POST /trips/{id}/checkins kind, stop_id?, subject_ref? — audited flat Event, 201

Tables: vehicles, trips, trip_stops, trip_positions, checkin_events (product-scoped via vehicles/trips.product_slug).

Dependencies

Dependencies

ID Version
factory/auth ^0.3 || ^0.4 || ^0.5 || ^0.6
factory/infra ^0.1 || ^0.2 || ^0.3
factory/kernel ^0.2 || ^0.3 || ^0.4 || ^0.5 || ^0.6 || ^0.7 || ^0.8 || ^0.9 || ^0.10
illuminate/database ^10.0 || ^11.0 || ^12.0 || ^13.0
illuminate/routing ^10.0 || ^11.0 || ^12.0 || ^13.0
illuminate/support ^10.0 || ^11.0 || ^12.0 || ^13.0
php ^8.2

Development dependencies

ID Version
orchestra/testbench ^8.0 || ^9.0 || ^10.0 || ^11.0
phpunit/phpunit ^10.1 || ^11.0 || ^12.0
Details
Composer
2026-08-16 13:48:17 +00:00
33
proprietary
28 KiB
Assets (1)
factory-shape-tracking.0.4.1.zip 28 KiB
Versions (3) View all
0.4.1 2026-08-16
0.4.0 2026-08-14
0.3.0 2026-08-06