Files
claudetools/api/schemas/session.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

67 lines
3.7 KiB
Python

"""
Pydantic schemas for Session model.
Request and response schemas for work sessions with time tracking.
"""
from datetime import date, datetime
from typing import Optional
from uuid import UUID
from pydantic import BaseModel, Field
class SessionBase(BaseModel):
"""Base schema with shared Session fields."""
client_id: Optional[str] = Field(None, description="Foreign key to clients table (UUID)")
project_id: Optional[str] = Field(None, description="Foreign key to projects table (UUID)")
machine_id: Optional[str] = Field(None, description="Foreign key to machines table (UUID)")
session_date: date = Field(..., description="Date of the session")
start_time: Optional[datetime] = Field(None, description="Session start timestamp")
end_time: Optional[datetime] = Field(None, description="Session end timestamp")
duration_minutes: Optional[int] = Field(None, description="Duration in minutes (auto-calculated or manual)")
status: str = Field("completed", description="Session status: completed, in_progress, blocked, pending")
session_title: str = Field(..., description="Brief title describing the session")
summary: Optional[str] = Field(None, description="Markdown summary of the session")
is_billable: bool = Field(False, description="Whether this session is billable")
billable_hours: Optional[float] = Field(None, description="Billable hours if applicable")
technician: Optional[str] = Field(None, description="Name of technician who performed the work")
session_log_file: Optional[str] = Field(None, description="Path to markdown session log file")
notes: Optional[str] = Field(None, description="Additional notes about the session")
class SessionCreate(SessionBase):
"""Schema for creating a new Session."""
pass
class SessionUpdate(BaseModel):
"""Schema for updating an existing Session. All fields are optional."""
client_id: Optional[str] = Field(None, description="Foreign key to clients table (UUID)")
project_id: Optional[str] = Field(None, description="Foreign key to projects table (UUID)")
machine_id: Optional[str] = Field(None, description="Foreign key to machines table (UUID)")
session_date: Optional[date] = Field(None, description="Date of the session")
start_time: Optional[datetime] = Field(None, description="Session start timestamp")
end_time: Optional[datetime] = Field(None, description="Session end timestamp")
duration_minutes: Optional[int] = Field(None, description="Duration in minutes (auto-calculated or manual)")
status: Optional[str] = Field(None, description="Session status: completed, in_progress, blocked, pending")
session_title: Optional[str] = Field(None, description="Brief title describing the session")
summary: Optional[str] = Field(None, description="Markdown summary of the session")
is_billable: Optional[bool] = Field(None, description="Whether this session is billable")
billable_hours: Optional[float] = Field(None, description="Billable hours if applicable")
technician: Optional[str] = Field(None, description="Name of technician who performed the work")
session_log_file: Optional[str] = Field(None, description="Path to markdown session log file")
notes: Optional[str] = Field(None, description="Additional notes about the session")
class SessionResponse(SessionBase):
"""Schema for Session responses with ID and timestamps."""
id: UUID = Field(..., description="Unique identifier for the session")
created_at: datetime = Field(..., description="Timestamp when the session was created")
updated_at: datetime = Field(..., description="Timestamp when the session was last updated")
model_config = {"from_attributes": True}