Skip to main content

​
Get Your First Health Check in 5 Minutes

This guide will walk you through creating an account, logging in, and completing your first comprehensive health check on MediGuide.
Before you begin, ensure the MediGuide server is running on http://localhost:3001

​
Step 1: Create Your Account

Start by registering a new account on the MediGuide platform.
1

Navigate to the signup page

Open MediGuide in your browser. You’ll see the authentication screen with two tabs: Iniciar Sesión (Login) and Registrarse (Sign Up).
2

Click the Registrarse tab

Switch to the registration form by clicking the Registrarse button.
3

Fill in your details

Complete the signup form with the following required fields:
  • Nombre de Usuario (Username) - Your unique username
  • Correo Electrónico (Email) - A valid email address
  • Contraseña (Password) - Your secure password
  • Confirmar Contraseña (Confirm Password) - Re-enter your password
Use the Mostrar (Show) buttons next to password fields to verify you’ve typed them correctly.
4

Submit the form

Click the Registrarse button to create your account. If successful, you’ll see a confirmation message and be automatically logged in.

​
Signup API Call

When you submit the form, MediGuide sends the following request: 
const response = await fetch('http://localhost:3001/api/users/signup', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    username: 'your_username',
    email: '[email protected]',
    password: 'your_password'
  })
});
Your password must match in both fields, and your email must be in a valid format (e.g., [email protected]).

​
Step 2: Log In (If Needed)

If you already have an account or were logged out, you can sign back in.
1

Click Iniciar Sesión

On the authentication screen, ensure the Iniciar Sesión tab is selected.
2

Enter your credentials

Fill in your:
  • Nombre de Usuario (Username)
  • Contraseña (Password)
3

Sign in

Click Iniciar Sesión to access your account. Your user ID and username are stored in browser localStorage for future sessions.

​
Login API Call

const response = await fetch('http://localhost:3001/api/users/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    username: 'your_username',
    password: 'your_password'
  })
});
If you forget your password, click ¿Olvidaste tu contraseña? to start the password recovery process.

​
Step 3: Enter Your Medical Data

Once logged in, you’ll see the main MediGuide dashboard with the health check form.
1

Locate the medical check form

Scroll to the CHEQUEO MEDICO section with the heading “MEDIGUIDE OFRECE GUIAS MEDICAS EN BASE A LA SALUD DE NUESTROS USUARIOS”
2

Fill in all 11 biometric parameters

Complete each field with your current health measurements:

​
Metabolic Parameters

  • Nivel de Glucosa (Glucose Level) - in mg/dL (0-999)
  • Edad (Age) - in years (0-150)
  • Altura (Height) - in meters (e.g., 1.75)
  • Peso (Weight) - in kilograms (e.g., 70.5)

​
Cardiovascular Parameters

  • Presión Arterial Sistólica (Systolic Blood Pressure) - upper number in mmHg (0-300)
  • Presión Arterial Diastólica (Diastolic Blood Pressure) - lower number in mmHg (0-200)
  • Frecuencia Cardíaca (Heart Rate) - beats per minute (0-300)
  • Oxigenación de la sangre (Blood Oxygen Saturation) - percentage (0-100)

​
Vital Signs

  • Temperatura Corporal (Body Temperature) - in Celsius (0-50)
  • Frecuencia Respiratoria (Respiratory Rate) - breaths per minute (0-150)

​
Blood Information

  • Tipo de Sangre (Blood Type) - Select from dropdown: O+, O-, A+, A-, B+, B-, AB+, AB-
3

Submit your data

Click Guardar Información (Save Information) to submit your health data. You’ll see a success message when your data is saved.

​
Medical Data Submission

The form data is sent to the API with your user ID: 
const userId = localStorage.getItem('userId');

const response = await fetch('http://localhost:3001/api/medical-info', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    glucose: 95,
    oxygenBlood: 98,
    bloodPressureSystolic: 120,
    bloodPressureDiastolic: 80,
    temperature: 36.5,
    age: 30,
    height: 1.75,
    weight: 70,
    respiratoryRate: 16,
    bloodType: 'O+',
    heartRate: 72,
    userId: userId
  })
});
All fields are required. Make sure to fill in every measurement before submitting the form.

​
Step 4: View Your Health Analysis

After submitting your medical data, MediGuide automatically analyzes your biometrics and generates personalized health insights.
1

Review your current data

Scroll to the Tus Datos Médicos Actuales section to see all your submitted measurements displayed in an organized grid.
2

Check detected findings

If any parameters fall outside normal ranges, you’ll see the Hallazgos Detectados (Detected Findings) section with:
  • Parameter name and severity level
  • Your actual value
  • Possible symptoms to watch for
  • Specific recommendations
  • Risk classification (BAJO, MEDIO, ALTO, or CRÍTICO)
Each finding card is color-coded by risk level to help you prioritize actions.
3

Access your personalized health plans

If risk factors are detected, the Planes de Salud Recomendados section will display custom health plans including:
  • Plan name and duration (weekly or monthly)
  • Specific activities and timelines
  • Dietary recommendations
  • Exercise protocols
  • Follow-up schedules
4

Review healthy parameters

If all your measurements are within normal ranges, you’ll see an ¡Excelente! section with general wellness recommendations to maintain your health.

​
Example Health Analysis Response

When you fetch your latest medical data: 
const userId = localStorage.getItem('userId');

const response = await fetch(
  `http://localhost:3001/api/medical-info/latest?userId=${userId}`
);

const data = await response.json();
// Returns your most recent medical record with all biometric values

​
Step 5: Update Your Health Data

You can submit new health checks at any time to track changes over time.
1

Navigate back to the form

Scroll to the CHEQUEO MEDICO form section on the main dashboard.
2

Enter new measurements

Fill in your updated biometric data. The form clears after each successful submission.
3

Submit and analyze

Click Guardar Información to save your new data. The health analysis section will automatically refresh with updated insights.
Each medical record is timestamped with created_at, allowing you to track your health journey over time.

​
Next Steps

Now that you’ve completed your first health check, explore more features:

Understanding Health Analysis

Learn how MediGuide analyzes your biometric data and classifies health risks

Medical Tracking Guide

Discover all 11 trackable parameters and their normal ranges

Personalized Health Plans

Explore how custom health plans are generated based on your data

Password Recovery

Learn how to reset your password if you forget it

​
Troubleshooting

Ensure the MediGuide server is running on http://localhost:3001. Check the console for error messages.
# Start the server
node server.js
You should see: Server running on port 3001
Each username and email must be unique. Try a different username or use the login form if you already have an account.
Make sure both password fields contain exactly the same value. Use the Mostrar buttons to verify your entries.
If you see “No hay datos médicos registrados”, you need to complete the medical check form first. Make sure you’re logged in and submit all 11 required fields.
After submitting medical data, the analysis should appear automatically. Try refreshing the page if the health plan section doesn’t update.

​
Database Schema Reference

Your medical data is stored securely in two main tables:

​
Users Table

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  username VARCHAR(255) UNIQUE NOT NULL,
  email VARCHAR(255) UNIQUE NOT NULL,
  password VARCHAR(255) NOT NULL,
  reset_code VARCHAR(10),
  reset_code_expiry TIMESTAMP,
  created_at TIMESTAMP DEFAULT NOW()
);

​
Medical Records Table

CREATE TABLE medical_records (
  id SERIAL PRIMARY KEY,
  user_id INTEGER REFERENCES users(id) ON DELETE CASCADE,
  glucose NUMERIC,
  oxygen_blood NUMERIC,
  blood_pressure_systolic NUMERIC,
  blood_pressure_diastolic NUMERIC,
  temperature NUMERIC,
  age INTEGER,
  height NUMERIC,
  weight NUMERIC,
  respiratory_rate NUMERIC,
  blood_type VARCHAR(2),
  heart_rate NUMERIC,
  created_at TIMESTAMP DEFAULT NOW()
);
All medical records are linked to your user account via user_id and are automatically deleted if your account is removed (CASCADE deletion).

​
Need Help?

API Reference

View complete API documentation including all endpoints, request/response formats, and error codes

Build docs developers (and LLMs) love

Get started for freeTalk to us