https://github.com/seadve/uets

Universal Entity Tracking System
https://github.com/seadve/uets

Last synced: 10 months ago
JSON representation

Universal Entity Tracking System

• Host: GitHub
• URL: https://github.com/seadve/uets
• Owner: SeaDve
• License: gpl-3.0
• Created: 2024-10-24T07:02:29.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-07T15:03:21.000Z (about 1 year ago)
• Last Synced: 2025-06-06T19:14:59.336Z (about 1 year ago)
• Language: Rust
• Homepage:
• Size: 5.99 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

          
# Universal Entity Tracking System (UETS)

UETS is a universal system that tracks entities using RFID tags. It is designed to be used in a variety of applications, such as inventory management, establishment access control, and more.

## 🕹️ Operation Modes

### 🔢 Counter

This is used for entities that don't have any specific data (e.g., mall entry counter).

### 🕒 Attendance

This is used for tracking attendance, whereas unauthorized entities are not allowed to enter (e.g., classroom, meeting room, school gate, establishment entry).

### 🚗 Parking

This is used for tracking parking spaces and vehicles (e.g., parking lot).

This is useful for tracking how long a vehicle has been parked and whether it is authorized to park.

### 📦 Inventory

This is used for entities that have lifetime, location, and quantity (e.g., stock room, department store, medicine storage).

### 🧊 Refrigerator

This is used for entities that have lifetime and quantity (e.g., food storage).

This is experimental as it is labor-intensive to tag entities with this kind.

## ✨ Features

### 📊 Report Generation

- Filter by date range, entity ID, name, location, etc.

- Visualize data in a graph.

- Create report about depleting stocks, overflows, nearly expiring items, etc.

- Export as PDF or XLSX via QR code.

### ⏱️ Real-time Monitoring

- View entities entering and exiting in real-time.

- View real time statistics and graphs.

- Notify on stock depletion, capacity overflow, or expiring items.

### 🧾 Easy Data Handling

- Pre-input data via spreadsheet files.

- Support for BPSU CEA's QRifying system and national ID QR codes.

### 🤖 Automation

- Automatically control IoT devices, such as lights, doors, etc. based on entity count data.

### 🔒 Security

- Prevents unauthorized entities from entering, such as those without IDs or disallowed entities.

- Prevents overstay of entities. This is useful for parking lots, classrooms, arcade games, etc.

### 📈 Smart Data Analysis

- Provide insights on data.

- Detects anomalies in data, such as sudden increase in entity count, etc.

- Predicts future entity count based on historical data.

- Suggests optimal stock levels based on historical data.

- Provide recipes based on available stock.

## 🚀 Planned Features

1. Override timeline items for errors

2. Show license of all libraries

3. Implement local transfer wormhole

4. Support changing stock id

5. Consider entity name on sorter, etc.

6. Ability to filter entity data on report generation

## 📷 Screenshots

### Dashboard

![Dashboard](data/screenshots/dashboard.png)

![Dashboard 1](data/screenshots/dashboard-1.png)

![Dashboard 2](data/screenshots/dashboard-2.png)

#### Camera Live Feed

![Camera Live Feed](data/screenshots/camera-live-feed.png)

#### Detected Without IDs

![Detected Without IDs](data/screenshots/detected-without-ids.png)

#### Entity Gallery

![Entity Gallery](data/screenshots/entity-gallery.png)

#### Data Analyzer and Assistant

![Data Analyzer and Assistant](data/screenshots/data-analyzer-and-assistant.png)

#### Advance Data Registration

![Advance Data Registration](data/screenshots/advance-data-registration.png)

### Timeline

![Timeline](data/screenshots/timeline.png)

### Entities View

![Entities View](data/screenshots/entities-view.png)

#### Entity Details

![Entity Details 0](data/screenshots/entity-details-0.png)

![Entity Details 1](data/screenshots/entity-details-1.png)

#### Entity Details Editor

![Entity Details Editor](data/screenshots/entity-details-editor.png)

### Stocks View

![Stocks View](data/screenshots/stocks-view.png)

### Report Generation

![Report Generation](data/screenshots/report-generation.png)

### Settings

![Settings 0](data/screenshots/settings-0.png)

![Settings 1](data/screenshots/settings-1.png)

### Date Time Range Picker

![Date Time Range Picker](data/screenshots/date-time-range-picker.png)

## 🏗️ Building and Running

1. Set up a toolbox container.

   - Run, `toolbox create --distro ubuntu --release 24.04`

2. Set up Rust via `rustup`.

   - Optionally, install `rust-analyzer` via `rustup component add rust-analyzer`.

3. Run `./setup` to install the required dependencies.

4. Run `./run` to build and run the project.

## 🔌 Setting up Raspberry Pi

### 🔃 Upload Code

1. Run the following command to upload or sync the code to the device:

```sh

rsync --filter=':- .gitignore' --exclude \".*/\" -aP ./ $REMOTE_DIR

```

### 🛠️ Setup Touchscreen Display

1. Set display orientation to portrait mode via GNOME Control Center.

2. Fix touchcreen calibration rules by adding the following to `/etc/udev/rules.d/99-calibration.rules`:

```

ATTRS{name}=="wch.cn USB2IIC_CTP_CONTROL", ENV{LIBINPUT_CALIBRATION_MATRIX}="0 1 0 -1 0 1"

```

3. Reboot the system.