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>
70 lines
1.8 KiB
Python
70 lines
1.8 KiB
Python
"""
|
|
Base models and mixins for SQLAlchemy ORM.
|
|
|
|
This module provides the foundational base class and reusable mixins
|
|
for all database models in the ClaudeTools application.
|
|
"""
|
|
|
|
import uuid
|
|
from datetime import datetime
|
|
from typing import Any
|
|
|
|
from sqlalchemy import CHAR, Column, DateTime
|
|
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
|
|
from sqlalchemy.sql import func
|
|
|
|
|
|
class Base(DeclarativeBase):
|
|
"""Base class for all SQLAlchemy ORM models."""
|
|
|
|
pass
|
|
|
|
|
|
class UUIDMixin:
|
|
"""
|
|
Mixin that adds a UUID primary key column.
|
|
|
|
This mixin provides a standardized UUID-based primary key for models,
|
|
stored as CHAR(36) for compatibility with MariaDB and other databases
|
|
that don't have native UUID support.
|
|
|
|
Attributes:
|
|
id: UUID primary key stored as CHAR(36), automatically generated
|
|
"""
|
|
|
|
id: Mapped[str] = mapped_column(
|
|
CHAR(36),
|
|
primary_key=True,
|
|
default=lambda: str(uuid.uuid4()),
|
|
nullable=False,
|
|
doc="Unique identifier for the record",
|
|
)
|
|
|
|
|
|
class TimestampMixin:
|
|
"""
|
|
Mixin that adds timestamp columns for record tracking.
|
|
|
|
This mixin provides automatic timestamp tracking for record creation
|
|
and updates, using database-level defaults for consistency.
|
|
|
|
Attributes:
|
|
created_at: Timestamp when the record was created
|
|
updated_at: Timestamp when the record was last updated
|
|
"""
|
|
|
|
created_at: Mapped[datetime] = mapped_column(
|
|
DateTime,
|
|
nullable=False,
|
|
server_default=func.now(),
|
|
doc="Timestamp when the record was created",
|
|
)
|
|
|
|
updated_at: Mapped[datetime] = mapped_column(
|
|
DateTime,
|
|
nullable=False,
|
|
server_default=func.now(),
|
|
server_onupdate=func.now(),
|
|
doc="Timestamp when the record was last updated",
|
|
)
|