ProductionCycleCheck/INSTALL.md

# Installation Guide - BLDI Pressure Gauge Classification Tool

## Quick Installation (5 Steps)

### Step 1: Prepare Excel File
1. Create a new Excel workbook or open existing one
2. Save as **Excel Macro-Enabled Workbook (.xlsm)**
   - File → Save As
   - Select "Excel Macro-Enabled Workbook (*.xlsm)"

### Step 2: Open VBA Editor
- Press `Alt + F11` (or Developer → Visual Basic)

### Step 3: Import GaugeClassifier Class
1. In VBA Editor: **File → Import File...**
2. Navigate to: `VBA/ClassModules/GaugeClassifier.cls`
3. Click **Open**
4. Verify in Project Explorer (Ctrl+R) under "Class Modules"

### Step 4: Import MainModule
1. **File → Import File...**
2. Navigate to: `VBA/Modules/MainModule.bas`
3. Click **Open**
4. Verify under "Modules"

### Step 5: Import TestModule
1. **File → Import File...**
2. Navigate to: `VBA/Modules/TestModule.bas`
3. Click **Open**
4. Verify under "Modules"

### Step 6: Verify Installation
1. Press `Alt + F8` to open Macro dialog
2. You should see:
   - `RunClassification`
   - `RunClassificationOnSelection`
   - `ClearClassifications`
   - `TestClassifierLogic`
   - `TestParsingMethods`
   - `TestPerformance`
   - `TestSingleInput`

## Project Structure After Import

```
VBAProject (YourWorkbookName)
├── Class Objects
│   └── GaugeClassifier
├── Modules
│   ├── MainModule
│   └── TestModule
└── Sheets (your worksheets)
```

## Running Tests

### 1. Basic Classification Test
1. Open Immediate Window: `Ctrl + G`
2. Run: Press `F5` in TestModule or use `Alt + F8` → `TestClassifierLogic`
3. Check Immediate Window for results

Expected output:
```
========================================
GaugeClassifier Test Results
========================================

[✓ PASS] Test 1: 喷涂产品
[✓ PASS] Test 2: 卫生型隔膜表
[✓ PASS] Test 3: 喷涂产品
...
========================================
Summary:
  Total:   12
  Passed:  12
  Failed:  0
========================================
```

### 2. Performance Test
1. Run `TestPerformance` from Macro dialog
2. Should process 1000 records in < 1 second

## First Use

### 1. Prepare Data
In your worksheet:
- **Column A**: Model codes (from A2 downward)
- **Column B**: Will contain classifications (auto-generated)

Example:
```
     A                                       B
┌────────────────────────────────────────────────────┐
1 │ 型号代码                      │ 产品分类          │
├────────────────────────────────────────────────────┤
2 │ PYTH-100.A0.531.M201.M02|BP-088.2312...|FBP-...│
3 │ Y-040.Z0.200.M104.M07|BP-037.1007.M07.0A2        │
4 │ YX-100.A0.200.M204.M16.H4|BP-098.0088...         │
└────────────────────────────────────────────────────┘
```

### 2. Run Classification
1. Click anywhere in your data sheet
2. Press `Alt + F8`
3. Select `RunClassification`
4. Click **Run**

### 3. View Results
Classifications appear in column B automatically.

## Alternative Installation: Manual Copy

If import doesn't work, create modules manually:

### Create GaugeClassifier.cls
1. In VBA Editor: **Insert → Class Module**
2. Name it: `GaugeClassifier` (in Properties window, F4)
3. Paste contents from `VBA/ClassModules/GaugeClassifier.cls`

### Create MainModule.bas
1. **Insert → Module**
2. Name it: `MainModule`
3. Paste contents from `VBA/Modules/MainModule.bas`

### Create TestModule.bas
1. **Insert → Module**
2. Name it: `TestModule`
3. Paste contents from `VBA/Modules/TestModule.bas`

## Troubleshooting

### Import Errors

**Error: "File not found"**
- Verify file paths are correct
- Use full path if needed: `C:\Users\Administrator\Desktop\生产周期核对\VBA\...`

**Error: "Invalid file format"**
- Ensure you're importing `.cls` and `.bas` files, not source code files
- Check files aren't open in another program

### Runtime Errors

**Error: "Compile error: User-defined type not defined"**
- Make sure `GaugeClassifier` is imported as a **Class Module**, not standard module
- Delete and re-import as Class Module

**Error: "Runtime error 1004"**
- Check macro security settings:
  - File → Options → Trust Center → Trust Center Settings
  - Macro Settings → Enable all macros (or add to Trusted Locations)

**Error: "Object variable not set"**
- Ensure you're running from a worksheet, not VBA Editor
- Check that `GaugeClassifier` class module exists

### Missing Macros in Dialog

If macros don't appear in `Alt + F8`:
1. Check they're in standard modules (not class modules)
2. Ensure module names are correct: `MainModule`, `TestModule`
3. Try closing and reopening workbook
4. Check Excel Trust Center settings

## Security Settings

### Enable Macros (One-time)
1. **File → Options → Trust Center → Trust Center Settings**
2. **Macro Settings**
3. Select: **Enable all macros** (use with caution)
   OR **Disable all macros with notification** (recommended)
4. If using notification: Click "Enable Content" when opening workbook

### Add to Trusted Location (Recommended)
1. **File → Options → Trust Center → Trust Center Settings**
2. **Trusted Locations**
3. Click "Add new location"
4. Browse to: `C:\Users\Administrator\Desktop\生产周期核对\`
5. Check "Subfolders of this location are also trusted"
6. Click **OK**

## Configuration

### Change Input/Output Columns

Edit `MainModule.bas`:

```vba
' Current: Read from A, write to B
Set dataRange = ws.Range("A2:A" & lastRow)  ' Change input column
ws.Range("B2:B" & (lastRow)).Value = outputData  ' Change output column
```

### Add Custom Categories

Edit `GaugeClassifier.cls` in the `Classify` function.

## Uninstallation

1. Open VBA Editor (`Alt + F11`)
2. In Project Explorer:
   - Right-click `GaugeClassifier` → Remove File
   - Right-click `MainModule` → Remove File
   - Right-click `TestModule` → Remove File
3. Save workbook

## Verification Checklist

- [ ] Workbook saved as `.xlsm`
- [ ] All three modules imported successfully
- [ ] `GaugeClassifier` is a Class Module
- [ ] `MainModule` and `TestModule` are standard Modules
- [ ] Macros visible in `Alt + F8` dialog
- [ ] `TestClassifierLogic` runs successfully with all tests passing
- [ ] Can classify sample data in worksheet

## Support

If issues persist:
1. Check Excel version (requires Excel 2007 or later)
2. Verify Windows security permissions
3. Try on a new blank workbook
4. Consult README.md for additional documentation