27-combi/TEST_CHECKLIST.md

# Test Checklist for DeFi Collateral Simulation

## Pre-Generation Checklist

- [x] Python script syntax verified (no compilation errors)
- [ ] xlsxwriter installed (`pip install xlsxwriter`)
- [ ] Python 3.7+ available

## Generation

Run:
```bash
python generate_defi_simulation.py
```

Expected output:
```
Generating DeFi_Collateral_Simulation.xlsx...
✅ Successfully generated DeFi_Collateral_Simulation.xlsx
   - Assets sheet: 4 assets
   - Summary sheet: Portfolio totals and HF
   - Simulation sheet: 11 rounds (0-10)
   - Redeploy sheet: Advanced asset-level redeploy
   - Help sheet: Test cases and documentation
```

## Verification Tests

### Test 1: Baseline (Round 0)
1. Open `DeFi_Collateral_Simulation.xlsx`
2. Go to **Assets** sheet
3. Verify default values:
   - ETH: 10 @ $2,000 = $20,000
   - wBTC: 1 @ $60,000 = $60,000
   - stETH: 0 @ $2,000 = $0
   - USDC: 5,000 @ $1 = $5,000
4. All assets should have ✅ in Collateral ON/OFF
5. Go to **Summary** sheet
6. Verify:
   - Total Collateral Value = $85,000
   - Total Max Borrowable = $20,000*0.80 + $60,000*0.70 + $0*0.75 + $5,000*0.90 = $16,000 + $42,000 + $0 + $4,500 = $62,500
   - Borrowed (input) = $25,000 (default)
   - Portfolio LTV = $25,000 / $85,000 = 0.2941 (29.41%)
   - Health Factor = $62,500 / $25,000 = 2.50
   - Status = ✅ Safe
7. Go to **Simulation** sheet, Round 0
8. Verify Round 0 matches Summary sheet values

### Test 2: Swap Only (Round 1)
1. In **Simulation** sheet, Round 1
2. Enter **Swap Volatile → Stable** = $4,000
3. Leave **Repay Amount** = 0
4. Verify:
   - Borrowed_1 = $25,000 (unchanged, no repay)
   - New Collateral Value_1 = $85,000 (same total, but mix changed)
   - Volatile assets (ETH, wBTC) should have reduced values pro-rata
   - USDC should have increased by $4,000
   - Max Borrow_1 should be recomputed from new asset mix
   - HF_1 should increase (more stable collateral = higher LTV = higher Max Borrow)

### Test 3: Repay Only (Round 1)
1. Reset Round 1: Set **Swap** = 0, **Repay Amount** = $3,000
2. Verify:
   - Borrowed_1 = $25,000 - $3,000 = $22,000
   - New Collateral Value_1 = $85,000 (unchanged, no swap)
   - Max Borrow_1 = $62,500 (unchanged, no swap)
   - HF_1 = $62,500 / $22,000 = 2.84 (increased from 2.50)
   - Status = ✅ Safe

### Test 4: Combined (Round 1)
1. Set **Repay Amount** = $2,000, **Swap** = $3,000
2. Verify:
   - Borrowed_1 = $25,000 - $2,000 = $23,000
   - New Collateral Value_1 = $85,000 (total unchanged, but mix changed)
   - Max Borrow_1 recomputed from new asset mix (should increase due to more stable)
   - HF_1 should be higher than Round 0
   - LTV_1 should be lower than Round 0

### Test 5: Optimizer
1. In **Simulation** sheet, set **Optimization On/Off** = ✅
2. Set **Max Repay per Round** = $3,000
3. Set **Max Swap per Round** = $4,000
4. If Round 0 HF < 2.0, check Round 1 **Suggested Repay** and **Suggested Swap**
5. Verify suggestions are within caps
6. Verify suggestions would bring HF_1 to approximately 2.0

### Test 6: Zero Borrowed
1. In **Summary** sheet, set **Borrowed (input)** = 0
2. Verify:
   - HF = 999 (large number)
   - Status = ✅ Safe
3. In **Simulation** sheet, verify Round 0 reflects this

### Test 7: Conditional Formatting
1. In **Summary** sheet, verify HF cell:
   - Green background if HF ≥ 2
   - Red background if HF < 2
2. In **Simulation** sheet, verify HF column (G):
   - Green background for all rounds with HF ≥ 2
   - Red background for rounds with HF < 2

### Test 8: Extensibility
1. Edit `generate_defi_simulation.py`
2. Add a new asset to `DEFAULT_ASSETS`:
   ```python
   {'name': 'USDT', 'amount': 1000, 'price': 1, 'ltv': 0.90, 'liq_th': 0.92, 'is_stable': True}
   ```
3. Regenerate workbook
4. Verify new asset appears in all sheets
5. Verify all formulas still work correctly

## Known Limitations

1. **Advanced Redeploy Sheet**: Currently a placeholder structure. Full integration with Simulation sheet swap logic would require additional formula work.

2. **Optimizer Heuristic**: Uses simplified calculations. For production use, consider:
   - More sophisticated optimization algorithms
   - Consideration of gas costs
   - Multi-round optimization (not just single-round)

3. **Swap Price Impact**: Currently assumes 1:1 value transfer. Real-world swaps have:
   - Price impact
   - Slippage
   - Fees

4. **Asset Amount Updates**: The swap mechanics adjust values but don't automatically update the Amount column in Assets sheet. This is by design (helper block approach), but users should be aware.

## Success Criteria

✅ All test cases pass
✅ Formulas calculate correctly
✅ Conditional formatting works
✅ Named ranges are accessible
✅ Workbook opens without errors in Excel/LibreOffice
✅ Round 0 matches Summary sheet
✅ Per-round recomputation works (Max Borrow changes after swaps)
✅ Optimizer provides reasonable suggestions