How hudikhq/hoodik works
Project Type and Purpose
• Hoodik is a full-stack, self-hosted cloud-storage solution combining:
• A Vue.js Single-Page Application (frontend)
• A Rust/Actix Web backend composed of multiple workspace crates
• A relational database (SQLite or Postgres)
• File-system and chunked storage
• External dependencies (SMTP, reverse proxy)
Top-Level Architecture Components
A. Frontend (Web SPA)
• Vue.js app (under web/src)
• cryptfns WASM module (under web/services/cryptfns)
• E2E tests (Cypress)
B. Backend (Rust/Actix Web Server)
• Main server binary (hoodik/src/main.rs)
• Configuration loader (config crate)
• Context (request context, context crate)
• Routing & APIs (Actix Web via util/actix.rs)
• Domain modules (each a Rust crate):
• Authentication (auth crate)
• Administration UI API (admin crate)
• File storage (storage crate)
• Link sharing (links crate)
• Email sending (email crate)
• Settings & policies (settings crate)
• Shared libraries:
• Entities & types (entity crate)
• Encryption primitives (cryptfns crate, server side)
• Filesystem abstraction (fs crate)
• Error handling (error crate)
• Utility functions (util crate)
C. Data Stores
• Relational database (SQLite or Postgres)
• Local disk for encrypted file chunks
D. External Services
• SMTP server for emails
• Reverse proxy (e.g., Nginx)
• Clients (browsers)
Component Relationships & Data Flows
1. Browser → HTTPS → Actix Web Server (REST/WebSocket endpoints)
2. Server → Database (queries via repository modules in each crate)
3. Server → Local disk (encrypted chunks via fs crate)
4. Server → SMTP (via email crate’s SMTP provider)
5. Server (cryptfns) ↔ Client (WASM cryptfns) for end-to-end encryption
6. Server → Migration CLI (one-way for DB schema updates)
Architectural Patterns
• Modular, Cargo-workspace structure: each feature is a Rust crate.
• Repository pattern: data access lives in repository modules inside each crate.
• Tokenization + hashed indexes for secure searching (in storage + entity).
• Hybrid encryption flow: AES per file + RSA per user/link (in cryptfns).
• Chunked file upload/download for parallelism.
• Feature toggles: optional server-side encryption fallback.
• Configuration injection via environment (config crate) and dependency crates.
Technologies & Frameworks to Call Out
• Rust & Cargo workspaces
• Actix Web (HTTP server)
• Vue.js (frontend) + Vite
• WebAssembly for client crypto
• SQLite / Postgres
• SMTP (email)
• Cypress (E2E tests)
• Docker / Docker Compose / GitHub Actions