Apppublic

eldivategar/tidal-orbit-core

sourceHugging Faceupdated 6mo agoView on Hugging Face

0likes

App README

🌌 Tidal Orbit - Backend (API)

Repositori ini berisi kode sumber untuk layanan backend (API) proyek Tidal Orbit. Layanan ini bertanggung jawab atas manajemen data, autentikasi, dan pemrosesan biometrik wajah untuk sistem absensi.

✨ Fitur Utama

—🧠 Biometric Processing: Ekstraksi dan perbandingan face embeddings secara akurat menggunakan pustaka berbasis Dlib.
—🚀 High-Performance API: Dibangun dengan FastAPI dan Uvicorn untuk asinkronitas dan kecepatan tinggi.
—🔍 Vector Search: Integrasi pgvector pada PostgreSQL untuk pencarian kemiripan wajah yang efisien.
—🔐 Keamanan: Implementasi JWT/JWE untuk autentikasi dan enkripsi data sensitif.
—📊 Database Management: Menggunakan SQLAlchemy ORM dan Alembic untuk migrasi basis data yang terstruktur.

🛠️ Stack Teknologi

—Bahasa: Python 3.x
—Framework: FastAPI
—Database: PostgreSQL dengan ekstensi pgvector
—ORM: SQLAlchemy
—Biometrics: face-recognition, opencv-python, dlib
—Server: Uvicorn (dengan uvloop)

🚀 Panduan Instalasi

Prasyarat

—Python 3.10+
—PostgreSQL (dengan ekstensi vector terinstal)

Langkah-langkah

1.Masuk ke direktori server:

bash

   cd server

1.Buat dan aktifkan lingkungan virtual (virtual environment):

bash

   # MacOS/Linux
   python3 -m venv venv
   source venv/bin/activate

1.Instal dependensi:

bash

   pip install -r requirements.txt

1.Konfigurasi Environment: Salin file .env.example menjadi .env dan sesuaikan kredensial basis data Anda.

bash

   cp .env.example .env

🏃 Menjalankan Aplikasi

Jalankan server dalam mode pengembangan:

bash

uvicorn app.main:app --reload

Dokumentasi API otomatis dapat diakses melalui:

—Swagger UI: http://127.0.0.1:8000/docs
—Redoc: http://127.0.0.1:8000/redoc

📁 Struktur Proyek (Ringkasan)

—app/endpoints: Definisi rute API (auth, attendance, students).
—app/biometric: Logika pemrosesan citra wajah dan encoding.
—app/database: Konfigurasi basis data, model, dan skrip migrasi.
—app/schemas: Skema validasi data menggunakan Pydantic.
—app/core: Konfigurasi aplikasi dan sistem keamanan.