Dustac Environmental Monitoring Dashboard

Test Plan

Version: 1.2 Date: January 5, 2026 Project: Dustac Environmental Monitoring System Status: Draft

---

Document Control

Version	Date	Author	Description
1.0	2025-12-02	Dustac QA Team	Initial test plan for Phase 5+ testing
1.1	2025-12-20	Dustac QA Team	Added Dust Ranger feature testing
1.2	2026-01-05	Dustac QA Team	Added Device Timeline Data Gaps visualization testing

---

Document Structure

This test plan has been split into multiple documents for better maintainability:

Core Documents

Document	Description	Sections
TEST_PLAN.md (this file)	Overview, introduction, and document index	1
TEST_STRATEGY.md	Testing approach, assumptions, constraints, and risks	2-3
TEST_CASES.md	Planned tests and test case management	4, 7
TEST_SCOPE.md	Test progression and feature testing scope	5-6
TEST_ENVIRONMENT.md	Test environment, tools, and data	9
TEST_EXECUTION.md	Defect tracking, deliverables, schedule, roles, metrics, communication	8, 10-14
TEST_APPENDICES.md	Templates, glossary, and reference materials	Appendices A-K

Test Type Specifications

Document	Description	Tools
TEST_UNIT.md	Unit testing specifications, test cases, and code examples	Vitest, RTL
TEST_INTEGRATION.md	Integration testing for services, APIs, and database	Vitest, Supabase
TEST_SYSTEM.md	System testing for functional, performance, security, usability	Manual, k6
TEST_E2E.md	End-to-end testing with Playwright, page objects, user journeys	Playwright

---

1. Introduction

1.1 Overview

This Test Plan defines the comprehensive testing strategy, approach, and execution methodology for the Dustac Environmental Monitoring Dashboard system. The system is a cloud-native web application built to enable mining operations to collect, analyze, visualize, and report environmental dust monitoring data in compliance with regulatory requirements.

Project Identification:

• Project Name: Dustac Environmental Monitoring Dashboard
• Project Code: DUSTAC-2025
• Current Phase: Phase 5+ (Extended Features & Polish)
• Technology Stack: React 19, TypeScript 5, Supabase (PostgreSQL), Cloudflare Pages
• Deployment Model: Cloud-hosted SaaS application

Document Purpose:

This test plan serves multiple critical functions:

1. Quality Assurance Blueprint: Establishes comprehensive testing framework ensuring system meets functional, performance, security, and usability requirements
2. Stakeholder Communication: Provides transparency into testing scope, approach, and acceptance criteria for technical and business stakeholders
3. Risk Mitigation: Identifies potential quality risks and defines testing strategies to detect and prevent defects before production deployment
4. Resource Planning: Documents testing resource requirements, timelines, and responsibilities for effective project planning
5. Compliance Documentation: Provides audit trail demonstrating due diligence in quality assurance processes

1.2 System Description

The Dustac Environmental Monitoring Dashboard is designed for mining operations that deploy DustRanger monitoring devices to measure airborne particulate matter concentrations.

Core System Functions:

• Data Ingestion: Automated data collection from DustRanger devices via Edge Function scrapers
• Data Management: Multi-site support with RLS-based user data isolation
• Visualization & Analytics: Interactive dashboards with KPIs, charts, and climate data correlation
• Report Generation: Automated PDF reports with AI-generated chart descriptions
• Integration Points: BOM weather API, Dustac scraper API, Google Gemini AI

User Roles:

• Standard Users: View data, generate reports, manage their own site data
• Administrators: Multi-site management, user administration, system configuration

1.3 System Architecture

┌─────────────┐
│   User      │
│  (Browser)  │
└──────┬──────┘
       │ HTTPS
       ▼
┌─────────────────────────────────┐
│  Cloudflare Pages (React SPA)   │
└──────┬──────────────────────────┘
       │ Supabase Client SDK
       ▼
┌─────────────────────────────────┐
│      Supabase Platform          │
│  • PostgreSQL (RLS enabled)     │
│  • Auth Service (JWT)           │
│  • Storage (Object Store)       │
│  • Edge Functions               │
└──────┬──────────────────────────┘
       │ External APIs
       ▼
┌─────────────────────────────────┐
│    External Integrations        │
│  • BOM Weather API              │
│  • Dustac Scraper API           │
│  • Google Gemini AI             │
└─────────────────────────────────┘

1.4 Document Scope & Audience

Document Scope:

✅ Included:

• Functional testing of all feature modules
• Non-functional testing (performance, security, usability, accessibility)
• Integration testing with external APIs
• Database testing including RLS policies
• End-to-end workflow testing
• User acceptance testing (UAT)

❌ Excluded:

• Third-party service internal testing (Supabase, Cloudflare)
• DustRanger device hardware testing
• Penetration testing (separate security assessment)

Intended Audience:

Audience	Primary Use	Key Documents
QA Engineers	Test execution, defect logging	TEST_CASES.md, TEST_EXECUTION.md
Developers	Understanding test requirements	TEST_STRATEGY.md, TEST_SCOPE.md
Project Managers	Timeline tracking, resource planning	TEST_EXECUTION.md
Business Stakeholders	Acceptance criteria	TEST_SCOPE.md
DevOps Engineers	Test environment setup	TEST_ENVIRONMENT.md

1.5 Quick Reference

Test Commands:

pnpm test:unit          # Run Vitest unit tests
pnpm test:e2e           # Run Playwright E2E tests
pnpm test               # Run all tests
pnpm lint               # Run ESLint

Key Coverage Targets:

• Unit Tests: ≥85% for services/utilities, ≥70% for components
• E2E Tests: ≥75% for critical user journeys
• Overall: 96% of in-scope features tested

Test Environments:

• Development: Local Supabase (Docker)
• Staging: Production-equivalent cloud environment
• Production: Live user operations

---

Related Documents

Core Documents:

• TEST_STRATEGY.md - Testing approach and risk management
• TEST_CASES.md - Detailed test case specifications
• TEST_SCOPE.md - Feature testing scope and priorities
• TEST_ENVIRONMENT.md - Environment and tools setup
• TEST_EXECUTION.md - Execution process and reporting
• TEST_APPENDICES.md - Templates and reference materials

Test Type Documents:

• TEST_UNIT.md - Unit testing with Vitest
• TEST_INTEGRATION.md - Integration testing with Supabase
• TEST_SYSTEM.md - System and acceptance testing
• TEST_E2E.md - End-to-end testing with Playwright

---

Document Location: /docs/testing/TEST_PLAN.mdLast Updated: January 5, 2026 Version: 1.2 (Draft)