# Vaccination Record Builder

The **Vaccination Record Builder** is your primary workspace for assembling a patient's immunization history into a professional, printable PDF document. You can type in details manually, arrange the order of the table, or even import a previously made PDF to quickly update it.

### How the Screen is Laid Out (TODO: snapshot)

The screen is organized into a **Data Entry Side** and a **Live Preview Side**:

1. **The Left Side (Data Entry Workspaces):** Contains the forms where you type in the patient's information, add separate vaccination events (rows), and write down customized clinical notes.
2. **The Right Side (Row List Preview):** Displays a running checklist of every vaccination you have added to the current record. This list shows exactly how the information will look and how it will be ordered on the final document.

```
+-------------------------------------------------------------------------+
|                           Vaccination Record                            |
+----------------------------------------+--------------------------------+
| LEFT SIDE: Data Entry & Forms          | RIGHT SIDE: Live Table Preview |
|                                        |                                |
|  [Patient Details Form]                |  This shows exactly how rows   |
|  - Name, DOB, Last Updated Date        |  will appear on the final PDF. |
|                                        |                                |
|  [Add Vaccination Form]  [Notes Form]  |   * Item 1 (Top of PDF)        |
|  - Disease, Lot, Brand   - Footnotes   |   * Item 2                     |
|                                        |                                |
|  [Import PDF]     [Export PDF]         |  Use arrows to change order!   |
+----------------------------------------+--------------------------------+

```

### Step-by-Step Instructions

#### Step 1: Fill Out the Patient's Details

At the top left of the screen, complete the core information for the patient:

- Type the **Patient Name**.
- Enter their **Date of Birth** using the date selector.
- The **Last Update** box will automatically set itself to today's date, but you can change it manually if needed.

<p class="callout info">**Note:** You must fill out all three of these boxes before the system will allow you to export the final PDF document.</p>

#### Step 2: Add Individual Vaccination Rows

To log a specific immunization event:

1. Under **Add vaccination row**, select the target **Disease** from the dropdown menu.
2. Fill in the specific details: **Date** given, the **Product brand**, the **Lot Number**, and the medical **Provider**.
3. Click the purple **Add to list** button.
4. The vaccine information will instantly clear from the form and jump over to the preview table on the right side of the screen.

<p class="callout success"> ***Tips for Row Entry:*** The "Add to list" button will remain grayed out until every single field in the row form has been filled in.  
  
There is a maximum limit of rows you can add to a single document. If you hit this cap, the system will prevent you from adding more.</p>

#### Step 3: Organize and Reorder the History Table

Take a look at the **Row List** on the right side of the screen. The final PDF will print these entries in the exact order you see them here.

- **Move Items Up or Down:** Click the **Up Arrow** or **Down Arrow** icons on any row to change its position in the list.
- **Remove an Error:** Click the red **Trash Can** icon to permanently delete a row from the list.

#### Step 4: Add Custom Footer Notes

At the bottom left, use the **Notes** box to write down any extra details you want featured at the bottom of the record (such as next-dose reminders, clinic contact details, or specific waivers).

#### Step 5: Generate and Save your PDF

When the record is completely finished:

1. Make sure the patient details are complete and at least one vaccination row is listed.
2. Click the purple **Export PDF** button at the bottom of the screen.
3. The application will fetch your clinic's official logo, compile your data, and open your computer's standard "Save As" window.
4. Choose where you want to save the document on your computer and hit save!

### Time-Saving Feature: Importing an Existing PDF

If a patient returns to your clinic for a new booster shot, you do not need to re-type their entire history from scratch!

1. Click the gray **Import PDF** button at the bottom left.
2. Select a previously generated vaccination PDF file from your computer.
3. The system will read the file and automatically fill in the patient's name, birthday, notes, and all past vaccination rows.
4. *Safety Note:* If you have already started typing fresh info into the workspace, a pop-up window will ask if you are sure you want to replace your current text with the imported file's data.