Projects

A user can have multiple projects.

Project model is defined in src/projects/models.py

Lighthouse and Report are defined in src/performances/models.py

Service, HTTPCodeService and HTTPMockedCodeService are defined in src/availability/models.py

Project

The Project model represents a website or application that a user wants to monitor.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
user	ForeignKey	-	Reference to the User who owns this project
title	CharField	-	Display name for the project
url	URLField	-	The main URL of the project
favicon	ImageField	null	Project’s favicon image
sitemap_task_status	CharField	-	Status of sitemap processing task
sitemap_last_edited	DateTimeField	null	Last time sitemap was updated
is_offline	BooleanField	False	Indicates if the project is currently offline
is_degraded	BooleanField	False	Indicates if the project has degraded performance
is_warning	BooleanField	False	Indicates if the project has warnings
availability	FloatField	-	Overall availability percentage
pathname	CharField	-	URL pathname for the project
incidents_count	IntegerField	0	Number of incidents for this project
performance_score	FloatField	-	Overall performance score
is_favorite	BooleanField	False	Whether this project is marked as favorite
enable_public_page	BooleanField	False	Whether to enable public status page
favicon_task_status	CharField	-	Status of favicon processing task
favicon_last_edited	DateTimeField	null	Last time favicon was updated

Pages

The Pages model represents individual pages within a project that are monitored.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
project	ForeignKey	-	Reference to the parent Project
url	URLField	-	URL of the specific page
title	CharField	-	Page title
description	TextField	-	Page description
created_at	DateTimeField	auto_now_add	When the page was first discovered
sitemap_last_seen	DateTimeField	null	Last time page was seen in sitemap
scraping_last_seen	DateTimeField	null	Last time page was scraped

Lighthouse

The Lighthouse model stores performance metrics for individual pages.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
page	ForeignKey	-	Reference to the monitored Page
performance	FloatField	-	Performance score (0-100)
accessibility	FloatField	-	Accessibility score (0-100)
best_practices	FloatField	-	Best practices score (0-100)

Report

The Report model stores detailed performance reports with screenshots.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
lighthouse	ForeignKey	-	Reference to the Lighthouse metrics
screenshot	ImageField	null	Screenshot of the page
form_factor	IntegerField	-	Device form factor (mobile/desktop)
score_performance	FloatField	-	Detailed performance score

Service

The Service model represents monitoring services for a project.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
project	ForeignKey	-	Reference to the parent Project
title	CharField	-	Service name
is_public	BooleanField	False	Whether service status is public
is_enabled	BooleanField	True	Whether the service is active

HTTPCodeService

The HTTPCodeService model represents HTTP-based monitoring services.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
url	URLField	-	URL to monitor
tls_skip_verify	BooleanField	False	Whether to skip TLS verification
service	OneToOneField	-	Reference to the parent Service

HTTPMockedCodeService

The HTTPMockedCodeService model represents mocked HTTP responses for testing.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
code	IntegerField	-	HTTP status code to return
service	OneToOneField	-	Reference to the parent Service

Incident

The Incident model tracks service outages and issues.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
service	ForeignKey	-	Reference to the affected Service
starts_at	DateTimeField	-	When the incident started
ends_at	DateTimeField	null	When the incident ended
status	IntegerField	-	Incident status code

Notification

The Notification model manages alerts and notifications for projects and services.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
project	ForeignKey	-	Reference to the parent Project
service	ForeignKey	null	Reference to the specific Service
severity	IntegerField	-	Notification severity level

Emails

The Emails model stores email addresses for project notifications.

Field	Type	Default	Description
id	AutoField	Auto-increment	Primary key
project	ForeignKey	-	Reference to the parent Project
email	EmailField	-	Email address for notifications