citrus-cms/resources/views/guide/weldmap.md

# Weldmap User Guide

## What is Weldmap?

Weldmap is where you track and manage all welding joint information in your project. Think of it as your digital welding logbook where you record every weld, track quality inspections, and maintain welding documentation.

## Getting Started

To access Weldmap:
1. Login to the system
2. Click on **Welding** in the main menu
3. Select **Weldmap** from the dropdown

## Creating a New Weld Record

### Step 1: Adding Basic Information
1. Click the **"Add New"** button (+ icon) in the DataGrid
2. Fill in the required fields:
   - **ISO Number**: Enter the isometric drawing number
   - **Joint Number**: Unique identifier for this weld joint
   - **Spool Number**: The spool this weld belongs to

### Step 2: Line Information
1. **Line Number**: Start typing the line number - the system will show suggestions
   - ⚡ **Auto-Fill Feature**: When you select a line number, many fields will automatically fill:
     - Design temperature and pressure
     - Service category
     - Piping class
     - NDT percentage
     - Painting information

### Step 3: Material Information
1. **Element Code 1 & 2**: Select the components being welded
2. **Material Numbers**: These often auto-fill based on element codes
3. **Steel Grades**: Choose appropriate material grades
4. **Wall Thickness**: Enter thickness measurements

### Step 4: Welding Details
1. **WPS Number**: Select the Welding Procedure Specification
2. **Welding Method**: Choose the welding process (SMAW, GTAW, etc.)
3. **Welder Information**: Select the qualified welders
4. **Welding Position**: Specify the position (1G, 2G, etc.)

### Step 5: Quality Control
1. **NDT Requirements**: The system calculates this based on line requirements
2. **Test Results**: Update as inspections are completed
3. **Inspection Reports**: Reference NDT report numbers

## Working with the DataGrid

### Viewing Records
- **Scroll**: Use mouse wheel or scroll bars to navigate
- **Sort**: Click column headers to sort data
- **Filter**: Use the filter row to search specific values
- **Page Size**: Adjust how many records you see per page

### Editing Existing Records
1. **Double-click** any cell to edit (if you have permissions)
2. Make your changes
3. **Press Enter** or click elsewhere to save
4. **Press Escape** to cancel changes

### Using Dropdowns
- Many fields have dropdown lists
- Start typing to filter options
- Use arrow keys to navigate
- Press Enter to select

## File Management

### Uploading PDF Documents

**For ISO Drawings:**
1. Click **"Upload PDF"** button
2. Select **ISO** tab in the upload window
3. Drag and drop PDF files or click to browse
4. Files are automatically organized by ISO number

**For Engineering Drawings:**
1. Use the **Engineering** tab in upload window
2. Upload related technical drawings
3. Files link automatically to your weld records

### Viewing PDFs
- Look for PDF icons (📄) in the grid
- Click the icon to open the related drawing
- Multiple PDFs may be available for each record

## Smart Features

### Auto-Complete Fields
Several fields help you by suggesting values:
- **Line Number**: Shows matching lines from your project
- **UT Type**: Lists available ultrasonic testing types
- **Contractor Information**: Filtered based on your access level

### Automatic Calculations
The system automatically:
- Calculates NDT requirements based on line specifications
- Updates related fields when you select line numbers
- Applies appropriate welding standards

### Data Validation
The system prevents errors by:
- Highlighting required fields
- Validating date formats
- Checking number ranges
- Ensuring proper selections

## Common Tasks

### Finding a Specific Weld
1. Use the **search box** above the grid
2. Or use **column filters** for specific criteria
3. **Export to Excel** for offline analysis

### Updating Test Results
1. Locate the weld record
2. Double-click the test result field
3. Select: ACCEPT, REJECT, or REPAIR
4. Add report numbers and dates

### Tracking Welding Progress
1. Use the **Status** column to see completion
2. Filter by **Date** to see recent work
3. Check **NDT Percentage** for inspection requirements

### Generating Reports
1. Select multiple records using checkboxes
2. Click **Export** button
3. Choose Excel format for analysis
4. Data includes all visible columns

## Tips for Efficient Use

### ✅ Best Practices
- **Always start with Line Number** - it auto-fills many fields
- **Keep ISO Numbers consistent** - enables PDF linking
- **Update status regularly** - helps track progress
- **Use filters** - find specific welds quickly
- **Save frequently** - changes auto-save but be careful

### ⚠️ Common Mistakes to Avoid
- Don't skip required fields (highlighted in red)
- Don't modify read-only fields (they're auto-calculated)
- Don't forget to upload related PDFs
- Don't use inconsistent naming conventions

### 🚀 Pro Tips
- Use **Ctrl+F** to search within the current page
- **Right-click** for context menus
- **Tab key** to move between fields quickly
- **Shift+Click** to select multiple rows

## Troubleshooting

### Can't Edit a Field?
- Check if it's read-only (grayed out)
- Verify you have edit permissions
- Some fields auto-populate from other sources

### Auto-Complete Not Working?
- Make sure you're typing in the correct field
- Check your internet connection
- Contact admin if master data is missing

### PDF Not Loading?
- Verify the file was uploaded correctly
- Check the ISO number matches exactly
- Ensure file isn't corrupted

### Changes Not Saving?
- Check for validation errors (red highlights)
- Ensure all required fields are filled
- Try refreshing the page and re-entering

## Getting Help

If you need assistance:
1. **Check this guide first** - most questions are answered here
2. **Ask a colleague** - they might have similar experience
3. **Contact your supervisor** - for process-related questions
4. **Submit a support ticket** - for technical issues

Remember: Weldmap is your primary tool for welding quality control. Taking time to learn it well will make your daily work much more efficient!