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

85 lines
2.9 KiB
Markdown

# 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*