System Documentation

Product Specification & Technical Overview

Document Version:3.0Date:June 2026Classification:ConfidentialPrepared by:RobLabs U — Development Team

Table of Contents

1. System Overview 2. Core Features & Modules 3. User Roles & Access Control 4. Data Structure & Storage 5. Technical Infrastructure 6. Security & Data Protection 7. How It Works — System Workflows 8. External Integrations 9. Administration & Configuration 10. Reports & Outputs 11. Backend Functions Reference 12. Roadmap & Future Enhancements 13. SuperAdmin — Data Export

1. System Overview

What Is OMICS Precision Health?

OMICS Precision Health is a comprehensive personalized preventive healthcare platform designed for precision medicine and longevity clinics. It centralizes patient health data — including genetic analysis, blood test results, multi-OMICS reports, wearable device metrics, and clinical questionnaires — and transforms it into actionable, AI-powered health insights and recommendations.

The platform functions as a purpose-built Electronic Medical Record (EMR) system that enables multidisciplinary care teams to collaborate on patient health optimization through data-driven protocols, personalized supplement regimens, peptide therapy recommendations, and professionally formatted PDF reports.

Key Objectives

Centralize all patient health data from multiple sources into a single platform
Deliver AI-powered analysis and personalized health recommendations
Facilitate multidisciplinary care team collaboration (physicians, nutritionists, nurses, coordinators)
Generate professional, clinic-branded PDF reports for patients and clinicians
Calculate biological age and comprehensive health risk scores
Track patient health progress over time with longitudinal dashboards

Who Is It For?

Precision medicine and longevity clinics
Health professionals — physicians, naturopathic doctors, nutritionists, nurses, health coaches, exercise physiologists
Clinic administrators and patient coordinators
Patients seeking personalized, data-driven preventive healthcare
VVIP and concierge medicine programs

2. Core Features & Modules

Patient Management

Complete patient registration with demographics, medical history, and kit number tracking
Guided patient onboarding flow with consent forms and medical history intake
Configurable care team assignment per patient (physician, nurse, coordinator)
Per-patient communication permissions (who can message whom)
Dedicated patient portal for self-service access to reports, questionnaires, and health data

Genetic Analysis

Upload and process genetic data files (JSON and raw DNA data up to ~20 MB)
AI-powered genetic PDF report analysis and variant extraction
Built-in gene database with variants, genotypes, and risk level classification
Interactive Genetic Signature visualization — 3D planet view and 2D genetic map
Genetic Signature Decoder — verify printed genetic signatures against source data for authenticity
MetaPath Analysis — metabolic pathway assessment based on genetic variants

Blood Test Analysis

Automated blood test PDF extraction using a multi-stage AI pipeline
Lab results dashboard organized by clinical category (Thyroid, Lipids, Hormones, Blood Count, etc.)
AI-generated reference ranges with age and gender specificity
Visual gradient bars showing where each value falls across Low → Below Optimal → Optimal → Above Optimal → High zones
Blood test evolution tracking — compare results across multiple dates
Suspect value detection with AI-powered validation and correction suggestions
Advanced unit conversion engine (mass/molar, CBC unit normalization)
Blood Panel Dashboard with composite risk scoring (metabolic, cardiovascular, inflammatory)

OMICS Analysis

Support for 8 OMICS disciplines: Proteomics, Metabolomics, Transcriptomics, Genomics, Epigenomics, Lipidomics, Glycomics, and Microbiomics
AI-powered parsing of OMICS reports from uploaded PDFs and images
Clinical interpretation with biomarker extraction and pathway analysis
Template-based OMICS report management

Biological Age Calculation (RoBioAge)

Proprietary multi-domain biological age algorithm using blood markers, genetics, and OMICS data
Fully configurable marker weights, population statistics, and scaling parameters
Health domain breakdown: Cardiovascular, Metabolic, Inflammation, Liver, Kidney, Hematologic, Hormonal, Neuro/Sleep/Stress
Confidence scoring, quality control flags, and age acceleration metrics

AI Recommendations Engine

Personalized supplement recommendations organized into 3 phases: Foundation → Therapeutic → Optimization
Diet and nutrition plans based on genetics, blood markers, and health conditions
Peptide therapy analysis with FDA approval status tracking and synergy evaluation
Exercise recommendations tailored to genetic profile and health goals
Cosmetic and beauty analysis — skin aging forecasts, botox/filler recommendations with genetic-based dosing
Full physician override — doctors can manually adjust or replace AI recommendations

PDF Report Generation

Patient Report — comprehensive health overview with lab analysis, risk mapping, treatment protocol, and daily schedule
Beauty Report — dermatological and aesthetic genetic analysis with treatment recommendations
Supplements Report — phased supplement plan with timing, monitoring, and safety notes
Peptides Report — therapeutic peptide recommendations with dosing protocols
Wellness Report — clinical summary with starter protocols for new patients
MetaPath Report — metabolic pathway analysis with visual representations
All reports support inline editing by the professional before final generation
Clinic-branded cover pages with customizable logos and artwork

Questionnaires & Clinical Assessments

Pre-built health questionnaire templates with full editing capability
Custom questionnaire builder for clinic-specific intake forms
Specialized neuropsychology questionnaire support
Questionnaire assignment and completion tracking workflow
AI-powered questionnaire summary generation for clinician review
Multidisciplinary care team assessment builder

Communication & Collaboration

Built-in secure messaging system between care team members and patients
Conversation threads with search and message management
Patient education content delivery and tracking
Task assignment system with priorities, due dates, and status tracking
Clinical notes with AI-assisted analysis and summarization

Wearable Device Integration

Secure connections to Fitbit, Garmin, and Google Fit via OAuth
Automated data sync for steps, heart rate, sleep quality, activity levels, calories, and distance
AI-powered wearable data analysis and health trend detection

Prescriptions & Treatment Protocols

Protocol template builder with dynamic variable substitution
One-click protocol assignment to individual patients
Prescription management across categories: BHRT, IV Therapy, Lifestyle, Medications, Peptides, and Supplements
AI-powered prescription recommendations based on full patient context
Medication reminder system with adherence tracking

Multi-Language Support

Full internationalization across 5 languages: English, Portuguese, Hebrew, Turkish, and Spanish
Right-to-left (RTL) layout support for Hebrew
Language switcher accessible from sidebar and mobile interface

3. User Roles & Access Control

The system features a granular role-based access control (RBAC) model. Each user is assigned one or more roles, and their access permissions are automatically determined based on a customizable permissions matrix. Clinic administrators can fine-tune permissions per individual user when needed.

System Roles

Role	Type	Access Summary
Super Admin	Administrator	Unrestricted access to all system features, data, and configurations.
Clinic Admin	Administrator	Full clinic management — staff accounts, patients, roles & permissions, protocols, analytics, lab references.
Physician / Medical Doctor	Clinical	Complete patient data access, protocol and prescription management, clinical notes, all report types.
Naturopathic Doctor	Clinical	Full clinical access, same as Physician, with emphasis on natural health approaches.
Nurse	Clinical	Patient management, questionnaires, education, full patient overview, file uploads, task assignments.
Coordinator	Operations	Patient creation, questionnaire/education delivery. Limited patient overview — no access to clinical data or files.
Data Feeder	Operations	Lab reference management, data entry, file uploads. Limited patient overview.
Practitioner	Clinical	Full clinical access — education, questionnaires, recommendations, clinical notes, patient overview.
Neuropsychologist	Clinical	Full clinical access with additional specialized access to neuropsychology assessments.
Dietician	Clinical	Full clinical access with emphasis on nutrition planning and dietary recommendations.
Health Coach	Clinical	Full clinical access for wellness coaching, lifestyle optimization, and patient education.
Osteopath	Clinical	Full clinical access for musculoskeletal assessment and treatment planning.
Exercise Physiologist	Clinical	Full clinical access with focus on exercise programming and physical fitness assessments.
Clinic Management	Operations	Read-only view of education, questionnaires, reports tracking, and analytics dashboards.
Patient	End User	Personal health dashboard, report viewing, questionnaire completion, messaging, and education content.

Permission Categories (13 Areas)

Roles & Permissions — Configure roles and assign them to users
Staff Accounts — Create, edit, deactivate, and delete staff users
Patient Accounts — Create patients, edit profiles, assign care teams, send questionnaires, manage access
Education — View, create, and distribute educational content
Questionnaires — View, build, and send health questionnaires
Reports — Track report generation status and view report counts
Assignments — Create and manage task assignments across the team
Protocols — Build, edit, and delete treatment protocol templates
Analytics — Access cohort analysis and aggregate performance metrics
Lab References — Manage the laboratory reference ranges database
Dashboard — View patient counts, report statistics, and patient lists
Patients Section — View patients, send questionnaires/education, upload files
Patient Overview — Granular control over 20+ individual tabs (Blood Dashboard, OMICS, Genetics, Reports, Prescriptions, Clinical Notes, etc.)

How Permissions Are Resolved

Per-user overrides — If the admin has set specific permissions for an individual user, those take the highest priority.
Custom permissions matrix — If the admin has customized the role-permissions matrix, those settings are applied.
Default role permissions — The system's built-in defaults serve as the baseline.
Multi-role merging — When a user holds multiple roles, all permissions from every role are combined (union).

4. Data Structure & Storage

The system organizes data into structured entities (similar to database tables). Below is a summary of the main data categories and what information is stored.

Patient & Clinical Data

Data Category	What Is Stored
Patient Records	Full name, age, gender, date of birth, weight, height, blood type, medical history, kit number, MRN, assigned care team, communication permissions
Lab Results	Individual blood test values with test name, value, unit, collection date, and original lab reference ranges
Lab Reference Ranges	Clinically-validated reference ranges with 5-zone classification (Low, Below Optimal, Optimal, Above Optimal, High), organized by gender and age group
Reports	Genetic data, blood test summaries, OMICS analyses, AI-generated recommendations, inline edits, and report status
Recommendations	Personalized supplements, diet, exercise, and peptide recommendations with dosage, phase, priority, and related genes/markers
Biological Age	Calculated biological age, domain scores (cardiovascular, metabolic, etc.), confidence score, and raw input data snapshot
Clinical Notes	Structured clinical notes with AI-powered analysis and extraction of findings, recommendations, and action items
Prescriptions	Medication and therapy prescriptions with AI recommendation support

Organizational Data

Data Category	What Is Stored
Clinics	Clinic name, address, contact info, logo, report cover artwork, status
Staff / Professionals	Name, professional type, specialty, license number, clinic assignment, login credentials, status
System Users	User roles, assigned permissions, clinic assignment, patient assignments, account status

Knowledge Bases

Data Category	What Is Stored
Gene Database	Gene catalog with descriptions, variants, and enrichment data
Genotype Details	Variant-level information including risk classifications
Biomarker Configuration	Display settings, units, conversion factors, and scoring weights for each biomarker
Supplement Catalog	Product information with SKUs, pricing, dosage, and images
Peptide Knowledge	Peptide therapy information with FDA status and mechanisms of action
Metabolic Pathways	MetaPath data linking genes, variants, and metabolic pathway impacts
Scientific References	Peer-reviewed literature citations used in reports

Communication & Workflow Data

Data Category	What Is Stored
Messages	Secure conversations between care team and patients
Assignments	Tasks with assignee, type, priority, due date, and completion status
Education Content	Educational materials sent to patients with read tracking
Questionnaires	Templates, patient responses, and completion tracking
Appointments	Scheduled consultations with provider, date, status, and meeting links
Wearable Data	Synced health metrics from connected fitness devices
Access Logs	Complete audit trail — who accessed what, when, and from where
Uploaded Files	Patient files (blood tests, genetic data, OMICS) with processing status

5. Technical Infrastructure

Architecture Overview

Cloud-hosted web application accessible from any modern browser (desktop and mobile)
Single-page application (SPA) architecture for fast, responsive user experience
Serverless backend — functions scale automatically based on demand
Managed cloud database with automatic backups
Secure cloud file storage for patient documents, with both public and private access tiers
Separate Production and Test environments with independent data stores

How Data Flows Through the System

Upload — Clinic staff uploads patient files (blood test PDFs, genetic data, OMICS reports) through the web interface.
AI Extraction — The system's AI engines automatically extract structured data from uploaded documents.
Normalization — Extracted values are standardized (unit normalization, biomarker name resolution, deduplication).
Reference Matching — Lab results are compared against the reference ranges database to classify each value into health zones.
AI Analysis — Multiple AI pipelines generate personalized recommendations, risk scores, and clinical insights based on the full patient profile.
Presentation — Results are displayed in interactive dashboards and can be exported as professionally formatted PDF reports.

6. Security & Data Protection

Authentication

Secure token-based session authentication
Separate username/password credentials for patients, professionals, and administrators
JWT (JSON Web Token) based session management with encrypted tokens
Multi-tab session support — users can work across multiple browser tabs simultaneously
Automatic session validation — credentials are re-verified periodically on every page navigation

Authorization

Granular role-based access control (RBAC) with 14+ configurable roles
Fully customizable permissions matrix — administrators can tailor access per role
Per-user permission overrides for exceptional access requirements
Multi-role support — a single user can hold multiple roles with combined permissions
Page-level and component-level access enforcement — unauthorized users are automatically redirected
Super Admin override for emergency or system-wide access

Data Protection Measures

All data transmission encrypted via HTTPS (TLS)
Cloud-hosted database with enterprise-grade security infrastructure
Private file storage with time-limited signed URLs for sensitive patient documents
Complete access audit trail — every user action is logged with IP address, timestamp, and device information
Patient privacy code verification required before accessing sensitive health data
Configurable communication permissions — control which care team members can message each patient
Automatic account lockout — deactivated accounts are detected and logged out on next navigation
All backend operations verify user identity and authorization before processing

7. How It Works — System Workflows

Initial Clinic Setup

The Super Admin creates the clinic profile (name, branding, contact information).
A Clinic Admin account is created and assigned to the clinic with full management access.
The Clinic Admin creates staff users (physicians, nurses, coordinators) and assigns appropriate roles.
Laboratory reference ranges are imported or generated to establish the clinical reference database.
Health questionnaire templates are configured for patient intake.

Patient Journey — Step by Step

Registration — A coordinator or admin creates the patient profile with demographics and kit number.
Onboarding — The patient completes a guided onboarding flow: personal information, medical history, and consent forms.
Data Collection — Blood test PDFs, genetic data files, OMICS reports, and/or raw DNA data are uploaded to the system.
AI Processing — Uploaded files are automatically parsed and converted into structured data using multi-stage AI pipelines.
Analysis — Blood results are matched to reference ranges; genetic data is analyzed for risk factors; biological age is calculated.
Recommendations — The AI generates personalized supplement, diet, exercise, and peptide therapy recommendations.
Professional Review — The assigned physician reviews and refines AI-generated content using inline editing tools.
Report Generation — Finalized PDF reports are generated with clinic branding and professional formatting.
Report Delivery — Reports are shared with the patient through their secure "My Reports" portal.
Ongoing Follow-up — Questionnaires are sent, appointments are scheduled, wearable data is monitored, and progress is tracked over time.

Blood Test Processing Pipeline

When a blood test PDF is uploaded, the system processes it through the following stages:

Upload & Storage — The PDF is securely stored and linked to the patient record.
Structural Extraction — AI extracts marker names, values, units, and lab reference ranges from the document.
Name Resolution — Markers are mapped to standardized canonical names (e.g., "SGPT" → "ALT").
Unit Normalization — Units are standardized to ensure consistency (e.g., mIU/mL → IU/L equivalence).
Ambiguity Resolution — AI resolves decimal point errors and scientific notation ambiguities common in PDF extraction.
Validation Audit — Values are cross-checked against expected biological ranges and flagged if suspect.
Final Storage — Corrected and validated results are saved to the database.
Dashboard Display — Results appear on the patient's Blood Results dashboard with visual zone indicators.

8. External Integrations

Artificial Intelligence

Integration	Purpose
OpenAI GPT-4o	Primary AI model — genetic PDF analysis, blood test extraction, recommendation generation, clinical interpretations
Multi-Model AI Gateway	Secondary AI interface supporting multiple models (GPT-4o-mini, Claude Sonnet, Gemini Flash) for reference range generation, OMICS parsing, and general analysis tasks
AI Image Generation	Generates visual content for patient reports and educational materials

File Processing & Storage

Service	Purpose
Cloud File Upload	Secure file upload for patient documents, clinic logos, and attachments
Private Document Storage	Encrypted storage for sensitive files with time-limited access links
AI Data Extraction	Extracts structured data from CSV, Excel, PDF, and image files using AI

Communication

Service	Purpose
Email Service	Automated email notifications for report delivery, reminders, and system alerts

Wearable Devices

Device Platform	Data Collected
Fitbit	Steps, heart rate, sleep quality, activity levels
Garmin	Steps, heart rate, sleep patterns, sports activities
Google Fit	Steps, heart rate, sleep, general wellness metrics

Data Exchange

All communications use encrypted JSON over HTTPS
Supported upload formats: PDF, CSV, Excel (XLSX), JSON, PNG, JPG
Real-time data subscriptions for live dashboard updates

9. Administration & Configuration

Super Admin Capabilities

Area	What You Can Do
Database Management	Manage lab reference ranges, metabolic pathways, gene/genotype data, scientific references, peptides, synergies, cosmetics, supplements, and knowledge base articles
Questionnaire Management	Create, edit, and seed questionnaire templates; export to Excel; build custom questionnaires
Clinic Management	Create and manage clinics with custom branding (logos, report artwork)
Professional Management	Create health professional accounts with login credentials and clinic assignment
System Branding	Configure system-wide logo and PDF report logos
Access Logs	Review complete user activity audit trail with IP addresses, timestamps, and locations
Biological Age Config	Configure RoBioAge marker weights, scaling parameters, thresholds, and combination formulas
Navigation Config	Customize the sidebar navigation menu structure
Permissions Matrix	Define and customize role-based permissions for every system function
Supplement Catalog	Manage the product catalog with SKUs, pricing, descriptions, and images

Clinic Admin Capabilities

Area	What You Can Do
Patient Management	Add, edit, and manage patient profiles and access credentials
Reports Tracking	Monitor report generation progress, status, and history
Staff Management	Create and manage clinic users with role assignment and patient allocation
Task Assignments	Create, assign, and track tasks across the care team
Education	Create and send educational content to patients
Questionnaires	Configure, assign, and track patient questionnaires
Protocols	Build and assign treatment protocol templates
Analytics	Run cohort analysis and view aggregate performance reports
Lab References	Manage laboratory reference ranges and exam analysis rules
Exam Database	Manage the exam database with AI-powered analysis rule configuration

10. Reports & Outputs

Interactive Dashboards

Dashboard	Description
Patient Dashboard	Health overview showing data completeness, biological age, BMI, and questionnaire status
Blood Panel Dashboard	Composite risk scores (metabolic, cardiovascular, inflammatory) with systems impact visualization
Blood Results View	All biomarkers organized by category with visual gradient bars and zone classification
Blood Evolution	Longitudinal tracking of biomarker trends across multiple test dates
Longitudinal Dashboard	AI-generated trend analysis covering all health domains over time
OMICS Dashboard	Multi-OMICS data visualization with clinical interpretation
Health Dimensions Radar	Multi-axis radar chart showing health scores across all domains

PDF Reports

Report	Contents
Patient Report	Executive summary, lab analysis, clinical profile, risk map, treatment protocol, supplement plan, monitoring plan, daily schedule
Beauty Report	Skin aging analysis, botox recommendations, filler analysis, cosmetic treatment plan
Supplements Report	3-phase supplement plan (Foundation → Therapeutic → Optimization) with timing, monitoring, and safety notes
Peptides Report	Therapeutic peptide recommendations with dosing, synergies, and regulatory status
Wellness Report	Clinical summary, multi-interpretation, supplement plan, and starter protocol
MetaPath Report	Metabolic pathway analysis with visual pathway maps
Genetic Report	Genetic findings, variant analysis, and personalized genetic signature visualization
OMICS Report	OMICS-specific analysis with clinical interpretation and biomarker data

Data Exports

Blood Results Excel — Complete lab results with reference ranges in spreadsheet format
Biomarker Configuration — Full biomarker settings including units, conversions, and functional medicine ranges
OMICS Optimal Ranges — Functional medicine reference ranges in downloadable format
Questionnaire Export — Templates and patient responses in Excel format
Cohort Analysis — Aggregate clinical data export in JSON format

11. Backend Functions Reference

The system uses 100 backend functions organized into 12 categories. Each function runs as an independent serverless handler with automatic scaling.

Blood Test Processing

Multi-stage AI pipeline for extracting, validating, and persisting blood test data from uploaded PDFs.

processBloodTestV2Main V2 blood test processing pipeline — orchestrates extraction, canonicalization, unit normalization, cross-check, and final audit decision.

processBloodTestV2ExtractAI structural extraction stage — extracts marker names, values, units, and reference ranges from PDF documents.

processBloodTestV2QuickLightweight quick-extraction mode for faster turnaround on standard lab formats.

persistV2ToSystemPersists validated V2 extraction results to the LabResult entity with deduplication and canonical mapping.

processBloodTestFileLegacy V1 single-file blood test processor.

processBloodTestFilesLegacy V1 batch blood test processor.

persistJsonLabResultsPersists manually entered or JSON-imported lab results to the database.

computeBloodPanelDashboardCalculates composite risk scores (metabolic, cardiovascular, inflammatory) from latest lab results for the Blood Panel Dashboard.

AI Analysis & Recommendations

AI-powered analysis engines that generate personalized health insights from patient data.

analyzePatientDataComprehensive AI patient analysis combining genetics, blood tests, and clinical data to generate personalized insights.

analyzeSkinAgingAI analysis of genetic factors affecting skin aging with personalized dermatological recommendations.

analyzeBotoxAI-generated botox treatment recommendations based on genetic profile and facial aging analysis.

analyzeFillersAI-generated dermal filler recommendations based on genetic factors and aging patterns.

analyzePeptidesAI analysis of therapeutic peptide options based on patient health profile and goals.

analyzeLifestyleAI lifestyle optimization recommendations based on genetics, blood markers, and health conditions.

analyzeClinicalNoteAI-powered clinical note analysis — extracts findings, diagnoses, and recommended actions.

analyzePatientChatAI assistant for patient-facing chat — answers health questions based on patient data context.

analyzeWearableDataAI analysis of wearable device data to detect health trends and generate actionable insights.

analyzeBibliographyAI analysis of scientific literature for evidence-based citation linking in reports.

analyzeOmicsAI interpretation of OMICS data (proteomics, metabolomics, etc.) with clinical significance assessment.

analyzeOmicsAdvancedAdvanced multi-OMICS cross-analysis with pathway integration and biomarker correlation.

detectPatientAnomaliesAI anomaly detection across patient data to flag unusual patterns or concerning trends.

Report Generation

Backend functions that generate AI-powered content for PDF reports.

generatePatientReportGenerates comprehensive patient report data — executive summary, lab analysis, risk map, treatment protocol, daily schedule.

generateSupplementsReportGenerates 3-phase supplement plan with timing, monitoring, safety notes, and peptide recommendations.

generateWellnessReportGenerates wellness report with clinical summary, starter protocols, and lifestyle recommendations.

generateHealthSummaryGenerates overall health summary integrating all available patient data sources.

generateNutritionPlanAI-generated personalized nutrition plan based on genetics, blood markers, and health goals.

generateActionPlanGenerates structured action plan with prioritized health interventions.

generateRawDataSummaryGenerates summary report from raw DNA data file analysis.

generateQuestionnaireSummaryAI-generated summary of patient questionnaire responses for clinician review.

generateResultSummaryAI-generated summary and review of uploaded medical results (imaging, lab reports, specialist reports).

generateCohortReportGenerates aggregate cohort analysis report across multiple patients.

generateLongitudinalDashboardAI-generated longitudinal trend analysis covering all health domains over time.

generateMetaPathPDFGenerates metabolic pathway analysis report with visual pathway representations.

generateRoBioAgeRecommendationsAI recommendations for improving biological age based on RoBioAge calculation results.

generatePDFServer-side PDF generation utility for report export.

generateOmicsAIInterpretationGenerates AI clinical interpretation of OMICS data for report inclusion.

Biological Age Calculation

Proprietary multi-domain biological age algorithm.

calculateBioAgeLegacy biological age calculation using basic blood markers.

calculateRoBioAgeFull RoBioAge calculation engine — multi-domain scoring (cardiovascular, metabolic, inflammation, liver, kidney, hematologic, hormonal, neuro) with configurable weights.

calculatePatientComparisonCalculates how a patient compares to population averages across health metrics.

Data Import & Seeding

Functions for importing, seeding, and maintaining reference databases.

seedLabReferencesSeeds initial laboratory reference ranges from curated clinical data.

seedMissingLabReferencesIdentifies missing lab references and generates AI-powered ranges to fill gaps.

seedGenotypeDetailsSeeds genotype detail records from source data.

seedMetaPathVariantSeeds individual metabolic pathway variant data.

seedCosmeticsFromWebSeeds cosmetic knowledge base from web sources.

importSupplementCatalogImports supplement catalog from Excel/CSV with distributor and brand mapping.

importMetaPathVariantsBatch imports metabolic pathway variants.

importExamTemplateImports medical examination templates from structured files.

importGenotypesFromXLSXImports genotype data from Excel spreadsheets.

importOmicsLabRangesImports OMICS-specific laboratory reference ranges.

Data Maintenance & Cleanup

Utilities for database maintenance, deduplication, and migration.

cleanLabReferencesCleans and normalizes lab reference range records.

cleanMetaPathDuplicatesRemoves duplicate metabolic pathway entries.

cleanVariantDuplicatesRemoves duplicate genetic variant records.

cleanSupplementsListCleans and normalizes supplement catalog entries.

deduplicateExamDatabaseRemoves duplicate exam database entries.

deleteAllVariantsBulk deletes all variant records (admin utility).

fixOverlappingRangesDetects and fixes overlapping age/gender ranges in lab references.

fixExamNamesNormalizes exam names across the exam database.

fixLabCategoriesCorrects lab reference category assignments.

fixPathwayGeneNamesNormalizes gene names in metabolic pathway records.

findDuplicateLabRefsIdentifies duplicate lab reference entries for review.

resetVariantSeedingResets variant seeding state for re-import.

Data Enrichment

AI-powered enrichment of reference databases with additional clinical context.

enrichLabReferencesAI enrichment of lab references with clinical significance, description, and scoring metadata.

enrichLabTestAliasesGenerates and assigns common test name aliases for improved matching.

enrichGeneDatabaseAI enrichment of gene database with descriptions, pathways, and clinical relevance.

enrichVariantsAI enrichment of genetic variants with risk classifications and clinical data.

enrichVariantBatchBatch processing of variant enrichment for large datasets.

enrichVariantsStreamStreaming variant enrichment for real-time processing.

correctVariantsFromGenotypesCorrects variant data by cross-referencing against genotype records.

populateMetaPathVariantsPopulates metabolic pathway variant relationships.

categorizeLabReferencesAI-powered categorization of lab references into clinical categories.

reviewLabReferencesAI review of lab reference ranges for accuracy and completeness.

reviewExamDatabaseAI review of exam database entries for accuracy.

updateLabOptimalRangesUpdates optimal ranges based on functional medicine guidelines.

verifyRiskLevelsFromXLSXVerifies risk level classifications against reference Excel data.

Migration & Sync

Data migration between schema versions and external sync utilities.

migrateLabReferencesMigrates lab reference data between schema versions.

migrateLabMarkersToReferenceMigrates legacy LabMarkersConfig data to LabReference entity.

migrateOmicsToLabReferenceMigrates OMICS range data into the unified LabReference system.

syncLabReferencesFromExcelSynchronizes lab references from an authoritative Excel source.

updateLabRefsFromExcelUpdates specific lab reference fields from Excel data.

syncQuestionnaireToPatientSyncs questionnaire completion data to patient records.

syncWearableDataSyncs health data from connected wearable devices (Fitbit, Garmin, Google Fit).

extractExamTemplateExtracts structured exam templates from uploaded documents.

Authentication & Security

User authentication, session management, and access control.

secureLoginMain authentication handler — validates credentials for patients, professionals, and admins; generates JWT session tokens; logs access with IP/geolocation.

validateSessionValidates existing JWT session tokens and returns user identity.

createPatientUserCreates patient user accounts with login credentials.

simulateAuditErrorTesting utility to simulate security audit events.

Communication

Messaging and notification functions.

sendMessageSends messages between care team members and patients.

emailRecommendationsEmails personalized health recommendations to patients.

saveRecommendationsSaves AI-generated recommendations to the patient record.

reprocessQuestionnaireReprocesses questionnaire responses through AI analysis pipeline.

Wearable Device Integration

OAuth and data sync for fitness/health wearables.

oauthFitbitHandles Fitbit OAuth2 authorization flow for wearable data sync.

oauthGarminHandles Garmin OAuth authorization flow.

oauthGoogleFitHandles Google Fit OAuth2 authorization flow.

Knowledge Processing

Functions for processing and managing clinical knowledge content.

processKnowledgeBaseProcesses and indexes knowledge base articles for AI retrieval.

processKnowledgeInputProcesses new knowledge input and creates structured entries.

processOmicsReportProcesses uploaded OMICS reports with AI extraction and interpretation.

callMetaPathAPICalls external metabolic pathway API for pathway analysis.

analyzeGeneticPdfAI analysis of genetic PDF reports with variant extraction and risk assessment.

detectCropRegionAI detection of relevant content regions in uploaded medical images.

peptides_taxonomyRetrieves and organizes peptide taxonomy classification data.

12. Roadmap & Future Enhancements

Current Considerations

Blood test PDF parsing accuracy is dependent on PDF quality — some lab-specific formats may benefit from manual review
AI-generated reference ranges are clearly flagged and should be audited by a clinical professional before use
The unit conversion engine covers all common clinical units; rare or non-standard formats may require manual entry
Wearable integrations require one-time OAuth setup per device provider
PDF reports are generated in the browser; very large reports may take a few extra seconds

Planned Enhancements

Computer vision-based blood test extraction for scanned and handwritten lab reports
Server-side PDF generation for improved speed and consistency on large reports
Advanced cohort analytics with predictive trend modeling
HL7 FHIR integration for interoperability with external electronic health record systems
Expanded wearable device support — Oura Ring, Whoop, continuous glucose monitors (CGMs)
Native mobile application with push notification support for medication reminders
Integrated telehealth video consultation capabilities
Enhanced AI clinical decision support with automatic evidence-based citation linking

13. SuperAdmin — Data Export

This section is restricted to SuperAdmin users only. Contact your system administrator if you need data export access.

OMICS Precision Health — System Documentation v3.0

Developed by RobLabs U — Estonia — 2026