ikinci temizlik tamamlandı
This commit is contained in:
Ümit Tunç
@@ -0,0 +1,193 @@
|
||||
# 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`
|
||||
Reference in New Issue
Block a user