Files
sp80/.planning/PROJECT.md
2026-03-13 01:30:45 +08:00

2.9 KiB

TCKRTUIYO

What This Is

A modern, web-based interface for Base Station/Real-Time Unit (RTU) monitoring rainfall and related sensors. Designed for 7" capacitive touchscreen display (1024x600) on Raspberry Pi Zero 2 W/3B, running via Chromium Kiosk Mode. Also supports full HD interface for PC remote access.

Core Value

Real-time rainfall and sensor monitoring with local display and server data transmission.

Requirements

Validated

  • ✓ Dashboard/Home Screen with logo, time, date, station ID, comm status - existing
  • ✓ Rainfall display (Today, Hourly, MAR Acc, Yearly Acc) - existing
  • ✓ Solar/Battery voltage display - existing
  • ✓ Settings menu structure (Utility, Calibration, Flash Memory) - existing
  • ✓ Station Info view - existing
  • ✓ Date/Time setting - existing
  • ✓ Mobile Setting view - existing
  • ✓ ADC Setting view (4-20mA, 0-10vDC channels) - existing
  • ✓ Rainfall Setting view - existing
  • ✓ EVAP Setting view - existing
  • ✓ GPRS Setting view - existing
  • ✓ Level Setting view - existing
  • ✓ Siren Setting view - existing
  • ✓ Network Setup view - existing
  • ✓ Calibration view - existing
  • ✓ Flash Memory/File Manager view - existing

Active

  • Modernize Dashboard UI for 7" display (1024x600)
  • Compact, intuitive, easy-to-customize UI
  • Performance optimization for Pi Zero 2 W
  • CSV processing workflow implementation
  • Network stack implementation (FTP/SCP/SFTP/WEBDAV)
  • Support two display modes: Kiosk (1024x600) and Full HD (remote)

Out of Scope

  • Mobile app development — web-only interface
  • Cloud server implementation — only RTU side
  • Hardware sensor integration — UI only

Context

Technical Environment:

  • Raspberry Pi Zero 2 W and Raspberry Pi 3B
  • 7" capacitive touchscreen 1024x600
  • Chromium Kiosk Mode for local display
  • Port 8080 for local, port 9090 for remote access

Existing Implementation:

  • React/TypeScript with Vite
  • shadcn/ui components
  • Tailwind CSS
  • Multiple setting views already implemented
  • Routes: Dashboard, Settings (11 submenus), Calibration, Flash Memory

User Requirements from THE_IDEA:

  • Modern but compact UI
  • Minimal dependencies
  • Fast enough for Pi Zero 2 W
  • Two interface modes (local 1024x600, remote Full HD)

Constraints

  • Performance: Must run smoothly on Pi Zero 2 W (low-powered ARM)
  • Display: Fixed resolution 1024x600 for local, responsive for remote
  • Browser: Chromium Kiosk Mode only
  • Tech Stack: React/TypeScript (existing), minimal additional dependencies

Key Decisions

Decision Rationale Outcome
React/TypeScript stack Already implemented, stable — Pending
shadcn/ui components Modern, accessible, customizable — Pending
Two-port architecture (8080/9090) Separate local vs remote interfaces — Pending

Last updated: 2026-03-13 after initialization