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

74 lines
2.2 KiB
Python

"""
Schema migration model for tracking Alembic database migrations.
Tracks which database schema migrations have been applied, when, and by whom
for database version control and migration management.
"""
from datetime import datetime
from typing import Optional
from sqlalchemy import String, Text, TIMESTAMP
from sqlalchemy.orm import Mapped, mapped_column
from sqlalchemy.sql import func
from .base import Base
class SchemaMigration(Base):
"""
Schema migration model for tracking Alembic database migrations.
Records database schema version changes applied via Alembic migrations.
Used to track which migrations have been applied, when they were applied,
and the SQL executed for audit and rollback purposes.
Note: This model does NOT use UUIDMixin as it uses version_id as the
primary key to match Alembic's migration tracking system.
Attributes:
version_id: Alembic migration version identifier (primary key)
description: Description of what the migration does
applied_at: When the migration was applied
applied_by: User or system that applied the migration
migration_sql: SQL executed during the migration
"""
__tablename__ = "schema_migrations"
# Primary key - Alembic version identifier
version_id: Mapped[str] = mapped_column(
String(100),
primary_key=True,
doc="Alembic migration version identifier"
)
# Migration details
description: Mapped[Optional[str]] = mapped_column(
Text,
doc="Description of what the migration does"
)
# Application tracking
applied_at: Mapped[datetime] = mapped_column(
TIMESTAMP,
nullable=False,
server_default=func.now(),
doc="When the migration was applied"
)
applied_by: Mapped[Optional[str]] = mapped_column(
String(255),
doc="User or system that applied the migration"
)
# Migration SQL
migration_sql: Mapped[Optional[str]] = mapped_column(
Text,
doc="SQL executed during the migration"
)
def __repr__(self) -> str:
"""String representation of the schema migration."""
return f"<SchemaMigration(version='{self.version_id}', applied_at='{self.applied_at}')>"