Delete KeyStone_Photo_Cloud_Project_Plan.md

KeyStone_Photo_Cloud_Project_Plan.md

@@ -1,363 +0,0 @@
-# Personal Photo Cloud – Project Plan
-
-## Vision
-
-Build a private Google Photos alternative that automatically backs up photos directly from mobile devices to cloud storage under the user's control.
-
-### Goals
-
-- Automatic background backup
-- Android, iOS, and Web support
-- No dependency on Google Photos APIs
-- Fast uploads with resumable sync
-- Deduplication
-- AI-ready architecture
-- Self-hostable on Hugging Face Spaces
-
----
-
-# Technology Stack
-
-## Frontend
-
-- Expo
-- React Native
-- React Native Web
-- Expo Router
-- Expo Media Library
-- React Query
-- Zustand
-- Supabase JS SDK
-
-## Backend
-
-- FastAPI
-- SQLAlchemy
-- Alembic
-- Pillow
-- Uvicorn
-- BackgroundTasks
-
-## Authentication
-
-- Supabase Auth
-- Email/Password
-- Google OAuth
-- JWT Verification
-
-## Database
-
-Supabase PostgreSQL
-
-## Storage
-
-Hugging Face Bucket
-
-```
-originals/
-thumbnails/
-previews/
-```
-
----
-
-# High-Level Architecture
-
-```text
-React Native/Web
-        │
- Supabase Auth
-        │
- JWT Access Token
-        │
- FastAPI Backend
-        │
- ├── Upload API
- ├── Sync Engine
- ├── Gallery API
- ├── AI Services
- │
- ├── Supabase PostgreSQL
- └── Hugging Face Bucket
-```
-
----
-
-# Milestone 1 — Foundation
-
-- Repository setup
-- Docker
-- Environment variables
-- CI
-- FastAPI scaffold
-- Expo scaffold
-
-Deliverable:
-- Login screen
-- Health endpoint
-- Docker deployment
-
----
-
-# Milestone 2 — Authentication
-
-Frontend:
-- Login
-- Register
-- Forgot password
-- Session persistence
-
-Backend:
-- Verify Supabase JWT
-- User middleware
-- Protected routes
-
-Deliverable:
-- Secure authenticated API
-
----
-
-# Milestone 3 — Database
-
-Tables:
-
-## users
-
-- id
-- supabase_id
-- email
-- created_at
-
-## devices
-
-- id
-- user_id
-- device_name
-- platform
-- last_sync
-
-## photos
-
-- id
-- user_id
-- sha256
-- filename
-- bucket_path
-- thumbnail_path
-- width
-- height
-- size
-- created_at
-- uploaded_at
-- deleted
-
-## upload_jobs
-
-- id
-- status
-- retries
-
-Deliverable:
-- Database migrations
-- CRUD models
-
----
-
-# Milestone 4 — Upload Pipeline
-
-Workflow
-
-Camera Roll
-
-↓
-
-Find new photos
-
-↓
-
-Compute SHA256
-
-↓
-
-Check duplicate
-
-↓
-
-Upload
-
-↓
-
-Generate thumbnail
-
-↓
-
-Save metadata
-
-↓
-
-Complete
-
-Requirements
-
-- Multipart uploads
-- Progress reporting
-- Retry queue
-- Idempotency
-
-Deliverable:
-- Reliable uploads
-
----
-
-# Milestone 5 — Mobile Sync
-
-Features
-
-- Camera Roll permission
-- Background scanning
-- Queue management
-- Pause/resume
-- Retry failed uploads
-
-Rules
-
-- Never upload duplicate hashes
-- Resume interrupted uploads
-- Battery-aware syncing
-- Wi-Fi only option
-
-Deliverable:
-- Automatic backup
-
----
-
-# Milestone 6 — Gallery
-
-Features
-
-- Infinite scrolling
-- Lazy loading
-- Cached thumbnails
-- Favorites
-- Albums
-- Search
-- Timeline
-
-Deliverable:
-- Responsive gallery
-
----
-
-# Milestone 7 — Settings
-
-- Auto sync toggle
-- Cellular upload toggle
-- Thumbnail quality
-- Storage usage
-- Logout
-- Device management
-
----
-
-# Milestone 8 — AI
-
-- CLIP embeddings
-- OCR
-- Face clustering
-- Duplicate detection
-- Blur detection
-- Natural language search
-- Auto albums
-
----
-
-# API Design
-
-Authentication
-
-- POST /auth/verify
-
-Sync
-
-- POST /sync/check
-- POST /sync/start
-
-Uploads
-
-- POST /upload
-- POST /upload/batch
-
-Gallery
-
-- GET /photos
-- GET /photos/{id}
-- DELETE /photos/{id}
-
-Albums
-
-- GET /albums
-- POST /albums
-
-Health
-
-- GET /health
-
----
-
-# Security
-
-- JWT validation
-- HTTPS only
-- Rate limiting
-- SHA256 integrity
-- File type validation
-- Size limits
-- Signed URLs (future)
-
----
-
-# Future Enhancements
-
-- Video transcoding
-- Live Photos
-- HEIC support
-- Shared albums
-- End-to-end encryption
-- Desktop sync client
-- NAS support
-- S3-compatible storage
-- Object versioning
-
----
-
-# Deployment
-
-Frontend
-
-- Hugging Face Space (Static)
-
-Backend
-
-- Hugging Face Space (Docker)
-
-Services
-
-- Supabase Auth
-- Supabase PostgreSQL
-- Hugging Face Bucket
-
----
-
-# Definition of Done
-
-- User can register and log in.
-- Photos sync automatically from the mobile camera roll.
-- Duplicate photos are skipped.
-- Uploads resume after interruptions.
-- Thumbnails are generated.
-- Gallery loads quickly with pagination.
-- Metadata is stored in PostgreSQL.
-- Originals are stored in the Hugging Face bucket.
-- Backend validates Supabase JWTs.
-- Docker deployment runs successfully on Hugging Face Spaces.
-- Architecture supports future AI-powered organization and search.