How moalimjaveed/mocs-cert works
MOCS-Cert is a molecular-dynamics trajectory query engine with a scientific workstation. A user submits a declarative query; the backend compiles and executes it against trajectory data and spatial indexes, refines uncertain intervals, and emits evidence that can be audited. The UI exposes query, visualization, timeline, certificate, benchmark, and workflow views. Workflow orchestration and ecosystem integrations form a separate capability. The README documents these capabilities; unsampled endpoint and frontend source limits which implementation-level links can be asserted.
Main entry points: compiler_service.py Query compiler · trajectory_service.py Trajectory service · main.py FastAPI application · query_stream.py Query stream
Components 24
API and execution
- FastAPI application
backend/app/main.py - Query endpoint
backend/app/api/endpoints/query.py - Query stream
backend/app/api/websockets/query_stream.py - Trajectory service
backend/app/core/trajectory_service.py - Workflow endpoint
backend/app/api/endpoints/workflow.py - Molecular endpoints
backend/app/api/endpoints/molecular.py
Certified query engine
- Query compiler
backend/app/core/compiler_service.py - Plan selector
mocs/planner/plan_selector.py - Trajectory I/O
mocs/io/mda_source.py - MCI index
mocs/mci/reader.py - Periodic bounds
mocs/bounds/periodic_bounds.py - Certificate auditor
mocs/certificates/auditor.py
Scientific workflows
- Workflow engine
mocs/workflow/engine.py - Workflow pipelines
mocs/workflow/pipelines - Structural selection
mocs/workflow/pipelines/selection_pipeline.py - Backend ecosystem
mocs/ecosystem/registry.py
Scientific workstation
- React workstation
frontend/src/App.tsx - Query editor
frontend/src/components/editor/MonacoQueryEditor.tsx - Refinement timeline
frontend/src/components/timeline/TimelineLattice.tsx - Certificate inspection
frontend/src/components/proof/CertificateAuditorModal.tsx - Molecular viewer
frontend/src/components/viewer/MolecularViewport.tsx - Workflow workspace
frontend/src/components/views/WorkflowOrchestrationView.tsx - Benchmark view
frontend/src/components/views/ExecutionBenchmarksView.tsx
Other components
- Researcher
Connections 27
- Researcher → React workstation: uses
README.md - React workstation → Query editor: edits queries
README.md - Query editor → Query endpoint: submits query
README.md - FastAPI application → Query endpoint: mounts route
backend/app/main.py - FastAPI application → Query stream: mounts socket
backend/app/main.py - FastAPI application → Workflow endpoint: mounts route
backend/app/main.py - FastAPI application → Molecular endpoints: mounts route
backend/app/main.py - Query endpoint → Query compiler: invokes
backend/app/api/endpoints/query.py - Query stream → Trajectory service: refines blocks
backend/app/api/websockets/query_stream.py - Query stream → Query compiler: compiles query
backend/app/api/websockets/query_stream.py - Query compiler → Plan selector: selects plan
backend/app/core/compiler_service.py - Query compiler → Trajectory service: resolves trajectory
backend/app/core/compiler_service.py - Query compiler → Periodic bounds: computes bounds
backend/app/core/compiler_service.py - Query compiler → MCI index: reads index
backend/app/core/compiler_service.py - Query compiler → Certificate auditor: audits evidence
backend/app/core/compiler_service.py - Trajectory service → MCI index: loads blocks
backend/app/core/trajectory_service.py - Trajectory service → Periodic bounds: computes PBC bounds
backend/app/core/trajectory_service.py - Trajectory service → Trajectory I/O: opens source
backend/app/core/trajectory_service.py - Refinement timeline → Query stream: requests refinement
- Certificate inspection → Certificate auditor: inspects proof
README.md - Molecular viewer → Molecular endpoints: loads structures
- Researcher → Workflow workspace: orchestrates workflows
README.md - Workflow endpoint → Workflow engine: dispatches workflow
- Workflow engine → Workflow pipelines: runs pipelines
mocs/workflow/engine.py - Workflow engine → Backend ecosystem: discovers backends
mocs/workflow/engine.py - Structural selection → Workflow pipelines: supports selection
- Researcher → Benchmark view: reviews benchmarks
README.md