EgiStr HUB Documentation

eggisatria HUB - Central Project Documentation - Aggregate multiple Google Drive accounts into a unified storage pool with programmatic API access.

Introduction

EDS (eggisatria HUB - Central Project Documentation) is a storage aggregation system that combines multiple Google Drive accounts into a single, unified storage pool. It provides:

  • Aggregated Storage - Pool multiple 15GB free Google Drive accounts
  • Virtual File System - Organize files with folders independently of Google Drive
  • Resumable Uploads - Support for large files (>1GB) with chunked upload
  • External API - Programmatic access via API keys
  • Secure - AES-256 encrypted tokens, SHA-256 hashed API keys

Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│                      EDS Dashboard                           │
│    (File Browser, Upload UI, Node Management)                │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                      EDS API Layer                           │
│  /api/drive/*  (Internal)   │   /api/v1/*  (External)       │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                   Storage Node Pool                          │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐                      │
│  │ Node A  │  │ Node B  │  │ Node C  │  (Google Drives)     │
│  │  15GB   │  │  15GB   │  │  15GB   │                      │
│  └─────────┘  └─────────┘  └─────────┘                      │
└─────────────────────────────────────────────────────────────┘

Key Concepts

Storage Nodes

Each connected Google account is a "node" contributing storage to the pool.

Smart Allocation

Files are automatically routed to nodes with the most available space.

API Keys

Secure programmatic access without exposing OAuth credentials.

Next Steps

Ready to get started? Follow these guides in order:

  1. Installation - Set up your development environment
  2. Configuration - Configure Google Cloud and environment variables
  3. Storage Nodes - Add your first Google Drive storage node
  4. API Authentication - Generate API keys for external access