mirror of https://github.com/rzuasti/oott.git synced 2026-07-08 19:21:54 +02:00

Files

T

rzuastiandClaude Sonnet 4.6 913bf0e839 Add mark as read action to notifications list

Users can now mark a notification as read via a popup menu on each list
item or by swiping left. Both actions call the backend API, remove the
item from the list, and show a snackbar confirmation. Swiping an already
read notification shows an error snackbar and bounces the item back.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-27 09:58:39 -04:00

2.8 KiB

Raw Blame History

Project OOTT

OOTT is an easy to setup network monitoring and alert system aimed at notifying when new or unknown devices join a local area network.

It has two major components:

A backend service that runs the monitoring and other processes and provides a REST API. This is built with Rust.
A front-end that enables the user to configure the system and access the data it stores. This is built with Flutter - a front-end framework based on the Dart language.

Code style

For Rust code:

Use the standard Rust style guide
Use rustfmt to format the code

For Flutter/Dart code:

Use the standard Dart style guide
Use dart format --output show to format the code

Project commands

sudo cargo run from the backend/ folder - Run the backend (you need sudo to enable the process to attach itself to the network channel)
flutter run -d web-server --web-port 3333 from the frontend/ folder - Run the front-end for the web
run_tests.sh - Run the backend tests

Architecture

General

All backend source code is under the backend/ folder
All front-end source code is under the frontend/ folder
All interactions between the front-end and the backend are via the backend REST API

Backend

System state and events are stored in a SQLite database (oott.db by default) which is accessed and managed exclusively by the backend via a data access layer (db.rs and files under the backend/src/db/ folder)
Database structure is handled through incremental migrations (stored under the backend/database_migrations folder). Each set of structural changes should be a new database migration file.
The backend's entry point is src/main.rs which starts two threads using the Tokyo framework: one for the network scanning process and another one for the web server that exposes the API and hosts the Flutter app (front-end) assets when deployed in a live environment (ie not development)

Front-end

The front-end's entry point is lib/main.dart
It uses the Material 3 framework for Flutter
The application needs to be responsive and adapt to a web experience in the desktop, tablets and phones
The application is also available in iOS and Android as a native experience (via de App Store and Play store)
Backend API access is implemented in the utils/oott_api.dart component

Important notes

NEVER add or commit .env files or files with secrets (passwords, API keys or similar information)
Code must be as simple as possible, human readable and modularized
ALWAYS write unit tests for new or modified backend components
ALWAYS run all tests after making a new change and do not continue until all tests pass

2.8 KiB Raw Blame History