Files
claudetools/api/models/service.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

123 lines
3.7 KiB
Python

"""
Service model for applications running on infrastructure.
Services represent applications, databases, web servers, and other software
running on infrastructure components.
"""
from typing import TYPE_CHECKING, Optional
from sqlalchemy import CHAR, CheckConstraint, ForeignKey, Index, Integer, String, Text
from sqlalchemy.orm import Mapped, mapped_column, relationship
from .base import Base, TimestampMixin, UUIDMixin
if TYPE_CHECKING:
from .deployment import Deployment
class Service(Base, UUIDMixin, TimestampMixin):
"""
Service model representing applications running on infrastructure.
Tracks applications, services, databases, web servers, and other software
components running on infrastructure with URLs, ports, and status.
Attributes:
infrastructure_id: Reference to the infrastructure hosting this service
service_name: Name of the service (e.g., "Gitea", "PostgreSQL")
service_type: Type of service (e.g., "git_hosting", "database")
external_url: External URL for accessing the service
internal_url: Internal URL for accessing the service
port: Port number the service runs on
protocol: Protocol used (https, ssh, smb, etc.)
status: Current status (running, stopped, error, maintenance)
version: Version of the service
notes: Additional notes
"""
__tablename__ = "services"
# Foreign keys
infrastructure_id: Mapped[Optional[str]] = mapped_column(
CHAR(36),
ForeignKey("infrastructure.id", ondelete="CASCADE"),
doc="Reference to the infrastructure hosting this service"
)
# Service identification
service_name: Mapped[str] = mapped_column(
String(255),
nullable=False,
doc="Name of the service (e.g., 'Gitea', 'PostgreSQL', 'Apache')"
)
service_type: Mapped[Optional[str]] = mapped_column(
String(100),
doc="Type of service (e.g., 'git_hosting', 'database', 'web_server')"
)
# URLs and connectivity
external_url: Mapped[Optional[str]] = mapped_column(
String(500),
doc="External URL for accessing the service"
)
internal_url: Mapped[Optional[str]] = mapped_column(
String(500),
doc="Internal URL for accessing the service"
)
port: Mapped[Optional[int]] = mapped_column(
Integer,
doc="Port number the service runs on"
)
protocol: Mapped[Optional[str]] = mapped_column(
String(50),
doc="Protocol used (https, ssh, smb, etc.)"
)
# Status
status: Mapped[str] = mapped_column(
String(50),
default="running",
server_default="running",
nullable=False,
doc="Status: running, stopped, error, maintenance"
)
# Version
version: Mapped[Optional[str]] = mapped_column(
String(100),
doc="Version of the service"
)
# Notes
notes: Mapped[Optional[str]] = mapped_column(
Text,
doc="Additional notes"
)
# Relationships
deployments: Mapped[list["Deployment"]] = relationship(
"Deployment",
back_populates="service",
doc="Relationship to Deployment model"
)
# Constraints and indexes
__table_args__ = (
CheckConstraint(
"status IN ('running', 'stopped', 'error', 'maintenance')",
name="ck_services_status"
),
Index("idx_services_infrastructure", "infrastructure_id"),
Index("idx_services_name", "service_name"),
Index("idx_services_type", "service_type"),
)
def __repr__(self) -> str:
"""String representation of the service."""
return f"<Service(service_name='{self.service_name}', status='{self.status}')>"