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
342
docs/archive/MACHINE_RELATIONSHIPS_EXAMPLES.md
Normal file
342
docs/archive/MACHINE_RELATIONSHIPS_EXAMPLES.md
Normal file
@@ -0,0 +1,342 @@
|
||||
# Machine Relationships - Usage Examples
|
||||
|
||||
**Date:** 2025-11-06
|
||||
**Purpose:** Show real-world examples of how machine relationships work
|
||||
|
||||
---
|
||||
|
||||
## Example Scenario: Dualpath Lathes with Shared Controller
|
||||
|
||||
**Setup:**
|
||||
- Machine 2001 (CNC Lathe)
|
||||
- Machine 2002 (CNC Lathe)
|
||||
- PC 500 (Shopfloor PC, hostname: PC-CNC-01)
|
||||
|
||||
**Relationships:**
|
||||
1. 2001 and 2002 share the same controller (dualpath)
|
||||
2. Both machines communicate directly with PC 500
|
||||
|
||||
---
|
||||
|
||||
## Data Setup
|
||||
|
||||
### Step 1: Insert Relationship Types (one-time setup)
|
||||
```sql
|
||||
INSERT INTO relationshiptypes (relationshiptype, description, isbidirectional) VALUES
|
||||
('Dualpath', 'Machines share same controller', 1),
|
||||
('Controlled By', 'Machine controlled by PC/controller', 0),
|
||||
('Controls', 'PC/controller controls machine', 0);
|
||||
```
|
||||
|
||||
### Step 2: Link the dualpath machines
|
||||
```sql
|
||||
-- 2001 and 2002 are dualpath
|
||||
INSERT INTO machinerelationships (relationshiptypeid, machineid1, machineid2, notes) VALUES
|
||||
(1, 2001, 2002, 'Dualpath lathe pair - share controller');
|
||||
```
|
||||
|
||||
### Step 3: Link machines to controlling PC
|
||||
```sql
|
||||
-- 2001 is controlled by PC 500
|
||||
INSERT INTO machinerelationships (relationshiptypeid, machineid1, machineid2, notes) VALUES
|
||||
(2, 2001, 500, 'Primary CNC controller');
|
||||
|
||||
-- 2002 is controlled by PC 500
|
||||
INSERT INTO machinerelationships (relationshiptypeid, machineid1, machineid2, notes) VALUES
|
||||
(2, 2002, 500, 'Primary CNC controller');
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Queries
|
||||
|
||||
### Q1: Is machine 2001 dualpath? With what machine?
|
||||
|
||||
```sql
|
||||
SELECT
|
||||
m.machinenumber AS this_machine,
|
||||
CASE
|
||||
WHEN m2.machineid IS NOT NULL THEN 'Yes'
|
||||
ELSE 'No'
|
||||
END AS is_dualpath,
|
||||
m2.machinenumber AS dualpath_partner,
|
||||
rt.relationshiptype
|
||||
FROM machines m
|
||||
LEFT JOIN machinerelationships mr ON (
|
||||
(mr.machineid1 = m.machineid OR mr.machineid2 = m.machineid)
|
||||
AND mr.relationshiptypeid = 1
|
||||
)
|
||||
LEFT JOIN machines m2 ON (
|
||||
CASE
|
||||
WHEN mr.machineid1 = m.machineid THEN mr.machineid2
|
||||
ELSE mr.machineid1
|
||||
END = m2.machineid
|
||||
)
|
||||
LEFT JOIN relationshiptypes rt ON mr.relationshiptypeid = rt.relationshiptypeid
|
||||
WHERE m.machineid = 2001;
|
||||
```
|
||||
|
||||
**Result:**
|
||||
```
|
||||
this_machine | is_dualpath | dualpath_partner | relationshiptype
|
||||
2001 | Yes | 2002 | Dualpath
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Q2: Which PC controls machine 2001?
|
||||
|
||||
```sql
|
||||
SELECT
|
||||
m.machinenumber AS cnc_machine,
|
||||
pc.machineid AS controller_id,
|
||||
pc.machinenumber AS controller_location,
|
||||
pc.hostname AS controller_hostname,
|
||||
rt.relationshiptype
|
||||
FROM machines m
|
||||
JOIN machinerelationships mr ON mr.machineid1 = m.machineid
|
||||
JOIN machines pc ON mr.machineid2 = pc.machineid
|
||||
JOIN relationshiptypes rt ON mr.relationshiptypeid = rt.relationshiptypeid
|
||||
WHERE m.machineid = 2001
|
||||
AND mr.relationshiptypeid = 2;
|
||||
```
|
||||
|
||||
**Result:**
|
||||
```
|
||||
cnc_machine | controller_id | controller_location | controller_hostname | relationshiptype
|
||||
2001 | 500 | IT-LAB-01 | PC-CNC-01 | Controlled By
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Q3: What machines does PC 500 control?
|
||||
|
||||
```sql
|
||||
SELECT
|
||||
pc.hostname AS controller,
|
||||
m.machinenumber AS controlled_machine,
|
||||
mt.machinetype,
|
||||
mr.notes
|
||||
FROM machines pc
|
||||
JOIN machinerelationships mr ON mr.machineid2 = pc.machineid
|
||||
JOIN machines m ON mr.machineid1 = m.machineid
|
||||
JOIN machinetypes mt ON m.machinetypeid = mt.machinetypeid
|
||||
WHERE pc.machineid = 500
|
||||
AND mr.relationshiptypeid = 2
|
||||
ORDER BY m.machinenumber;
|
||||
```
|
||||
|
||||
**Result:**
|
||||
```
|
||||
controller | controlled_machine | machinetype | notes
|
||||
PC-CNC-01 | 2001 | CNC - Lathe | Primary CNC controller
|
||||
PC-CNC-01 | 2002 | CNC - Lathe | Primary CNC controller
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Q4: Complete picture - Machine + Dualpath + Controller + IP
|
||||
|
||||
```sql
|
||||
SELECT
|
||||
m.machinenumber AS machine,
|
||||
mt.machinetype,
|
||||
|
||||
-- Dualpath info
|
||||
m_dual.machinenumber AS dualpath_partner,
|
||||
|
||||
-- Controller info
|
||||
pc.hostname AS controller,
|
||||
pc.machinenumber AS controller_location,
|
||||
|
||||
-- Controller's IP
|
||||
c.address AS controller_ip
|
||||
|
||||
FROM machines m
|
||||
JOIN machinetypes mt ON m.machinetypeid = mt.machinetypeid
|
||||
|
||||
-- Find dualpath partner
|
||||
LEFT JOIN machinerelationships mr_dual ON (
|
||||
(mr_dual.machineid1 = m.machineid OR mr_dual.machineid2 = m.machineid)
|
||||
AND mr_dual.relationshiptypeid = 1
|
||||
)
|
||||
LEFT JOIN machines m_dual ON (
|
||||
CASE
|
||||
WHEN mr_dual.machineid1 = m.machineid THEN mr_dual.machineid2
|
||||
ELSE mr_dual.machineid1
|
||||
END = m_dual.machineid
|
||||
)
|
||||
|
||||
-- Find controller
|
||||
LEFT JOIN machinerelationships mr_ctrl ON (
|
||||
mr_ctrl.machineid1 = m.machineid
|
||||
AND mr_ctrl.relationshiptypeid = 2
|
||||
)
|
||||
LEFT JOIN machines pc ON mr_ctrl.machineid2 = pc.machineid
|
||||
|
||||
-- Get controller's IP address
|
||||
LEFT JOIN communications c ON (
|
||||
pc.machineid = c.machineid
|
||||
AND c.comstypeid = 1 -- IP type
|
||||
)
|
||||
|
||||
WHERE m.machineid IN (2001, 2002);
|
||||
```
|
||||
|
||||
**Result:**
|
||||
```
|
||||
machine | machinetype | dualpath_partner | controller | controller_location | controller_ip
|
||||
2001 | CNC - Lathe | 2002 | PC-CNC-01 | IT-LAB-01 | 192.168.1.50
|
||||
2002 | CNC - Lathe | 2001 | PC-CNC-01 | IT-LAB-01 | 192.168.1.50
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Recommended View: vw_machine_relationships
|
||||
|
||||
Create a view for easy access:
|
||||
|
||||
```sql
|
||||
CREATE VIEW vw_machine_relationships AS
|
||||
SELECT
|
||||
m.machineid,
|
||||
m.machinenumber,
|
||||
m.alias,
|
||||
mt.machinetype,
|
||||
|
||||
-- Dualpath info
|
||||
CASE WHEN m_dual.machineid IS NOT NULL THEN 1 ELSE 0 END AS is_dualpath,
|
||||
m_dual.machineid AS dualpath_partner_id,
|
||||
m_dual.machinenumber AS dualpath_partner,
|
||||
|
||||
-- Controller info
|
||||
pc.machineid AS controller_id,
|
||||
pc.hostname AS controller_hostname,
|
||||
pc.machinenumber AS controller_location,
|
||||
|
||||
-- Controller IP
|
||||
c.address AS controller_ip,
|
||||
|
||||
-- Relationship counts
|
||||
(SELECT COUNT(*)
|
||||
FROM machinerelationships mr
|
||||
WHERE mr.machineid1 = m.machineid OR mr.machineid2 = m.machineid
|
||||
) AS total_relationships
|
||||
|
||||
FROM machines m
|
||||
JOIN machinetypes mt ON m.machinetypeid = mt.machinetypeid
|
||||
|
||||
-- Dualpath partner
|
||||
LEFT JOIN machinerelationships mr_dual ON (
|
||||
(mr_dual.machineid1 = m.machineid OR mr_dual.machineid2 = m.machineid)
|
||||
AND mr_dual.relationshiptypeid = 1
|
||||
AND mr_dual.isactive = 1
|
||||
)
|
||||
LEFT JOIN machines m_dual ON (
|
||||
CASE
|
||||
WHEN mr_dual.machineid1 = m.machineid THEN mr_dual.machineid2
|
||||
ELSE mr_dual.machineid1
|
||||
END = m_dual.machineid
|
||||
)
|
||||
|
||||
-- Controller PC
|
||||
LEFT JOIN machinerelationships mr_ctrl ON (
|
||||
mr_ctrl.machineid1 = m.machineid
|
||||
AND mr_ctrl.relationshiptypeid = 2
|
||||
AND mr_ctrl.isactive = 1
|
||||
)
|
||||
LEFT JOIN machines pc ON mr_ctrl.machineid2 = pc.machineid
|
||||
|
||||
-- Controller IP
|
||||
LEFT JOIN communications c ON (
|
||||
pc.machineid = c.machineid
|
||||
AND c.comstypeid = 1
|
||||
)
|
||||
|
||||
WHERE m.isactive = 1;
|
||||
```
|
||||
|
||||
### Using the View:
|
||||
|
||||
```sql
|
||||
-- Simple query for machine 2001
|
||||
SELECT * FROM vw_machine_relationships WHERE machineid = 2001;
|
||||
|
||||
-- Show all dualpath machines
|
||||
SELECT * FROM vw_machine_relationships WHERE is_dualpath = 1;
|
||||
|
||||
-- Show all machines controlled by PC 500
|
||||
SELECT * FROM vw_machine_relationships WHERE controller_id = 500;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ASP Code Examples
|
||||
|
||||
### Check if machine is dualpath:
|
||||
```vbscript
|
||||
strSQL = "SELECT * FROM vw_machine_relationships WHERE machineid = ?"
|
||||
Set rs = ExecuteParameterizedQuery(objConn, strSQL, Array(CLng(machineId)))
|
||||
|
||||
If Not rs.EOF Then
|
||||
isDualpath = rs("is_dualpath")
|
||||
|
||||
If isDualpath = 1 Then
|
||||
Response.Write("Dualpath with: " & rs("dualpath_partner"))
|
||||
End If
|
||||
|
||||
If Not IsNull(rs("controller_hostname")) Then
|
||||
Response.Write("Controller: " & rs("controller_hostname"))
|
||||
Response.Write(" (IP: " & rs("controller_ip") & ")")
|
||||
End If
|
||||
End If
|
||||
```
|
||||
|
||||
### Display machine card with relationships:
|
||||
```vbscript
|
||||
<div class="machine-card">
|
||||
<h3>Machine <%= rs("machinenumber") %></h3>
|
||||
<p>Type: <%= rs("machinetype") %></p>
|
||||
|
||||
<% If rs("is_dualpath") = 1 Then %>
|
||||
<div class="dualpath-badge">
|
||||
<strong>Dualpath:</strong> Linked with <%= rs("dualpath_partner") %>
|
||||
</div>
|
||||
<% End If %>
|
||||
|
||||
<% If Not IsNull(rs("controller_hostname")) Then %>
|
||||
<div class="controller-info">
|
||||
<strong>Controller:</strong> <%= rs("controller_hostname") %><br>
|
||||
<strong>Location:</strong> <%= rs("controller_location") %><br>
|
||||
<strong>IP:</strong> <%= rs("controller_ip") %>
|
||||
</div>
|
||||
<% End If %>
|
||||
</div>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Benefits of This Design
|
||||
|
||||
**Flexible** - Any machine can relate to any other machine
|
||||
**Bidirectional** - Dualpath works both ways automatically
|
||||
**Directional** - "Controlled By" has clear direction
|
||||
**Extensible** - Easy to add new relationship types
|
||||
**Query-friendly** - Simple JOINs to get related machines
|
||||
**Unified** - PCs are machines too, so PC-to-machine relationships use same table
|
||||
**Future-proof** - Supports clusters, backups, master-slave, etc.
|
||||
|
||||
---
|
||||
|
||||
## Future Relationship Types (Examples)
|
||||
|
||||
```sql
|
||||
INSERT INTO relationshiptypes (relationshiptype, description, isbidirectional) VALUES
|
||||
('Backup', 'Backup/redundant machine', 1),
|
||||
('Cluster Member', 'Member of machine cluster', 1),
|
||||
('Feeds Into', 'Output feeds into next machine', 0),
|
||||
('Mirror', 'Mirrored configuration', 1),
|
||||
('Hot Standby', 'Hot standby/failover machine', 0);
|
||||
```
|
||||
|
||||
These would all work with the same `machinerelationships` table!
|
||||
Reference in New Issue
Block a user