# Mobile Field Data Entry - User Guide

## Overview
This guide explains how to use the mobile app screens for field data entry and updates.
The mobile flows are module-based and optimized for fast, on-site updates.

## What's Included in This Branch
- Added a dedicated **Weld Log Entry** flow that consolidates fit-up, welding, WPS, welder, and NDT fields in one form.
- Added new module screens for **Punch**, **Repair**, **NDT Request**, **RFI Create**, **RFI Update**, **Ferrite**, **PMI**, and **Spool/NDT/Paint Release** entry/update.
- Implemented consistent **mobile list + bottom sheet edit** pattern across modules.
- Refactored photo upload using standard **InspectionDockedFab** for unified photo uploads.
- Added **bulk update** support in Weld Log Entry (multi-select joints).
- Added **filtering** (status/ISO) in list screens where applicable.
- Standardized **API endpoints** to direct table endpoints (`/api/{table}/read|update|create`).
- Added **field coverage** for NDT report/test metadata and welding report date.
- Standardized **snackbar feedback** for save results and validation errors.

## Navigation
Open the left sidebar menu or the Home grid and use the following entries:
- Weld Log Entry
- Punch Update
- Repair Status Entry
- NDT Request
- RFI Create
- RFI Update
- Ferrite Entry
- PMI Entry
- Spool/NDT/Paint Release
- Test Pack Base Status

Each screen opens a list view. Tap a record to edit it. Some screens use a bottom sheet form.

## Common Behaviors
- **List + Tap to Edit:** All modules load a list of records. Tap a row to open the form.
- **Filters:** Some screens include filters (status or ISO).
- **Bulk Update (Weld Log):** Enable bulk mode, select multiple joints, and update once.
- **Save Feedback:** Success and error feedback is shown via bottom snackbars.
- **Photo Upload:** Modules like Test Pack and Spool Release use the docked Floating Action Button (`InspectionDockedFab`) for standardized photo uploads directly to `/api/inspection-history`.
- **iOS UI:** iOS uses native Cupertino pickers and action sheets for date and dropdowns.

## 1) Weld Log Entry
Use this screen to update welding-related fields from a single form.

### Fields
Required:
- Fit-up Date (`fit_up_date`)
- Fit-up Report Number (`fit_up_report_no`)

Optional:
- Welding Date (`welding_date`)
- Welding Report Number (`welding_report_no`)
- Welding Report Date (`welding_report_date`)
- WPS No (`wps_no`)
- WPS Approval Date (`wps_approval_date`)
- Welder 1 (`welder_1`)
- Welder 2 (`welder_2`)

NDT:
- RT Result (`rt_result`)
- RT Report (`rt_report`)
- RT Test Date (`rt_test_date`)
- UT Result (`ut_result`)
- UT Report (`ut_report`)
- UT Test Date (`ut_test_date`)
- PT Result (`pt_result`)
- PT Report (`pt_report`)
- PT Test Date (`pt_test_date`)
- MT Result (`mt_result`)
- MT Report (`mt_report`)
- MT Test Date (`mt_test_date`)
- VT Result (`vt_result`)
- VT Report (`vt_report`)
- VT Test Date (`date_of_vt`)

### Validation
- Fit-up Date is required and cannot be in the future.
- Welding Date cannot be before Fit-up Date.
- WPS Approval Date cannot be before Fit-up Date or Welding Date.
- NDT test dates should be on or after welding dates.

### Save
Tap Save to update the record in `weld_logs`.

### Bulk Update
Use the bulk icon to select multiple joints, then tap **Update Selected**.

## 2) Punch Update
Use this screen to close or update punch items.

### Fields
- Status (`status`)
- Cleared By Name (`items_cleared_by_name`)
- Cleared Date (`items_cleared_by_close_date`)

### Save
Tap Save to update the record in `punch_lists`.

## 3) Repair Status Entry
Use this screen to track repair progress.

### Fields
- Repair Status (`repair_status`)
- Repair Qty (`repair_qty`)
- Repair Completed (`repair_completed`)
- Repair Remaining (`repair_remaining`)
- Repair Date (`repair_date`)

### Save
Tap Save to update the record in `repair_logs`.

## 4) NDT Request
Use this screen to update joint-based NDT results.

### Fields
- RT Result (`rt_result`)
- UT Result (`ut_result`)
- PT Result (`pt_result`)
- MT Result (`mt_result`)
- VT Result (`vt_result`)

### Save
Tap Save to update the record in `weld_logs`.

## 5) RFI Create
Use this screen to create a new RFI record.

### Fields
- Project No (`project_no`)
- Discipline (`discipline`)
- RFI No (`rfi_no`)
- Inspection Date (`inspection_date`)

### Save
Tap Create to add a record in `r_f_i_s`.

## 6) RFI Update
Use this screen to update existing RFIs.

### Fields
- Status (`status`)
- Result Date (`result_date`)

### Save
Tap Save to update the record in `r_f_i_s`.

## 7) Ferrite Entry
Use this screen for ferrite test updates.

### Fields
- Ferrite Request Date (`ferrite_request_date`)
- Tester Name (`tester_name`)
- Ferrite Result (`result_ferrite`)

### Save
Tap Save to update the record in `ferrits`.

## 8) PMI Entry
Use this screen for PMI test updates.

### Fields
- PMI Request Date (`pmi_request_date`)
- Tester Name (`tester_name`)
- PMI Result (`pmi_result`)

### Save
Tap Save to update the record in `p_m_i_tests`.

## 9) Spool/NDT/Paint Release
Use this unified screen to manage spool area, NDT, and paint releases from a single view.

### Process
- Instead of finding separate menus for each release step, select the target record.
- Tapping a record row directly edits the specific release stage data via bottom sheets.
- Manage Spool, Paint, and Area Release states respectively.

### Save
Tap Save inside the respective step's modal bottom sheet.

## Notes
- If you do not see changes, fully restart the mobile app.
- Some fields are optional and can be left empty.
- If permissions block access, contact your admin to enable the module.

## Backend Endpoints Used
- `POST /api/weld_logs/read`, `POST /api/weld_logs/update`, `POST /api/weld_logs/summary` (totalCount + SUM(nps_1) for footer)
- `POST /api/punch_lists/read` and `POST /api/punch_lists/update`
- `POST /api/repair_logs/read` and `POST /api/repair_logs/update`
- `POST /api/r_f_i_s/read`, `POST /api/r_f_i_s/create`, `POST /api/r_f_i_s/update`
- `POST /api/ferrits/read` and `POST /api/ferrits/update`
- `POST /api/p_m_i_tests/read` and `POST /api/p_m_i_tests/update`
- `POST /api/spools/read` and `POST /api/spools/update`
- `POST /api/construction_paint_logs/read` and `POST /api/construction_paint_logs/update`
- `GET /api/inspection-history/list` and `POST /api/inspection-history/upload`