Remove emojis from all markdown docs, add consolidation plan
- Strip emojis from 47 markdown files across docs/, sql/, and root - Add docs/DOCS_CONSOLIDATION_PLAN.md with plan to reduce 45 docs to 8 - Establish no-emoji rule for documentation going forward 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -94,9 +94,9 @@ ALTER TABLE machines
|
||||
- Removes IP columns because they'll go in communications table
|
||||
|
||||
**Impact on Existing Data:**
|
||||
- ✅ All 275 existing machines preserved (no data loss)
|
||||
- ✅ New columns added with NULL defaults (safe)
|
||||
- ✅ ipaddress1/ipaddress2 dropped (but backed up in Script 1)
|
||||
- All 275 existing machines preserved (no data loss)
|
||||
- New columns added with NULL defaults (safe)
|
||||
- ipaddress1/ipaddress2 dropped (but backed up in Script 1)
|
||||
|
||||
**After This Script:**
|
||||
```
|
||||
@@ -506,9 +506,9 @@ machine_pc_relationships: ~100 records (unchanged)
|
||||
## Critical Safety Features
|
||||
|
||||
### 1. No Data Loss
|
||||
- ✅ Old tables are NOT dropped (kept for 30 days)
|
||||
- ✅ Can roll back if issues found
|
||||
- ✅ Data copied, not moved
|
||||
- Old tables are NOT dropped (kept for 30 days)
|
||||
- Can roll back if issues found
|
||||
- Data copied, not moved
|
||||
|
||||
### 2. Duplicate Prevention
|
||||
```sql
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ CRITICAL DATA PRESERVATION
|
||||
## CRITICAL DATA PRESERVATION
|
||||
|
||||
**Production has MORE data than dev:**
|
||||
- Production PCs: **286** (in `pc` table)
|
||||
@@ -91,9 +91,9 @@ ALTER TABLE machines
|
||||
```
|
||||
|
||||
**Impact:**
|
||||
- ✅ Preserves all 275 production machines
|
||||
- ⚠️ Removes ipaddress1/ipaddress2 (will be migrated to communications)
|
||||
- ✅ Makes room for 286 PCs to be added
|
||||
- Preserves all 275 production machines
|
||||
- Removes ipaddress1/ipaddress2 (will be migrated to communications)
|
||||
- Makes room for 286 PCs to be added
|
||||
|
||||
#### `businessunits` - Add 5 columns
|
||||
```sql
|
||||
@@ -105,7 +105,7 @@ ALTER TABLE businessunits
|
||||
ADD COLUMN dt_lead_sso varchar(50) DEFAULT NULL COMMENT 'DT Lead SSO';
|
||||
```
|
||||
|
||||
**Impact:** ✅ No data loss, adds metadata fields
|
||||
**Impact:** No data loss, adds metadata fields
|
||||
|
||||
#### `controllertypes` - Add 4 columns
|
||||
```sql
|
||||
@@ -116,7 +116,7 @@ ALTER TABLE controllertypes
|
||||
ADD COLUMN controllernotes text;
|
||||
```
|
||||
|
||||
**Impact:** ✅ No data loss, adds metadata fields
|
||||
**Impact:** No data loss, adds metadata fields
|
||||
|
||||
#### `machine_overrides` - Definition changes
|
||||
**Action:** Need to investigate exact differences
|
||||
@@ -372,10 +372,10 @@ FROM machine_pc_relationships mpc;
|
||||
## Migration Execution Order
|
||||
|
||||
### PRE-MIGRATION (Do First!)
|
||||
1. ✅ **BACKUP PRODUCTION DATABASE** (already done: database-backup-11-20-25-eod-with-drop.sql)
|
||||
2. ✅ Test all scripts on dev database first
|
||||
3. ✅ Schedule maintenance window
|
||||
4. ✅ Notify users
|
||||
1. **BACKUP PRODUCTION DATABASE** (already done: database-backup-11-20-25-eod-with-drop.sql)
|
||||
2. Test all scripts on dev database first
|
||||
3. Schedule maintenance window
|
||||
4. Notify users
|
||||
|
||||
### MIGRATION EXECUTION (In Order)
|
||||
1. **Phase 1a:** Create backup tables for IPs (5 seconds)
|
||||
|
||||
@@ -10,15 +10,15 @@
|
||||
|
||||
Your production database has **27 views** that provide critical reporting and data aggregation. After analyzing these views:
|
||||
|
||||
- ⚠️ **24 views MUST be updated** - They reference deprecated tables (pc, pc_network_interfaces, etc.)
|
||||
- ✅ **3 views OK** - Already compatible with Phase 2 schema
|
||||
- 🚨 **CRITICAL:** These views must be updated BEFORE or DURING migration, or pages using them will break
|
||||
- **24 views MUST be updated** - They reference deprecated tables (pc, pc_network_interfaces, etc.)
|
||||
- **3 views OK** - Already compatible with Phase 2 schema
|
||||
- **CRITICAL:** These views must be updated BEFORE or DURING migration, or pages using them will break
|
||||
|
||||
---
|
||||
|
||||
## Views Status Breakdown
|
||||
|
||||
### ✅ Views Compatible with Phase 2 (3 views)
|
||||
### Views Compatible with Phase 2 (3 views)
|
||||
|
||||
These views don't reference deprecated tables and will continue working after migration:
|
||||
|
||||
@@ -28,7 +28,7 @@ These views don't reference deprecated tables and will continue working after mi
|
||||
|
||||
---
|
||||
|
||||
### ⚠️ Views Requiring Updates (24 views)
|
||||
### Views Requiring Updates (24 views)
|
||||
|
||||
All of these reference tables that will be deprecated after Phase 2 migration:
|
||||
|
||||
|
||||
@@ -261,4 +261,4 @@ After running scripts, verify:
|
||||
|
||||
**Created:** 2025-11-06
|
||||
**Last Updated:** 2025-11-06
|
||||
**Status:** ✅ Ready for DEV testing
|
||||
**Status:** Ready for DEV testing
|
||||
|
||||
@@ -111,7 +111,7 @@ Comprehensive verification script with 9 sections:
|
||||
8. Backup table verification
|
||||
9. Final summary and critical issues check
|
||||
|
||||
All checks should show ✓ status with 0 critical issues.
|
||||
All checks should show status with 0 critical issues.
|
||||
|
||||
## How to Run
|
||||
|
||||
@@ -274,7 +274,7 @@ mysql -u root -p shopdb < VERIFY_PHASE2_MIGRATION.sql
|
||||
```
|
||||
|
||||
Review output for:
|
||||
- All checks showing ✓ status
|
||||
- All checks showing status
|
||||
- Critical issues count = 0
|
||||
- Record counts matching expected values
|
||||
|
||||
|
||||
@@ -6,23 +6,23 @@
|
||||
|
||||
---
|
||||
|
||||
## 📋 Overview
|
||||
## Overview
|
||||
|
||||
This migration consolidates all network infrastructure devices (servers, switches, cameras, access points, IDFs) into the unified `machines` table, completing the infrastructure unification started with Phase 2.
|
||||
|
||||
### What Gets Migrated:
|
||||
- ✅ **Servers** → machines (machinetypeid 30)
|
||||
- ✅ **Switches** → machines (machinetypeid 31)
|
||||
- ✅ **Cameras** → machines (machinetypeid 32)
|
||||
- ✅ **Access Points** → machines (machinetypeid 33) *if table exists*
|
||||
- ✅ **IDFs** → machines (machinetypeid 34) *if table exists*
|
||||
- **Servers** → machines (machinetypeid 30)
|
||||
- **Switches** → machines (machinetypeid 31)
|
||||
- **Cameras** → machines (machinetypeid 32)
|
||||
- **Access Points** → machines (machinetypeid 33) *if table exists*
|
||||
- **IDFs** → machines (machinetypeid 34) *if table exists*
|
||||
|
||||
### What Stays Separate:
|
||||
- ❌ **Printers** → Remain in printers table (by design)
|
||||
- **Printers** → Remain in printers table (by design)
|
||||
|
||||
---
|
||||
|
||||
## 📁 Migration Scripts
|
||||
## Migration Scripts
|
||||
|
||||
```
|
||||
01_create_network_machinetypes.sql Creates machinetypes 30-36
|
||||
@@ -40,7 +40,7 @@ ROLLBACK_PHASE3.sql Emergency rollback
|
||||
|
||||
---
|
||||
|
||||
## ⚡ Quick Start
|
||||
## Quick Start
|
||||
|
||||
### Prerequisites:
|
||||
```bash
|
||||
@@ -75,7 +75,7 @@ mysql -u root -p shopdb < RUN_ALL_PHASE3_SCRIPTS.sql
|
||||
|
||||
---
|
||||
|
||||
## 📊 Expected Results
|
||||
## Expected Results
|
||||
|
||||
### Before Migration:
|
||||
```
|
||||
@@ -99,7 +99,7 @@ views: 3 new views created
|
||||
|
||||
---
|
||||
|
||||
## ✅ Verification Checklist
|
||||
## Verification Checklist
|
||||
|
||||
Run `VERIFY_PHASE3_MIGRATION.sql` and check for:
|
||||
|
||||
@@ -116,7 +116,7 @@ Run `VERIFY_PHASE3_MIGRATION.sql` and check for:
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Relationship Examples
|
||||
## Relationship Examples
|
||||
|
||||
### Camera → Switch → IDF
|
||||
```sql
|
||||
@@ -159,7 +159,7 @@ WHERE cam.machinetypeid = 32;
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Useful Queries
|
||||
## Useful Queries
|
||||
|
||||
### All Network Devices
|
||||
```sql
|
||||
@@ -190,7 +190,7 @@ WHERE relationshiptype = 'Connected To';
|
||||
|
||||
---
|
||||
|
||||
## 🚨 Troubleshooting
|
||||
## Troubleshooting
|
||||
|
||||
### Migration Fails:
|
||||
1. Review error message
|
||||
@@ -219,13 +219,13 @@ mysql -u root -p shopdb < shopdb_backup_YYYYMMDD.sql
|
||||
|
||||
---
|
||||
|
||||
## 📝 Post-Migration Tasks
|
||||
## Post-Migration Tasks
|
||||
|
||||
### Immediate (After Successful Migration):
|
||||
1. ✅ Run verification script
|
||||
2. ✅ Test application pages
|
||||
3. ✅ Verify relationships display correctly
|
||||
4. ✅ Check all device types accessible
|
||||
1. Run verification script
|
||||
2. Test application pages
|
||||
3. Verify relationships display correctly
|
||||
4. Check all device types accessible
|
||||
|
||||
### Short-Term (1-7 Days):
|
||||
1. Update displaymachines.asp (add network device filters)
|
||||
@@ -242,19 +242,19 @@ mysql -u root -p shopdb < shopdb_backup_YYYYMMDD.sql
|
||||
DROP TABLE cameras;
|
||||
```
|
||||
3. Update documentation
|
||||
4. Celebrate! 🎉
|
||||
4. Celebrate!
|
||||
|
||||
---
|
||||
|
||||
## 📌 Important Notes
|
||||
## Important Notes
|
||||
|
||||
### Data Preserved:
|
||||
- ✅ All serial numbers
|
||||
- ✅ All IP addresses
|
||||
- ✅ All descriptions
|
||||
- ✅ All map coordinates
|
||||
- ✅ All models/vendors
|
||||
- ✅ All active/inactive states
|
||||
- All serial numbers
|
||||
- All IP addresses
|
||||
- All descriptions
|
||||
- All map coordinates
|
||||
- All models/vendors
|
||||
- All active/inactive states
|
||||
|
||||
### Data Generated:
|
||||
- `machinenumber`: Generated as SVR-XXXX, SW-XXXX, CAM-XXXX
|
||||
@@ -312,4 +312,4 @@ mysql -u root -p shopdb < shopdb_backup_YYYYMMDD.sql
|
||||
mysql -u root -p shopdb_test < RUN_ALL_PHASE3_SCRIPTS.sql
|
||||
```
|
||||
|
||||
**Good luck! 🚀**
|
||||
**Good luck! **
|
||||
|
||||
@@ -91,7 +91,7 @@ mysql -u root -p shopdb < VERIFY_PHASE4_MIGRATION.sql
|
||||
mysql -u root -p shopdb < VERIFY_PHASE4_MIGRATION.sql
|
||||
```
|
||||
|
||||
All checks should show `✓ PASS`.
|
||||
All checks should show ` PASS`.
|
||||
|
||||
## Rollback Instructions
|
||||
|
||||
|
||||
Reference in New Issue
Block a user