🧬 Flask Track Docs

How Compliance Decisions Are Made

This document explains how Flask Track evaluates compliance during real laboratory execution.

Every time a user attempts to perform an operational action β€” such as creating, running, approving, exporting, or finalizing work β€” the compliance engine evaluates the full operational context before allowing the action to proceed.

Compliance decisions are:

Compliance is not manually assigned to workflows or batches.

It is derived dynamically from the actual biological materials, workflows, protocols, tools, plasmids, regulatory tags, framework rules, approvals, and user authorization state involved in the operation.


High-Level Decision Flow

Whenever an action is attempted, Flask Track evaluates the following sequence:

START
  ↓
1. What operational entities and materials are involved?
  ↓
2. What regulatory tags apply?
  ↓
3. What compliance levels do active frameworks derive?
  ↓
4. What enforcement rules apply?
  ↓
5. Are approvals required and present?
  ↓
6. Are certifications required and valid?
  ↓
FINAL DECISION:
   βœ“ Compliant
   ⚠ Requires Approval
   βœ– Blocked

This evaluation happens continuously at runtime.


Why the System Works This Way

Traditional compliance systems often rely on:

These approaches create risk because compliance state can become:

Flask Track instead derives compliance directly from operational relationships and execution context every time an action occurs.


Step 1 β€” Determine the Regulatory Surface

The first step is determining the full regulatory surface of the operational entity being evaluated.

A regulatory surface is the complete set of regulatory context associated with the entity.

The system evaluates all related biological, procedural, and operational components.


Workflow Evaluation

When evaluating a workflow, Flask Track examines:

The resulting regulatory surface represents the combined compliance implications of the workflow.


Batch Evaluation

When evaluating a batch, Flask Track examines:

Batches inherit compliance context from the workflows they instantiate.


Sample Evaluation

When evaluating a sample, Flask Track examines:

This allows sample-level compliance evaluation to remain biologically and operationally aware.


Example Regulatory Surface

A transformation workflow may produce a regulatory surface such as:

- GMO
- Recombinant DNA
- BSL-2
- Plant Pathogen
- Restricted Material

This surface becomes the basis for all downstream enforcement decisions.


Step 2 β€” Map Regulatory Tags to Compliance Levels

Regulatory tags alone do not determine operational behavior.

Each active compliance framework interprets those tags according to its own severity and enforcement model.


Framework Interpretation

Different frameworks may interpret the same regulatory tag differently.

Example:

Regulatory Tag Framework Derived Compliance Level
bsl2 Biosafety Framework Level 2
gmo Recombinant DNA Framework Level 2
plant_pathogen USDA Framework Level 3

This allows organizations to apply multiple governance models simultaneously.


Compliance Levels

Frameworks typically derive operational severity or compliance levels such as:

or:

These levels determine how aggressively the system enforces compliance requirements.


Step 3 β€” Apply Authorization Rules

Once compliance levels are derived, Flask Track evaluates authorization and enforcement rules.

Authorization rules define:

Rules are evaluated against:

This creates deterministic runtime enforcement behavior.


Example Authorization Rules

Compliance Level Entity Type Action Result
Level 2 Workflow Run Requires Approval
Level 3 Batch Export Blocked
Level 1 Sample Archive Allowed

Rules may vary significantly between frameworks.


Runtime Enforcement

Enforcement occurs before and during execution.

Examples include:

This allows Flask Track to proactively reduce operational and regulatory risk.


Step 4 β€” Approval Validation

Some compliance rules require explicit approval before execution may continue.

If approval is required, Flask Track checks:

If approval is missing:

⚠ Requires Approval

The action is paused until authorization is granted.


Approval Records

Approval records are stored per:

This preserves precise operational traceability.

Examples include:


Step 5 β€” Certification Validation

Organizations may optionally enforce certification-aware authorization systems.

If enabled, Flask Track validates whether the acting user holds the required certification level.

Examples include:

If certification requirements are not satisfied:

βœ– Blocked

The action cannot proceed.


Final Decision Outcomes

Every evaluation results in one of three final states.


βœ“ Compliant

The action is allowed to proceed.

Requirements satisfied include:

The operational action continues normally.


⚠ Requires Approval

The framework requires approval before the action may proceed.

Examples:

The entity must be formally approved before execution can continue.


βœ– Blocked

The action is explicitly prohibited under current conditions.

Examples include:

Blocked actions cannot proceed until the underlying issue is resolved.


What Determines Compliance?

Compliance decisions are derived entirely from operational and regulatory context.

This includes:

  1. Biological materials involved
  2. Tools and containment systems
  3. Plasmids and strains
  4. Workflow composition
  5. Active compliance frameworks
  6. Framework severity mappings
  7. Authorization rules
  8. Existing approvals
  9. User certifications
  10. Runtime operational state

Nothing is manually β€œmarked compliant.”


What Gets Evaluated?

Different entity types derive compliance from different operational sources.

Entity Type Derived From
Species Direct regulatory tags
Protocol Protocol-level tags and materials
Workflow Species + Protocols + Steps
Batch Workflow + Species + Runtime Context
Sample Batch + Workflow + Species + History

This creates highly contextual operational evaluation.


What Is Not Stored

Flask Track intentionally does not permanently store static compliance status.

Instead, compliance is recalculated dynamically every time an action is evaluated.

The system reevaluates:

This prevents:


Why Dynamic Evaluation Matters

Dynamic evaluation ensures compliance decisions always reflect the current operational and regulatory environment.

Benefits include:

The system always evaluates current reality rather than relying on historical assumptions.


Relationship to Checklists

Checklist applicability is evaluated as part of compliance enforcement.

Based on the derived compliance surface and active framework rules, Flask Track may:

Checklist applicability is dynamic and context-sensitive.


Relationship to Compliance Events

Operational incidents may also affect compliance decisions.

Examples include:

Compliance Events become part of the broader operational context considered during evaluation.


Runtime Operational Awareness

Compliance decisions are aware of:

This creates execution-aware compliance rather than static classification.


Auditability

Every compliance evaluation is traceable through:

This allows organizations to reconstruct why a decision was made at any point in time.


Practical Guidance for Users

Before running regulated work:

If the system reports:

⚠ Requires Approval

submit the entity for review under the applicable framework.

If the system reports:

βœ– Blocked

review:


Design Principles

The compliance engine is designed to be:

Every compliance decision is explainable and reconstructable.


Summary

Flask Track determines compliance dynamically from the real operational composition of laboratory work.

The system continuously evaluates:

  1. What materials and workflows are involved
  2. Which regulatory tags apply
  3. How active frameworks interpret those tags
  4. Which enforcement rules apply
  5. Whether approvals are present
  6. Whether users are authorized and certified

The resulting decisions are:

Compliance is not manually assigned.

It is continuously derived from real laboratory execution.