From c11b1f949a9d90a985c818c12ea5727744577542 Mon Sep 17 00:00:00 2001
From: admin <cloud@tck.com.my>
Date: Fri, 13 Mar 2026 01:30:45 +0800
Subject: [PATCH] docs: initialize project

---
 .planning/PROJECT.md  | 84 +++++++++++++++++++++++++++++++++++++++++++
 .planning/config.json | 14 ++++++++
 2 files changed, 98 insertions(+)
 create mode 100644 .planning/PROJECT.md
 create mode 100644 .planning/config.json

diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md
new file mode 100644
index 000000000..85cef4c59
--- /dev/null
+++ b/.planning/PROJECT.md
@@ -0,0 +1,84 @@
+# 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*
diff --git a/.planning/config.json b/.planning/config.json
new file mode 100644
index 000000000..9b77f811c
--- /dev/null
+++ b/.planning/config.json
@@ -0,0 +1,14 @@
+{
+  "mode": "yolo",
+  "granularity": "coarse",
+  "parallelization": true,
+  "commit_docs": true,
+  "model_profile": "genius",
+  "workflow": {
+    "research": true,
+    "plan_check": true,
+    "verifier": true,
+    "nyquist_validation": true,
+    "auto_advance": true
+  }
+}