Waste-Tracking Documentation Management
A waste-management / environmental-services operator (Romania)
Overview
A Next.js + TypeScript build for managing and generating waste-tracking documentation, waste-transport accompanying notes (avize), dispatch notes, reception reports, and responsibility files, with bidirectional linking between related documents. Backed by Firebase for auth, data, and file storage.
The Challenge
Waste tracking and environmental compliance revolve around many interrelated document types, accompanying notes for waste transport, dispatch and reception records, and responsibility files, that must be captured, validated, linked, and exported with a strong, consistent data model so a traceable chain of custody can be reconstructed. The build set out to prove a typed, auditable approach to generating this documentation in a modern web app.
What We Built
A Next.js App Router app (src/app) with TypeScript types (src/types/index.ts) and a Firestore data layer (src/lib/firestore.ts). The UI (src/components) includes per-document views and edit modals, InvoicesView, AvizView, DispatchNotesView, ReceptieView, ResponsibilityFilesView, covering the waste-transport document chain, plus FileUpload, LinkDocumentModal (bidirectional document linking), ProcessingModal, a TaskList, and auth (Login, AuthContext). Utilities cover secure handling and export via crypto-js, jszip, and file-saver. The repo is notably well-documented, shipping multiple internal analysis guides (document-type analysis, quick reference, type-exports reference).
Technologies & Approach
Next.js + React + Tailwind for the front end, Firebase (Auth/Firestore/Storage) and Cloud Functions for a serverless backend, and a strongly-typed TypeScript model so document relationships and validation rules are enforced in code. Firestore security rules and indexes are defined alongside the app.
Outcome / Impact
Validated a typed, link-aware model for generating and managing waste-tracking documentation, with thorough type documentation that de-risks future extension. The most recent and actively-developed build in this set; remains a build.
Capabilities Demonstrated
- Domain modeling of regulated waste-transport document types
- Bidirectional document linking and typed Firestore architecture
- Secure file upload, packaging, and export (crypto-js / JSZip)
- Generating auditable compliance documentation from a typed model