How soheilpro/sherlock-web works
Main System Components
A. Frontend Layer (UI)
• React Components (src/scripts/ui/components)
• UI Contexts (src/scripts/ui/contexts)
• UI Hooks (src/scripts/ui/hooks)
B. Core Layer (Application Logic)
• Core Managers (src/scripts/core)
• Database Management (src/scripts/database)
• Crypto Management (src/scripts/managers/crypto.ts)
C. Storage Layer
• Multiple Storage Providers:
• Local Storage
• Google Drive
• File System
• Test Storage
Component Relationships
[UI Layer] → [Core Layer] → [Storage Layer]
• ↑ ↓ ↓
• ┴───────────────┘
• (Event-based communication)
Detailed Component Breakdown
• Main App Container
• Database Management UI
• Folder Management
• Item Management
• Search Functionality
• Storage Management
B. Core Layer Components:
• Database Manager
• Storage Manager
• Crypto Manager
• Event Management System
C. Storage Layer Components:
• Storage Provider Interface
• Individual Storage Implementations
Key Design Elements
Use the following visual elements:
• Rounded rectangles for UI components
• Hexagons for managers/controllers
Important Architectural Patterns to Highlight
• PWA Architecture (as mentioned in README)
• React Component Hierarchy
• Storage Provider Pattern
• Event-Driven Communication
• Crypto Management Integration
Implementation Details
• Database structure (folders, items, sequences)
• Storage provider interfaces
• Security layer integration
• UI state management flow
• Data synchronization paths