Files
ServerKit/backend/app/models/error_log.py
T
Juan Denis 2365a32408 refactor(models): one JsonColumnMixin instead of 24 hand-rolled copies
Every model with a JSON-in-Text column hand-rolled the same try/except
json.loads pair — get_details/get_context/get_headers/get_payload and a
dozen more, each a place the next fix would have to land N times. The
mixin owns the mechanics (empty-is-default, corrupt-is-default so a
hand-edited row never 500s an endpoint, optional shape check,
falsy-on-write); the per-model parts — accessor name, column, default —
stay per-model.

Conversion is behaviour-preserving: identical fallbacks, identical
on-write empty forms (NULL vs '[]' vs '{}'). Deliberately NOT converted:
accessors that let json.loads raise on corrupt data (collapsing those
would be a behaviour change, not a consolidation), and inline parses in
to_dict (per-entity serialization choice). A handful of 'except
Exception' reads narrow to the dominant (JSONDecodeError, TypeError) —
the only exceptions json.loads raises for str input.
2026-08-17 21:43:59 -04:00

59 lines
2.4 KiB
Python

from datetime import datetime
from app import db
from app.models.json_column_mixin import JsonColumnMixin
class ErrorLog(JsonColumnMixin, db.Model):
"""Centralized error log with fingerprint-based dedup."""
__tablename__ = 'error_logs'
id = db.Column(db.Integer, primary_key=True)
fingerprint = db.Column(db.String(64), nullable=False, index=True) # sha256 hex
source = db.Column(db.String(20), nullable=False, index=True) # backend | frontend
level = db.Column(db.String(20), nullable=False, default='error')
exception_type = db.Column(db.String(200), nullable=True)
message = db.Column(db.Text, nullable=False)
traceback = db.Column(db.Text, nullable=True)
endpoint = db.Column(db.String(255), nullable=True) # API path / page URL
method = db.Column(db.String(10), nullable=True)
user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
context_json = db.Column(db.Text, nullable=True) # JSON string
count = db.Column(db.Integer, nullable=False, default=1) # dedup hit counter
first_seen = db.Column(db.DateTime, default=datetime.utcnow)
last_seen = db.Column(db.DateTime, default=datetime.utcnow, index=True)
resolved = db.Column(db.Boolean, default=False, index=True)
# Relationship to user
user = db.relationship('User', foreign_keys=[user_id])
def get_context(self):
"""Return parsed context JSON."""
return self._json_read('context_json')
def set_context(self, context_dict):
"""Set context from a dictionary."""
self._json_write('context_json', context_dict)
def to_dict(self):
return {
'id': self.id,
'fingerprint': self.fingerprint,
'source': self.source,
'level': self.level,
'exception_type': self.exception_type,
'message': self.message,
'traceback': self.traceback,
'endpoint': self.endpoint,
'method': self.method,
'user_id': self.user_id,
'username': self.user.username if self.user else None,
'context': self.get_context(),
'count': self.count,
'first_seen': self.first_seen.isoformat() if self.first_seen else None,
'last_seen': self.last_seen.isoformat() if self.last_seen else None,
'resolved': self.resolved,
}
def __repr__(self):
return f'<ErrorLog {self.source}:{self.exception_type} x{self.count}>'