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:
cproudlock
2025-12-11 07:42:52 -05:00
parent 9fc3420716
commit e598f72616
42 changed files with 1105 additions and 937 deletions

View File

@@ -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

View File

@@ -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)

View File

@@ -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:

View File

@@ -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

View File

@@ -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

View File

@@ -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! **

View File

@@ -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