Introduction

Overview

HCG AI is a comprehensive first-trimester pregnancy tracking platform designed to provide medical-grade insights through data visualization and automated analysis. By combining clinical data—such as β-hCG levels and ultrasound measurements—with AI-powered assistance, the application helps users monitor the health and progress of a pregnancy during its most critical early stages.

The platform serves as a bridge between raw laboratory results and actionable understanding, offering risk assessments based on established medical algorithms.

---

Key Features

🩸 β-hCG Blood Test Tracking

Monitor the "pregnancy hormone" with precision. The application allows you to log serial HCG values to visualize doubling times and trends.

• Simple Logging: Record date, HCG value (mIU/mL), and units.
• Advanced Metrics: Incorporate Last Menstrual Period (LMP), cycle length, and ovulation dates to refine accuracy.
• Trend Visualization: View HCG progression through interactive charts to ensure levels are rising within expected ranges.

🖥️ Ultrasound Analysis

Track fetal development through standardized ultrasound measurements.

• Growth Metrics: Log Gestational Sac (GS) size, Yolk Sac (YS) size, and Crown-Rump Length (CRL).
• Viability Indicators: Track Fetal Heart Rate (BPM) and the number of gestational sacs.
• Z-Score Calculations: The system compares measurements against medical standards to provide context on gestational age.

⚠️ Medical Risk Assessment

The core analytical engine categorizes entries into risk levels (LOW, MEDIUM, or HIGH) based on the entered data.

• Automated Diagnosis: Receive immediate feedback on whether measurements align with the calculated gestational age.
• Recommendations: Get tailored suggestions on when to schedule follow-up tests or consult a healthcare provider.

🤖 AI Chatbot Support

An integrated AI assistant, powered by OpenAI, provides 24/7 support for pregnancy-related queries.

• Contextual Help: Ask questions about symptoms, terminology, or how to interpret specific results.
• Guided Experience: The chatbot can assist in navigating the application’s features.

---

User Workflow

HCG AI is designed with a straightforward four-step workflow:

1. Authentication: Create a secure account to keep your medical data private.
2. Data Entry: Log your latest blood work or ultrasound report in the Home or Entries tabs.
3. Analysis: Navigate to the Analysis tab to view your risk profile and data trends.
4. AI Consultation: Use the AI Chat tab to clarify any concerns regarding your logged data.

---

API for Developers

For developers looking to interact with the HCG AI backend, the application exposes a RESTful API. All data-related endpoints require session-based authentication.

HCG Management

• GET /api/hcg-entries: Retrieve all logged HCG tests for the current user.
• POST /api/hcg-entries: Log a new HCG test result.

  {
    "date": "2023-10-27",
    "hcgValue": 1500,
    "units": "mIU/mL",
    "notes": "First test"
  }
  

Ultrasound Management

• GET /api/ultrasound-entries: Retrieve all logged ultrasound scans.
• POST /api/ultrasound-entries: Log a new ultrasound scan with measurements.

AI Interaction

• POST /api/chat: Send a message to the AI assistant and receive a contextually aware response based on first-trimester medical knowledge.