Files
claudetools/api/models/network.py
Mike Swanson 390b10b32c Complete Phase 6: MSP Work Tracking with Context Recall System
Implements production-ready MSP platform with cross-machine persistent memory for Claude.

API Implementation:
- 130 REST API endpoints across 21 entities
- JWT authentication on all endpoints
- AES-256-GCM encryption for credentials
- Automatic audit logging
- Complete OpenAPI documentation

Database:
- 43 tables in MariaDB (172.16.3.20:3306)
- 42 SQLAlchemy models with modern 2.0 syntax
- Full Alembic migration system
- 99.1% CRUD test pass rate

Context Recall System (Phase 6):
- Cross-machine persistent memory via database
- Automatic context injection via Claude Code hooks
- Automatic context saving after task completion
- 90-95% token reduction with compression utilities
- Relevance scoring with time decay
- Tag-based semantic search
- One-command setup script

Security Features:
- JWT tokens with Argon2 password hashing
- AES-256-GCM encryption for all sensitive data
- Comprehensive audit trail for credentials
- HMAC tamper detection
- Secure configuration management

Test Results:
- Phase 3: 38/38 CRUD tests passing (100%)
- Phase 4: 34/35 core API tests passing (97.1%)
- Phase 5: 62/62 extended API tests passing (100%)
- Phase 6: 10/10 compression tests passing (100%)
- Overall: 144/145 tests passing (99.3%)

Documentation:
- Comprehensive architecture guides
- Setup automation scripts
- API documentation at /api/docs
- Complete test reports
- Troubleshooting guides

Project Status: 95% Complete (Production-Ready)
Phase 7 (optional work context APIs) remains for future enhancement.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-17 06:00:26 -07:00

99 lines
2.7 KiB
Python

"""
Network model for network segments and VLANs.
Networks represent network segments, VLANs, VPN networks, and other
logical or physical network divisions.
"""
from typing import Optional
from sqlalchemy import CHAR, CheckConstraint, ForeignKey, Index, Integer, String, Text
from sqlalchemy.orm import Mapped, mapped_column
from .base import Base, TimestampMixin, UUIDMixin
class Network(Base, UUIDMixin, TimestampMixin):
"""
Network model representing network segments and VLANs.
Tracks network segments including LANs, VPNs, VLANs, isolated networks,
and DMZs with CIDR notation, gateway IPs, and VLAN IDs.
Attributes:
client_id: Reference to the client
site_id: Reference to the site
network_name: Name of the network
network_type: Type of network (lan, vpn, vlan, isolated, dmz)
cidr: Network CIDR notation (e.g., "192.168.0.0/24")
gateway_ip: Gateway IP address
vlan_id: VLAN ID if applicable
notes: Additional notes
created_at: When the network was created
"""
__tablename__ = "networks"
# Foreign keys
client_id: Mapped[Optional[str]] = mapped_column(
CHAR(36),
ForeignKey("clients.id", ondelete="CASCADE"),
doc="Reference to the client"
)
site_id: Mapped[Optional[str]] = mapped_column(
CHAR(36),
ForeignKey("sites.id", ondelete="CASCADE"),
doc="Reference to the site"
)
# Network identification
network_name: Mapped[str] = mapped_column(
String(255),
nullable=False,
doc="Name of the network"
)
network_type: Mapped[Optional[str]] = mapped_column(
String(50),
doc="Type: lan, vpn, vlan, isolated, dmz"
)
# Network configuration
cidr: Mapped[str] = mapped_column(
String(100),
nullable=False,
doc="Network CIDR notation (e.g., '192.168.0.0/24')"
)
gateway_ip: Mapped[Optional[str]] = mapped_column(
String(45),
doc="Gateway IP address"
)
vlan_id: Mapped[Optional[int]] = mapped_column(
Integer,
doc="VLAN ID if applicable"
)
# Notes
notes: Mapped[Optional[str]] = mapped_column(
Text,
doc="Additional notes"
)
# Constraints and indexes
__table_args__ = (
CheckConstraint(
"network_type IN ('lan', 'vpn', 'vlan', 'isolated', 'dmz')",
name="ck_networks_type"
),
Index("idx_networks_client", "client_id"),
Index("idx_networks_site", "site_id"),
)
def __repr__(self) -> str:
"""String representation of the network."""
return f"<Network(network_name='{self.network_name}', cidr='{self.cidr}')>"