nas-tools/docs/PDD.md

Product Definition Document — NAS Tools

Vision

A single dashboard to manage all self-hosted services on the NAS — Docker containers, media, tools, system health — accessible from anywhere via a clean web UI.

Goals

1. Unified management — one dashboard for all NAS services (containers, media, tools, auth)
2. GFW-proof deployment — all traffic routes through VPS + Tailscale, works from China
3. Self-healing — auto-detect down containers, email alerts, health checks
4. CI/CD from Gitea — push to deploy with zero manual SSH

Target Users

Self (Jimmy Gan). Secondary: family members who access media services on the NAS.

Success Metrics

• Dashboard loads in < 3s from anywhere
• All CI workflows green
• Zero manual SSH deploys
• < 5min recovery from container crash