How techlib/celus works
CELUS is a consortium-oriented web application for harvesting and visualizing electronic-resource usage statistics. Its principal workflow is to schedule and fetch SUSHI reports, import them into access-log data, and expose the resulting statistics for dashboards and reporting. The repository also contains organization/publication management, knowledgebase integration, analytics, exports, annotations, and event notifications. Source excerpts establish parts of the import and task flow; other connections are shown as unverified where only the tree or subsystem names support them.
Main entry points: logs/models.py Access-log data · sushi/models.py SUSHI fetching · Main.vue CELUS interface · tasks.py Harvest tasks
Components 19
Web client
- CELUS interface
design/ui/src/pages/Main.vue - Application API
apps/api/views.py
Harvest and import
- Harvest scheduler
apps/scheduler/models.py - SUSHI fetching
apps/sushi/models.py - Harvest tasks
apps/sushi/tasks.py - Import processing
apps/logs/tasks.py - Access-log data
apps/logs/models.py
Consortium data
- Organizations
apps/organizations/models.py - Platforms and titles
apps/publications/models.py - Knowledgebase
apps/knowledgebase/models.py - Tags and lists
apps/tags/models.py
Analytics and delivery
- Reporting engine
apps/reporting/logic/computation.py - Charts
apps/charts/views.py - Data exports
apps/export/models.py - Annotations
apps/annotations/models.py - Events and alerts
apps/events/models.py
Other components
- Consortium user
- Background task queue
- SUSHI provider
Connections 20
- Consortium user → CELUS interface: uses
README.rst - CELUS interface → Application API: requests
- Harvest scheduler → SUSHI fetching: processes intentions
apps/scheduler/models.py - SUSHI fetching → SUSHI provider: fetches reports
apps/sushi/models.py - Harvest scheduler → Harvest tasks: queues work
apps/sushi/tasks.py - Harvest tasks → SUSHI fetching: runs harvest logic
apps/sushi/tasks.py - Harvest tasks → Background task queue: runs asynchronously
apps/sushi/tasks.py - Import processing → Access-log data: imports records
apps/logs/tasks.py - Import processing → Background task queue: runs asynchronously
apps/logs/tasks.py - SUSHI fetching → Access-log data: creates access logs
apps/sushi/models.py - Access-log data → Organizations: associates usage
apps/logs/models.py - Access-log data → Platforms and titles: associates usage
apps/logs/models.py - Knowledgebase → Platforms and titles: updates platform data
apps/knowledgebase/models.py - Reporting engine → Access-log data: queries usage
- Charts → Access-log data: visualizes usage
- Data exports → Access-log data: exports reports
apps/export/models.py - Data exports → Tags and lists: uses tag filters
apps/export/models.py - Annotations → CELUS interface: appears in interface
- Events and alerts → Background task queue: sends notifications
apps/events/models.py - Events and alerts → CELUS interface: publishes updates
apps/events/models.py