Consolidate documentation: archive 45+ historical docs
- Move completed migration docs to docs/archive/ - Move session summaries to docs/archive/sessions/ - Rename API_ASP_DOCUMENTATION.md to docs/API.md - Archive redundant Claude reference files - Update docs/README.md as simplified index - Reduce active docs from 45+ files to 8 essential files Remaining docs: - CLAUDE.md (AI context) - TODO.md (task tracking) - docs/README.md, API.md, QUICK_REFERENCE.md - docs/ASP_DEVELOPMENT_GUIDE.md, STANDARDS.md 🤖 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
398
docs/archive/INFRASTRUCTURE_FINAL_ARCHITECTURE.md
Normal file
398
docs/archive/INFRASTRUCTURE_FINAL_ARCHITECTURE.md
Normal file
@@ -0,0 +1,398 @@
|
||||
# Infrastructure Architecture - Final Design
|
||||
|
||||
**Date:** 2025-10-23
|
||||
**Decision:** Use dedicated infrastructure tables with hierarchical relationships
|
||||
|
||||
---
|
||||
|
||||
## Existing Schema (Already in Database!)
|
||||
|
||||
### IDFs (Intermediate Distribution Frames)
|
||||
```sql
|
||||
idfs:
|
||||
- idfid INT(11) PK
|
||||
- idfname VARCHAR(100)
|
||||
- description VARCHAR(255)
|
||||
- maptop, mapleft INT(11) -- map coordinates
|
||||
- isactive BIT(1)
|
||||
```
|
||||
**No parent** - IDFs are top-level containers
|
||||
|
||||
### Cameras
|
||||
```sql
|
||||
cameras:
|
||||
- cameraid INT(11) PK
|
||||
- modelid INT(11) → models.modelnumberid → vendors
|
||||
- idfid INT(11) → idfs.idfid Already has parent!
|
||||
- serialnumber VARCHAR(100)
|
||||
- macaddress VARCHAR(17) Camera-specific
|
||||
- ipaddress VARCHAR(45)
|
||||
- description VARCHAR(255)
|
||||
- maptop, mapleft INT(11)
|
||||
- isactive BIT(1)
|
||||
```
|
||||
|
||||
### Switches
|
||||
```sql
|
||||
switches:
|
||||
- switchid INT(11) PK
|
||||
- modelid INT(11) → models.modelnumberid → vendors
|
||||
- serialnumber VARCHAR(100)
|
||||
- ipaddress VARCHAR(45)
|
||||
- description VARCHAR(255)
|
||||
- maptop, mapleft INT(11)
|
||||
- isactive BIT(1)
|
||||
```
|
||||
**Missing:** `idfid` (switches should belong to IDFs)
|
||||
|
||||
### Servers
|
||||
```sql
|
||||
servers:
|
||||
- serverid INT(11) PK
|
||||
- modelid INT(11) → models.modelnumberid → vendors
|
||||
- serialnumber VARCHAR(100)
|
||||
- ipaddress VARCHAR(45)
|
||||
- description VARCHAR(255)
|
||||
- maptop, mapleft INT(11)
|
||||
- isactive BIT(1)
|
||||
```
|
||||
**Optional:** `idfid` (servers might be in IDFs)
|
||||
|
||||
---
|
||||
|
||||
## Hierarchical Relationships
|
||||
|
||||
```
|
||||
IDFs (top level)
|
||||
├─ Switches (belong to IDF)
|
||||
│ └─ Cameras (might connect to switch)
|
||||
└─ Cameras (belong to IDF)
|
||||
└─ Servers (might be in IDF)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Migration Needed
|
||||
|
||||
### Step 1: Add idfid to switches (Required)
|
||||
```sql
|
||||
ALTER TABLE switches
|
||||
ADD COLUMN idfid INT(11) AFTER modelid,
|
||||
ADD INDEX idx_switches_idfid (idfid),
|
||||
ADD CONSTRAINT fk_switches_idf
|
||||
FOREIGN KEY (idfid) REFERENCES idfs(idfid) ON DELETE SET NULL;
|
||||
```
|
||||
|
||||
### Step 2: Add idfid to servers (Optional)
|
||||
```sql
|
||||
ALTER TABLE servers
|
||||
ADD COLUMN idfid INT(11) AFTER modelid,
|
||||
ADD INDEX idx_servers_idfid (idfid),
|
||||
ADD CONSTRAINT fk_servers_idf
|
||||
FOREIGN KEY (idfid) REFERENCES idfs(idfid) ON DELETE SET NULL;
|
||||
```
|
||||
|
||||
### Step 3: Ensure modelid exists (migration script handles this)
|
||||
Run `add_infrastructure_vendor_model_support.sql`
|
||||
|
||||
---
|
||||
|
||||
## Page Architecture
|
||||
|
||||
### Unified List Page + Type-Specific Detail Pages
|
||||
|
||||
**Why:** Different device types have different fields, so unified edit forms would be messy.
|
||||
|
||||
### Files (7 total):
|
||||
|
||||
```
|
||||
network_devices.asp → Unified list with tabs/filter
|
||||
network_device_detail_idf.asp?id=5 → IDF detail/edit
|
||||
network_device_detail_server.asp?id=3 → Server detail/edit
|
||||
network_device_detail_switch.asp?id=2 → Switch detail/edit
|
||||
network_device_detail_camera.asp?id=1 → Camera detail/edit
|
||||
add_network_device.asp?type=idf → Add form (type selector)
|
||||
save_network_device.asp → Universal save (routes by type)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Page 1: network_devices.asp (Unified List)
|
||||
|
||||
### Features
|
||||
- **Tabs:** All | IDFs | Servers | Switches | Cameras
|
||||
- **Single table** showing all infrastructure
|
||||
- **Click device** → routes to appropriate detail page based on type
|
||||
|
||||
### Routing Logic
|
||||
```vbscript
|
||||
Select Case rs("device_type")
|
||||
Case "IDF"
|
||||
detailUrl = "network_device_detail_idf.asp?id=" & rs("device_id")
|
||||
Case "Server"
|
||||
detailUrl = "network_device_detail_server.asp?id=" & rs("device_id")
|
||||
Case "Switch"
|
||||
detailUrl = "network_device_detail_switch.asp?id=" & rs("device_id")
|
||||
Case "Camera"
|
||||
detailUrl = "network_device_detail_camera.asp?id=" & rs("device_id")
|
||||
End Select
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Page 2: network_device_detail_idf.asp
|
||||
|
||||
### Unique Fields
|
||||
- **idfname** (no model/vendor - IDFs are just locations)
|
||||
- **description**
|
||||
- **Map coordinates**
|
||||
|
||||
### Form Fields
|
||||
```html
|
||||
<input type="text" name="idfname" required>
|
||||
<textarea name="description"></textarea>
|
||||
<input type="number" name="maptop" placeholder="Y coordinate">
|
||||
<input type="number" name="mapleft" placeholder="X coordinate">
|
||||
```
|
||||
|
||||
### No Parent Selection
|
||||
IDFs are top-level, no parent dropdown needed.
|
||||
|
||||
---
|
||||
|
||||
## Page 3: network_device_detail_server.asp
|
||||
|
||||
### Fields
|
||||
- **Model/Vendor dropdown** (modelid)
|
||||
- **Serial number**
|
||||
- **IP address**
|
||||
- **Description**
|
||||
- **IDF dropdown** (optional - which IDF is this server in?)
|
||||
- **Map coordinates**
|
||||
|
||||
### IDF Dropdown
|
||||
```vbscript
|
||||
<div class="form-group">
|
||||
<label>IDF Location (Optional)</label>
|
||||
<select name="idfid" class="form-control">
|
||||
<option value="">-- Not in an IDF --</option>
|
||||
<%
|
||||
strSQL = "SELECT idfid, idfname FROM idfs WHERE isactive = 1 ORDER BY idfname"
|
||||
Set rsIDFs = objConn.Execute(strSQL)
|
||||
Do While Not rsIDFs.EOF
|
||||
%>
|
||||
<option value="<%=rsIDFs("idfid")%>"
|
||||
<%If Not IsNull(rs("idfid")) And rs("idfid") = rsIDFs("idfid") Then Response.Write("selected")%>>
|
||||
<%=Server.HTMLEncode(rsIDFs("idfname"))%>
|
||||
</option>
|
||||
<%
|
||||
rsIDFs.MoveNext
|
||||
Loop
|
||||
%>
|
||||
</select>
|
||||
</div>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Page 4: network_device_detail_switch.asp
|
||||
|
||||
### Fields
|
||||
- **Model/Vendor dropdown** (modelid)
|
||||
- **Serial number**
|
||||
- **IP address**
|
||||
- **Description**
|
||||
- **IDF dropdown** (required - which IDF is this switch in?)
|
||||
- **Port count** (optional - could add this field)
|
||||
- **Map coordinates**
|
||||
|
||||
### IDF Dropdown (Required for switches)
|
||||
```vbscript
|
||||
<div class="form-group">
|
||||
<label>IDF Location <span class="text-danger">*</span></label>
|
||||
<select name="idfid" required class="form-control">
|
||||
<option value="">-- Select IDF --</option>
|
||||
<!-- IDF options... -->
|
||||
</select>
|
||||
<small class="form-text text-muted">
|
||||
Switches must be assigned to an IDF
|
||||
</small>
|
||||
</div>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Page 5: network_device_detail_camera.asp
|
||||
|
||||
### Fields
|
||||
- **Model/Vendor dropdown** (modelid)
|
||||
- **Serial number**
|
||||
- **MAC address** (cameras have this!)
|
||||
- **IP address**
|
||||
- **Description**
|
||||
- **IDF dropdown** (required - which IDF does this camera connect to?)
|
||||
- **Switch dropdown** (optional - which switch port?)
|
||||
- **Map coordinates**
|
||||
|
||||
### IDF Dropdown (Required)
|
||||
```vbscript
|
||||
<div class="form-group">
|
||||
<label>IDF Location <span class="text-danger">*</span></label>
|
||||
<select name="idfid" required class="form-control">
|
||||
<option value="">-- Select IDF --</option>
|
||||
<!-- IDF options... -->
|
||||
</select>
|
||||
</div>
|
||||
```
|
||||
|
||||
### MAC Address Field (Unique to cameras)
|
||||
```vbscript
|
||||
<div class="form-group">
|
||||
<label>MAC Address</label>
|
||||
<input type="text" name="macaddress" class="form-control"
|
||||
pattern="^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$"
|
||||
placeholder="00:11:22:33:44:55">
|
||||
</div>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Page 6: add_network_device.asp
|
||||
|
||||
### Step 1: Device Type Selector
|
||||
Show cards for IDF, Server, Switch, Camera
|
||||
|
||||
### Step 2: Type-Specific Form
|
||||
Route to appropriate form based on selected type:
|
||||
- `add_network_device.asp?type=idf` → IDF form (no model)
|
||||
- `add_network_device.asp?type=server` → Server form (model + optional IDF)
|
||||
- `add_network_device.asp?type=switch` → Switch form (model + required IDF)
|
||||
- `add_network_device.asp?type=camera` → Camera form (model + required IDF + MAC)
|
||||
|
||||
---
|
||||
|
||||
## Page 7: save_network_device.asp
|
||||
|
||||
### Universal Save Endpoint
|
||||
|
||||
```vbscript
|
||||
<%
|
||||
Dim deviceType
|
||||
deviceType = Request.Form("type")
|
||||
|
||||
' Route to appropriate table
|
||||
Select Case deviceType
|
||||
Case "idf"
|
||||
tableName = "idfs"
|
||||
' Save: idfname, description, maptop, mapleft
|
||||
' No modelid
|
||||
|
||||
Case "server"
|
||||
tableName = "servers"
|
||||
' Save: modelid, idfid (optional), serialnumber, ipaddress, description, maptop, mapleft
|
||||
|
||||
Case "switch"
|
||||
tableName = "switches"
|
||||
' Save: modelid, idfid (required), serialnumber, ipaddress, description, maptop, mapleft
|
||||
|
||||
Case "camera"
|
||||
tableName = "cameras"
|
||||
' Save: modelid, idfid (required), serialnumber, macaddress, ipaddress, description, maptop, mapleft
|
||||
End Select
|
||||
%>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Navigation Menu
|
||||
|
||||
```html
|
||||
<li class="nav-header">INFRASTRUCTURE</li>
|
||||
<li>
|
||||
<a href="network_devices.asp">
|
||||
<i class="zmdi zmdi-devices"></i> Network Devices
|
||||
</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="network_map.asp">
|
||||
<i class="zmdi zmdi-map"></i> Network Map
|
||||
</a>
|
||||
</li>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## network_map.asp Integration
|
||||
|
||||
### Current State
|
||||
Currently queries `machines` table filtering for infrastructure machine types.
|
||||
|
||||
### New Approach
|
||||
Query both machines AND infrastructure tables:
|
||||
|
||||
```vbscript
|
||||
<%
|
||||
' Get infrastructure devices
|
||||
strSQL = "SELECT 'IDF' as type, idfid as id, idfname as name, NULL as model, NULL as vendor, " & _
|
||||
"maptop, mapleft, 'IDF' as device_type " & _
|
||||
"FROM idfs WHERE isactive = 1 AND maptop IS NOT NULL " & _
|
||||
"UNION ALL " & _
|
||||
"SELECT 'Server' as type, serverid as id, description as name, m.modelnumber as model, v.vendor, " & _
|
||||
"s.maptop, s.mapleft, 'Server' as device_type " & _
|
||||
"FROM servers s " & _
|
||||
"LEFT JOIN models m ON s.modelid = m.modelnumberid " & _
|
||||
"LEFT JOIN vendors v ON m.vendorid = v.vendorid " & _
|
||||
"WHERE s.isactive = 1 AND s.maptop IS NOT NULL " & _
|
||||
"UNION ALL " & _
|
||||
"SELECT 'Switch' as type, switchid as id, description as name, m.modelnumber as model, v.vendor, " & _
|
||||
"sw.maptop, sw.mapleft, 'Switch' as device_type " & _
|
||||
"FROM switches sw " & _
|
||||
"LEFT JOIN models m ON sw.modelid = m.modelnumberid " & _
|
||||
"LEFT JOIN vendors v ON m.vendorid = v.vendorid " & _
|
||||
"WHERE sw.isactive = 1 AND sw.maptop IS NOT NULL " & _
|
||||
"UNION ALL " & _
|
||||
"SELECT 'Camera' as type, cameraid as id, description as name, m.modelnumber as model, v.vendor, " & _
|
||||
"c.maptop, c.mapleft, 'Camera' as device_type " & _
|
||||
"FROM cameras c " & _
|
||||
"LEFT JOIN models m ON c.modelid = m.modelnumberid " & _
|
||||
"LEFT JOIN vendors v ON m.vendorid = v.vendorid " & _
|
||||
"WHERE c.isactive = 1 AND c.maptop IS NOT NULL"
|
||||
|
||||
Set rs = objConn.Execute(strSQL)
|
||||
|
||||
' Output JSON for map markers
|
||||
Response.Write("const devices = [")
|
||||
Do While Not rs.EOF
|
||||
Response.Write("{")
|
||||
Response.Write("type: '" & rs("device_type") & "', ")
|
||||
Response.Write("id: " & rs("id") & ", ")
|
||||
Response.Write("name: '" & Replace(rs("name") & "", "'", "\'") & "', ")
|
||||
Response.Write("model: '" & Replace(rs("model") & "", "'", "\'") & "', ")
|
||||
Response.Write("vendor: '" & Replace(rs("vendor") & "", "'", "\'") & "', ")
|
||||
Response.Write("x: " & rs("mapleft") & ", ")
|
||||
Response.Write("y: " & rs("maptop"))
|
||||
Response.Write("},")
|
||||
rs.MoveNext
|
||||
Loop
|
||||
Response.Write("];")
|
||||
%>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Summary: Why This Approach?
|
||||
|
||||
**Hierarchical relationships** - Cameras/switches belong to IDFs
|
||||
**Type-specific fields** - MAC address for cameras, idfname for IDFs
|
||||
**Flexible** - Can add more fields per type later
|
||||
**Clean data model** - Proper normalization
|
||||
**Unified list view** - See all infrastructure in one place
|
||||
**Type-specific edit** - Appropriate fields per device type
|
||||
**Map integration** - All devices can be mapped
|
||||
|
||||
**Total Files:** 7 ASP files (1 list + 4 detail + 1 add + 1 save)
|
||||
|
||||
---
|
||||
|
||||
**Next Step:** Run enhanced migration script to add `idfid` to switches/servers, then create the 7 pages.
|
||||
|
||||
Reference in New Issue
Block a user