TRAQ

Schools lend sports kits and uniforms to students and lose track of them: paper sign-out sheets go missing, nobody knows which jersey is with whom, and items are never returned. Teachers need something faster than a spreadsheet that works in a changing room.

TRAQ had to make tracking as quick as a tap: identify a garment instantly from an NFC label, record who has it, and show what is still out, with each school's data kept separate and the app installable on teachers' iPhones through TestFlight.

The Flutter app reads NTAG213 labels with Core NFC through nfc_manager, polling ISO 14443 and taking the UID from the MiFare identifier, with an ISO 7816 fallback. The required entitlements and Info.plist identifiers are set so iOS will start the reader session. Each scan is wrapped in a Completer that maps reader errors to cancelled or failed results and clears any stale session first, working around a plugin defect where invalidated sessions were never released.

Data lives in Cloud Firestore under organisations/{orgId}, with garments keyed by tag UID, students with normalised case-insensitive IDs, and loans; a top-level users collection holds each teacher's school. Security rules look up the caller's school for every read and write, validate the school ID and join code when a teacher signs up, and make user profiles immutable from the client. Issue and return run as Firestore transactions, and the UI is driven by snapshot streams, with the on-loan list joining garments to open loans on the client to avoid composite indexes.

Releases are fully scripted: xcodebuild archives and exports with automatic provisioning, and the App Store Connect API, signed with an ES256 JWT, registers the bundle ID, enables NFC Tag Reading, registers devices, creates internal beta groups and testers, and expires superseded builds. Build-time flags select milestone features from one codebase.