Skip to content

Interface Overview

This guide covers the main interface elements and navigation patterns in ProEthica.

Access Levels

ProEthica operates in demo mode by default, allowing exploration of cases and extracted entities without authentication. The interface adapts based on access level:

Level Access Available Features
Anonymous (Demo) No login required Browse cases, view extractions, explore precedent network, read guidelines
Authenticated Login required Run extractions, edit entities, manage pipeline queue
Admin Admin account User management, domain configuration, system settings

Users exploring the demo will see view-only interfaces. Buttons for extraction, editing, and pipeline operations appear only for authenticated users. This documentation describes the full interface as seen by authenticated users.

The top navigation provides access to main features:

Menu Item Type Contents
Home Link Return to home page
[Domain] Dropdown Current domain (e.g., Engineering), Manage Domains, Create New
Cases Link Case repository
Precedents Dropdown Find Precedents, Similarity Network
Guidelines Link Browse ethical guidelines and codes of ethics
Docs Link This documentation
Tools Dropdown Academic References, OntServe Web, Browse Ontologies; Admin Tools (admin only): Pipeline Dashboard, Queue Management, Validation Studies
[User] Dropdown User menu with Logout

The domain dropdown (e.g., "Engineering") reflects the currently active professional domain and provides access to domain management.

Cases Section

Case Repository

The Cases page (/cases/) displays all uploaded cases with:

  • Year grouping for chronological organization
  • Subject tags for filtering by topic
  • Pipeline status indicators (pending, in progress, complete)
  • Quick actions for each case

Case Repository

Case Detail

Each case has a detail page showing:

  • Case title, reference number, and metadata
  • Full narrative with Facts and Discussion sections
  • Structure button - View document sections and embeddings
  • Numbered step buttons (1-4) - Launch extraction steps in sequence

Case Detail

Document Structure

The Structure view (/cases/<id>/structure) provides:

  • Section breakdown with character counts
  • Embedding status and regeneration controls
  • Similar cases based on semantic matching

Case Structure

Extraction Pipeline

The pipeline (/scenario_pipeline/<case_id>) provides step-by-step case analysis:

Step Name Description Status
1 Contextual Framework Extract Roles, States, Resources from Facts and Discussion Implemented
2 Normative Requirements Extract Principles, Obligations, Constraints, Capabilities Implemented
3 Temporal Dynamics Extract Actions, Events, Causal Relationships Implemented
4 Case Synthesis Four-phase analysis: provisions, questions, decision points, narrative Implemented

Pipeline Overview

Step buttons at the top of case pages indicate completion status:

  • Green (btn-success) - Step completed
  • Blue outline - Step available, ready to run
  • Gray outline (disabled) - Prerequisites not met

Pipeline Overview

Entity Review

After each extraction, the review page displays:

  • Extracted entities organized by concept type
  • Section toggle (Facts vs Discussion)
  • Delete controls for each entity
  • Re-run button to return to extraction
  • View Extraction button to see the original LLM prompt and response

Entity Review

Precedent Discovery

The Precedents page (/cases/precedents/) provides:

  • Similarity scores based on document embeddings
  • Breakdown by section (Facts, Discussion)
  • Filter by specific case or view all pairs

Precedent Discovery

Similarity Network

The network view (/cases/precedents/network) visualizes case relationships:

  • Node color indicates case outcome (green: ethical, red: unethical, orange: mixed)
  • Edge color indicates similarity strength
  • Click nodes for case details
  • Click edges for similarity breakdown

Similarity Network

Pipeline Automation

For batch processing, the Pipeline Dashboard (/pipeline/dashboard) shows:

  • Service status (Redis, Celery, queue depth)
  • Active pipeline runs with progress bars
  • Queue management controls

Pipeline Dashboard

Status Indicators

Service Status

The header shows service connectivity:

  • Green - All services operational
  • Yellow - Some services unavailable
  • Red - Critical services offline

Entity Status

Entities in review display their state:

  • New - Extracted this session
  • Existing - Matches ontology class
  • Modified - User-edited entity

Keyboard Shortcuts

Shortcut Action
Ctrl+Enter Submit current form
Esc Close modal dialogs