How f3nd1/intelligence-dashboard-v2 works
UCC Intelligence is a Frappe-based institutional analytics and staff-support platform. Staff enter through dashboard and Ask UCC interfaces; analytics requests produce criterion views and drilldowns, while Ask UCC combines domain lookups with guarded AI explanations. Separate administrative workflows manage knowledge documents, monitoring findings, permissions, and proposed actions. The README also documents a Custom HTML Block visual catalogue and live panels. Some subsystem links below rely on the SOURCE INDEX’s file references; unsampled implementation details and runtime wiring are not asserted.
Main entry points: api.py Whitelisted API · orchestration.py Answer orchestration · service.py Operations workspace · retrieval.py Knowledge retrieval
Components 23
Staff interfaces
- Dashboard block
custom-html-block/JAVASCRIPT.js - Platform runtime
src/js/10-platform-runtime.js - Explore runtime
src/js/20-explore-runtime.js - Live panels
src/js/30-live-foundation-runtime.js - Visual navigation
src/js/40-visual-navigation-runtime.js
Analytics
- Criterion analytics
ucc_intelligence/ucc_intelligence/analytics - Analytics contracts
ucc_intelligence/ucc_intelligence/analytics/contracts.py - Analytics drilldown
ucc_intelligence/ucc_intelligence/analytics/drilldown.py
Ask UCC
- Ask domain tools
ucc_intelligence/ucc_intelligence/ask_ucc - Guided questions
ucc_intelligence/ucc_intelligence/ask_ucc/guided_questions.py - Answer orchestration
ucc_intelligence/ucc_intelligence/ai/orchestration.py - AI provider client
ucc_intelligence/ucc_intelligence/ai/client.py
Operations
- Knowledge ingestion
ucc_intelligence/ucc_intelligence/knowledge/ingestion.py - Knowledge retrieval
ucc_intelligence/ucc_intelligence/knowledge/retrieval.py - Monitoring engine
ucc_intelligence/ucc_intelligence/monitoring/engine.py - Monitoring rules
ucc_intelligence/ucc_intelligence/monitoring/rule_registry.py - Operations workspace
ucc_intelligence/ucc_intelligence/operations/service.py - Action approval
ucc_intelligence/ucc_intelligence/actions/service.py - Action registry
ucc_intelligence/ucc_intelligence/actions/registry.py
Platform services
- Whitelisted API
ucc_intelligence/ucc_intelligence/api.py - Dashboard access
ucc_intelligence/ucc_intelligence/permissions/access.py
Other components
- Staff user
- OpenAI service
Connections 26
- Staff user → Dashboard block: uses
- Dashboard block → Visual navigation: mounts
- Staff user → Platform runtime: uses
- Platform runtime → Whitelisted API: requests
- Explore runtime → Whitelisted API: requests
- Live panels → Whitelisted API: requests
- Whitelisted API → Criterion analytics: dispatches criteria
ucc_intelligence/ucc_intelligence/api.py - Whitelisted API → Analytics drilldown: dispatches
ucc_intelligence/ucc_intelligence/api.py - Whitelisted API → Analytics contracts: uses contract
ucc_intelligence/ucc_intelligence/api.py - Criterion analytics → Analytics contracts: standardizes responses
ucc_intelligence/ucc_intelligence/analytics/criterion_4_admission.py - Whitelisted API → Answer orchestration: dispatches Ask
ucc_intelligence/ucc_intelligence/api.py - Whitelisted API → Ask domain tools: routes tools
ucc_intelligence/ucc_intelligence/api.py - Staff user → Whitelisted API: asks questions
- Answer orchestration → Guided questions: routes questions
ucc_intelligence/ucc_intelligence/ai/orchestration.py - Answer orchestration → Ask domain tools: calls domain tools
ucc_intelligence/ucc_intelligence/ai/orchestration.py - Answer orchestration → AI provider client: requests completion
ucc_intelligence/ucc_intelligence/ai/orchestration.py - AI provider client → OpenAI service: sends API request
ucc_intelligence/ucc_intelligence/ai/client.py - Operations workspace → Monitoring rules: reads rule definitions
ucc_intelligence/ucc_intelligence/operations/service.py - Operations workspace → Monitoring engine: runs monitoring
ucc_intelligence/ucc_intelligence/operations/service.py - Monitoring engine → Monitoring rules: evaluates rules
ucc_intelligence/ucc_intelligence/monitoring/engine.py - Operations workspace → Knowledge ingestion: manages indexing
ucc_intelligence/ucc_intelligence/operations/service.py - Knowledge ingestion → Knowledge retrieval: indexes sections
ucc_intelligence/ucc_intelligence/knowledge/ingestion.py - Whitelisted API → Knowledge retrieval: searches knowledge
ucc_intelligence/ucc_intelligence/api.py - Answer orchestration → Knowledge retrieval: retrieves facts
- Action approval → Action registry: resolves action
ucc_intelligence/ucc_intelligence/actions/service.py - Whitelisted API → Dashboard access: resolves access
ucc_intelligence/ucc_intelligence/api.py