How hyunsdev/opize-calendar2notion-server works
Main Components
a) Core Application Layer:
• NestJS Application Core
• Global Exception Filter
• Environment Configuration
• Common Utils & Services
b) External Integration Services:
• Google Calendar API Client
• Notion API Client
c) Main Feature Modules:
• User Module (with Auth)
• Admin Module
• SyncBot Module
• Migration Module
Module Breakdown and Relationships
a) User Module Components:
• Authentication Service
• Calendar Management
• Connection Services (Notion/Google)
• Guards & Decorators
b) Admin Module Components:
• Error Management
• Statistics
• Tools (Google Calendar & Notion)
• User Management
• Event Management
• Plan Management
c) SyncBot Module Components:
• Stream Management
• Logging System
• Rectangles: Main modules
• Rounded rectangles: Services
• Hexagons: External APIs
• Diamonds: Decision points/guards
• Blue: Core application components
• Green: External integrations
• Yellow: Authentication/Security
• Gray: Utility services
• Orange: Feature modules
• Double lines: Data flow
Specific Implementation Details
a) Core Layer:
┌─────────────────────────┐
• NestJS Core App │
• ┌─────────┬─────────┐ │
• Filters │ Guards │ │
• ┴─────────┘ │
• ┘
b) Integration Layer:
┌─────────────────┐ ┌─────────────┐
• Google Calendar │ │ Notion │
• Client │ │ Client │
• ┘ └─────────────┘
c) Feature Modules:
┌─────────────────────────────────┐
• User Module │
• ┬──────────────────┤
• Auth │ Calendar │
• Service │ Service │
• ┴──────────────────┘
Key Relationships to Highlight
• Auth flow between User Module and external services
• Data flow between SyncBot and calendar integrations
• Admin module's oversight of all other modules
• Migration module's interaction with data stores
┌─────────────────────────┐
• ┬─────────────┤
• ► │ Data Flow │
• ► │ Events │
• ═════► │ Auth Flow │
• ┴─────────────┘
Data Access Layer
This structure will provide a clear visualization of the application's architecture while maintaining the necessary level of detail for a principal software engineer to understand the system's complete flow and interactions.