How l1ghtweight/netman works
Main Components
a) Core Components:
• User Interface Layer (Script Entry Points)
• Authentication Service
• Usage Monitoring Service
• Email Notification Service
• Data Storage Layer
b) External Systems:
• IUT Internet Portal (iusers page)
• Gmail SMTP Server
• Mobile App Integration Point (netboy)
┌─ External Systems Layer ─────┐
• IUT Portal │
• Gmail SMTP │
• Mobile App (netboy) │
• ┘
• ↕
┌─ Core Services Layer ────────┐
• Authentication Service │
• Usage Monitor │
• Email Notifier │
• ┘
• ↕
┌─ Data Layer ────────────────┐
• credentials.json │
• secrets.py │
• ┘
Component Details
a) Entry Points (Purple):
• netman.py (main script)
• netman_cron.sh (scheduling script)
• usage.sh (usage script)
b) Services (Blue):
• Authentication Service: Handles IUT portal login
• Usage Monitor: Scrapes and processes usage data
• Email Notifier: Handles email composition and sending
c) Data Storage (Green):
• credentials.json: User credentials store
• secrets.py: Email configuration store
d) External Systems (Orange):
• IUT Portal (HTTP/HTTPS)
• Gmail SMTP Server
• Mobile App Integration
Flow Indicators
• Data flow between components
• Authentication flows
• Email notification paths
• Mobile app integration points
Notes for Implementation
• Use standard UML or C4 model notation
• Clear separation between local and external components
• Scheduling mechanisms clearly
• Mobile app integration point for future expansion
Technical Stack Indicators
Technology badges for:
• Python 3.x
• Gmail SMTP
• JSON storage
• Cron/Task Scheduler