citrus-cms/resources/views/guide/line-list.md

# Line List User Guide

## What is Line List?

Line List is your master database of all piping lines in the project. Every pipe, from small drain lines to major process lines, has specific requirements for materials, testing, and construction. This module stores all that critical information.

## Getting Started

To access Line List:
1. Login to the system
2. Click on **Manufacturing** in the main menu
3. Select **Line list** from the submenu

## Understanding Line Data

### What's in a Line Record?
Each line contains:
- **Line Number**: Unique identifier (like 1001-P-6"-CS-150)
- **Service**: What flows through the pipe (steam, water, oil, etc.)
- **Design Conditions**: Pressure and temperature requirements
- **Material Specification**: What the pipe is made of
- **Testing Requirements**: NDT percentages and pressure test info
- **Special Requirements**: Insulation, painting, tracing

### Line Number Format
Typical format: **XXXX-Y-Z"-MM-RRR**
- **XXXX**: Line number (1001, 2505, etc.)
- **Y**: Service code (P=Process, U=Utility, etc.)
- **Z"**: Nominal pipe size (6", 12", etc.)
- **MM**: Material code (CS=Carbon Steel, SS=Stainless, etc.)
- **RRR**: Pressure rating (150, 300, 600, etc.)

## Creating New Line Records

### Basic Line Information
1. Click **"Add New Line"**
2. Enter essential data:
   - **Line Number**: Follow project numbering system
   - **Description**: Brief service description
   - **From/To**: Start and end points
   - **Unit/Area**: Which part of the plant

### Process Information
**Service Details:**
- **Fluid Type**: Liquid, gas, steam, etc.
- **Fluid Name**: Water, crude oil, natural gas, etc.
- **Normal Flow**: Typical operating conditions
- **Maximum Flow**: Peak capacity requirements

**Operating Conditions:**
- **Operating Pressure**: Normal working pressure
- **Operating Temperature**: Normal working temperature
- **Design Pressure**: Maximum allowable pressure
- **Design Temperature**: Maximum allowable temperature

### Material Specifications

**Pipe Material:**
- **Material Grade**: A106, A53, A312, etc.
- **Schedule**: Wall thickness (40, 80, 160, etc.)
- **Corrosion Allowance**: Extra thickness for corrosion
- **Special Requirements**: NACE, low temp, etc.

**Fittings and Valves:**
- **Fitting Material**: Usually matches pipe
- **End Connections**: Welded, flanged, threaded
- **Valve Types**: Gate, globe, ball, check, etc.
- **Special Trim**: Hard facing, special seats

## Quality Requirements

### NDT (Non-Destructive Testing)
**Testing Percentages:**
- **RT (Radiographic)**: Usually 10%, 25%, or 100%
- **UT (Ultrasonic)**: For thicker walls
- **PT (Penetrant)**: Surface defect detection
- **MT (Magnetic)**: For ferromagnetic materials

**Testing Notes:**
- **Critical joints**: 100% RT required
- **Random selection**: How to choose joints
- **Repair requirements**: Re-test after repairs
- **Documentation**: Report requirements

### Pressure Testing
**Hydrostatic Test:**
- **Test Pressure**: Usually 1.5 x design pressure
- **Test Medium**: Water (usually) or other fluid
- **Test Duration**: Hold time at pressure
- **Acceptance Criteria**: No leaks, no permanent deformation

**Pneumatic Test:**
- **Test Pressure**: Lower than hydrostatic
- **Test Medium**: Air or inert gas
- **Safety Requirements**: Extra precautions needed
- **When Used**: When water testing not practical

## Special Requirements

### Insulation and Tracing
**Heat Tracing:**
- **Type**: Electric or steam tracing
- **Temperature**: Maintain temperature
- **Coverage**: Full line or partial
- **Controls**: Temperature monitoring

**Insulation:**
- **Type**: Mineral wool, foam, etc.
- **Thickness**: Based on service temperature
- **Weather Protection**: Aluminum cladding
- **Fire Rating**: Special fire protection

### Painting and Coatings
**External Coating:**
- **Primer**: Base coat specification
- **Finish Coat**: Top coat color and type
- **Special Coatings**: Chemical resistant, high temp
- **Touch-up**: Field painting requirements

**Internal Coating:**
- **When Required**: Corrosive services
- **Type**: Epoxy, phenolic, etc.
- **Application**: Before or after installation
- **Quality Control**: Holiday testing

## Using Line Data in Other Modules

### Weldmap Integration
When you select a line number in Weldmap:
- **Design conditions** auto-populate
- **Material info** fills in automatically
- **NDT requirements** are set correctly
- **Testing info** transfers over

### Test Package Planning
Line data helps determine:
- **Which lines** group together for testing
- **Test pressure** for each package
- **NDT requirements** for the package
- **Special procedures** needed

### Material Planning
Line list drives:
- **Pipe quantities** needed
- **Fitting requirements** by size and type
- **Valve specifications** and quantities
- **Special material** requirements

## Searching and Filtering

### Finding Specific Lines
**By Service:**
1. Use service filter dropdown
2. Select type (Process, Utility, etc.)
3. View all lines of that type

**By Area:**
1. Filter by unit or area
2. See all lines in specific location
3. Plan work by geographical area

**By Size:**
1. Filter by pipe diameter
2. Group similar size work
3. Plan resource requirements

### Advanced Searches
**By Material:**
- Find all stainless steel lines
- Group by material grade
- Plan special welding requirements

**By Pressure:**
- High pressure lines need special attention
- Group by pressure class
- Plan testing sequences

## Updating Line Information

### When to Update
**During Design:**
- Design conditions change
- Material specifications revised
- New safety requirements added
- Client specifications updated

**During Construction:**
- Field changes required
- Material substitutions approved
- Route modifications needed
- As-built information recorded

### Change Control
**Documentation Required:**
- **Change request**: Formal modification request
- **Engineering approval**: Technical review
- **Client approval**: If contractually required
- **Updated drawings**: Reflect changes

**Impact Assessment:**
- **Cost impact**: Additional materials/labor
- **Schedule impact**: Delays or acceleration
- **Quality impact**: Different testing requirements
- **Safety impact**: New hazard assessment

## Common Tasks

### Daily Line Review
1. **Check new lines** added to system
2. **Review updates** to existing lines
3. **Verify data** accuracy for your area
4. **Plan work** based on line priorities

### Weekly Planning
1. **Group lines** by location for efficient work
2. **Check material** availability
3. **Plan NDT** scheduling by line requirements
4. **Coordinate** with other disciplines

### Project Reporting
1. **Export line data** to Excel
2. **Generate progress** reports by area
3. **Track completion** by line
4. **Analyze** productivity by line type

## Quality Assurance

### Data Verification
**Check These Items:**
- ✅ Line numbers follow project standards
- ✅ Design conditions are realistic
- ✅ Material specs match project requirements
- ✅ NDT percentages per applicable codes
- ✅ Test pressures calculated correctly

### Consistency Checks
- **Same service** lines have similar requirements
- **Material grades** appropriate for conditions
- **NDT requirements** match criticality
- **Test pressures** follow standard calculations

## Integration Points

### With Engineering
- **P&ID updates** flow to line list
- **Specification changes** update automatically
- **Material selections** drive requirements
- **Safety studies** influence testing

### With Procurement
- **Material quantities** from line data
- **Special requirements** flagged early
- **Delivery schedules** based on construction plan
- **Quality requirements** specified clearly

### With Construction
- **Work packages** organized by lines
- **Resource planning** based on line types
- **Progress tracking** by line completion
- **Quality requirements** clearly defined

## Troubleshooting

### Common Issues

**Can't find specific line:**
- Check spelling of line number
- Try partial searches
- Verify correct project/area selected
- Use filters to narrow search

**Data seems incorrect:**
- Verify against latest P&IDs
- Check for recent engineering changes
- Compare with similar lines
- Contact engineering for clarification

**Updates not saving:**
- Check user permissions
- Verify all required fields completed
- Try refreshing page
- Contact IT support if persistent

## Best Practices

### Data Management
- ✅ Keep line data current with design
- ✅ Use consistent naming conventions
- ✅ Document all changes properly
- ✅ Verify accuracy regularly

### Cross-References
- ✅ Link to related drawings
- ✅ Reference applicable specifications
- ✅ Connect to material requisitions
- ✅ Tie to construction work packages

### Quality Control
- ✅ Review data before construction starts
- ✅ Update with as-built information
- ✅ Maintain traceability to design
- ✅ Archive completed line data

## Getting Help

**For Line Data Questions:**
- Check project specifications
- Review P&ID drawings
- Consult process engineer
- Ask piping designer

**For System Issues:**
- Try refresh/restart first
- Note specific error messages
- Contact IT with line numbers
- Provide screenshots if helpful

Remember: Line List is the foundation for all other piping activities. Accurate data here makes everything else run smoothly!