How razgrom47/cloud works
Project type and purpose
• This is a lightweight full-stack web application built in Python using Flask.
• Purpose: act as a simple “cloud storage” interface for browsing, uploading, creating, deleting, and searching files/folders on a local directory (cloud_storage).
File structure
• Top-level files:
• app.py – the Flask application entry point (controls routes, business logic)
• requirements.txt, Dockerfile, .gitignore – build/deploy configuration
• Directories:
• static/ – CSS (and JS if any) served directly to clients
• templates/ – Jinja2 HTML templates
• cloud_storage/ – the actual file store (configured by BASE_DIR)
• (optional) uploads/ – if uploads are stored separately
• No external database: all persistence is via filesystem.
Extract insights from the README
• Key features that drive the architecture:
• HTTP routes for listing, uploading, creating, deleting, searching files.
• Path sanitization and secure filename handling using Werkzeug.
• Theme toggle (client-side UI state) and disk usage metrics.
• No authentication layer at present; security boundary is the BASE_DIR root.
Details to capture
• All Flask routes and their primary actions (list, upload, delete, search).
• The theme toggle as a UI state (client side only).
• Disk usage computation as a server-side utility called by the controller.
• Path sanitization step before any filesystem call.