Mike Swanson
390b10b32c
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>
121 lines
3.3 KiB
Python
121 lines
3.3 KiB
Python
"""
|
|
Client model for all client organizations.
|
|
|
|
Master table for MSP clients, internal projects, and client organizations.
|
|
"""
|
|
|
|
from typing import TYPE_CHECKING, Optional
|
|
|
|
from sqlalchemy import Boolean, Index, String, Text
|
|
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
|
|
|
from .base import Base, TimestampMixin, UUIDMixin
|
|
|
|
if TYPE_CHECKING:
|
|
from .pending_task import PendingTask
|
|
from .project import Project
|
|
from .session import Session
|
|
|
|
|
|
class Client(Base, UUIDMixin, TimestampMixin):
|
|
"""
|
|
Client model representing client organizations.
|
|
|
|
Master table for all client organizations including MSP clients,
|
|
internal projects, and project-based clients. Stores client identification,
|
|
network information, and Microsoft 365 tenant details.
|
|
|
|
Attributes:
|
|
name: Client name (unique)
|
|
type: Client type (msp_client, internal, project)
|
|
network_subnet: Client network subnet (e.g., "192.168.0.0/24")
|
|
domain_name: Active Directory domain or primary domain
|
|
m365_tenant_id: Microsoft 365 tenant ID
|
|
primary_contact: Primary contact person
|
|
notes: Additional notes about the client
|
|
is_active: Whether client is currently active
|
|
"""
|
|
|
|
__tablename__ = "clients"
|
|
|
|
# Client identification
|
|
name: Mapped[str] = mapped_column(
|
|
String(255),
|
|
nullable=False,
|
|
unique=True,
|
|
doc="Client name (unique)"
|
|
)
|
|
|
|
type: Mapped[str] = mapped_column(
|
|
String(50),
|
|
nullable=False,
|
|
doc="Client type: msp_client, internal, project"
|
|
)
|
|
|
|
# Network information
|
|
network_subnet: Mapped[Optional[str]] = mapped_column(
|
|
String(100),
|
|
doc="Client network subnet (e.g., '192.168.0.0/24')"
|
|
)
|
|
|
|
domain_name: Mapped[Optional[str]] = mapped_column(
|
|
String(255),
|
|
doc="Active Directory domain or primary domain"
|
|
)
|
|
|
|
# Microsoft 365
|
|
m365_tenant_id: Mapped[Optional[str]] = mapped_column(
|
|
String(36),
|
|
doc="Microsoft 365 tenant ID (UUID format)"
|
|
)
|
|
|
|
# Contact information
|
|
primary_contact: Mapped[Optional[str]] = mapped_column(
|
|
String(255),
|
|
doc="Primary contact person"
|
|
)
|
|
|
|
# Notes
|
|
notes: Mapped[Optional[str]] = mapped_column(
|
|
Text,
|
|
doc="Additional notes about the client"
|
|
)
|
|
|
|
# Status
|
|
is_active: Mapped[bool] = mapped_column(
|
|
Boolean,
|
|
default=True,
|
|
server_default="1",
|
|
doc="Whether client is currently active"
|
|
)
|
|
|
|
# Relationships
|
|
projects: Mapped[list["Project"]] = relationship(
|
|
"Project",
|
|
back_populates="client",
|
|
cascade="all, delete-orphan",
|
|
doc="Projects associated with this client"
|
|
)
|
|
|
|
sessions: Mapped[list["Session"]] = relationship(
|
|
"Session",
|
|
back_populates="client",
|
|
doc="Sessions associated with this client"
|
|
)
|
|
|
|
pending_tasks: Mapped[list["PendingTask"]] = relationship(
|
|
"PendingTask",
|
|
back_populates="client",
|
|
doc="Pending tasks associated with this client"
|
|
)
|
|
|
|
# Indexes
|
|
__table_args__ = (
|
|
Index("idx_clients_type", "type"),
|
|
Index("idx_clients_name", "name"),
|
|
)
|
|
|
|
def __repr__(self) -> str:
|
|
"""String representation of the client."""
|
|
return f"<Client(name='{self.name}', type='{self.type}')>"
|