JEKA AOPS

JEKA AOPS — Audio-optički sustav prometne sigurnosti

Mobilni istraživačko-razvojni projekt za snimanje i kasniju analizu prometnih scena pomoću kamere, mikrofona i umjetne inteligencije na pametnom telefonu.

Trenutačna verzija: v0.2.0 razvojna. Aplikacija lokalno snima videosesije sa zvukom, izdvaja dokazne kadrove i koristi licencirani lokalni EfficientDet-Lite0 model za eksperimentalnu detekciju vozila. Aplikacija ne mjeri niti potvrđuje stvarnu brzinu vozila ili razinu buke.

Cilj

JEKA AOPS služi za razvoj alata koji će pomoći pri promatranju prometnih uvjeta. Buduće verzije predviđaju praćenje vozila, procjenu brzine, procjenu razine buke te izvještaje povezane s lokacijom.

Kako radi

flowchart LR
    A["Korisnik pokrene sesiju"] --> B["Kamera + mikrofon"]
    B --> C["Video sa zvukom"]
    C --> D["Lokalna pohrana uređaja"]
    D --> E["Dnevnik snimljenih sesija"]
    E --> F["Lokalna AI priprema i detekcija vozila"]
    F -. buduće faze .-> G["Kalibrirane procjene i izvještaj"]

Loading

Faze razvoja

flowchart TB
    P1["1. Snimanje videa i zvuka\n✓ dovršeno"] --> P2["2. AI detekcija i praćenje vozila\nrazvojno, treba terensku provjeru"]
    P2 --> P3["3. Kalibrirana procjena brzine iz videa"]
    P3 --> P4["4. Procjena razine buke"]
    P4 --> P5["5. GPS, karta i izvještaji"]
    P5 --> P6["6. AI asistent i MCP integracija"]

Loading

Trenutačne mogućnosti

• Snimanje videozapisa sa zvukom kroz stražnju ili prednju kameru.
• Dozvole za kameru i mikrofon na Androidu i iOS-u.
• Trajna lokalna pohrana snimljene datoteke na uređaju.
• Uvoz MP4, MOV, M4V i 3GP snimki do 500 MB uz provjeru trajanja.
• Lokalni dnevnik sesija s vremenom snimanja, trajanjem i veličinom datoteke.
• Pregled snimljenog videa unutar aplikacije i trajno brisanje odabrane sesije.
• Sučelje prilagođeno radu na terenu: status, mjerač vremena i brzo zaustavljanje snimanja.
• Eksperimentalna lokalna obrada: EfficientDet-Lite0 detekcija vozila, izdvajanje i rangiranje kadrova, osnovno praćenje, OCR kandidati oznaka te dekodiranje i vremenska korelacija zvuka iz uvezenog videa.
• Razvojna dijagnostika prikazuje confidence, vrijeme i okvir svake detekcije po tragu vozila.
• Automatizirane provjere obuhvaćaju lint, TypeScript i testove čistih analitičkih modula.

Arhitektura prototipa

flowchart TB
    UI["React Native / Expo sučelje"] --> CAM["expo-camera\nCameraView"]
    CAM --> REC["Snimanje videozapisa"]
    REC --> FS["expo-file-system\nDocuments/jeka-aops"]
    UI --> LOG["AsyncStorage\ndnevnik sesija"]
    FS --> NEXT["Budući modul analize"]
    LOG --> NEXT

Loading

Pokretanje lokalno

Preduvjeti

• Node.js LTS
• Expo development build na Android ili iOS telefonu
• Računalo i telefon na istoj Wi-Fi mreži

Instalacija i pokretanje

npm install
npm start

Pokrenite razvojni poslužitelj i otvorite ga development buildom. Za rad kamere koristite stvarni uređaj; emulator nije prikladan za terensko snimanje.

Android development build i terensko testiranje

Za lokalni AI model aplikacija koristi vlastiti Android development build, a ne Expo Go. Konfiguracija je pripremljena u eas.json pod profilom development i proizvodi interni .apk paket.

Nakon prijave u Expo račun, build se stvara naredbom:

npx eas-cli@latest build --platform android --profile development

Nakon instalacije tog paketa na telefon, razvojni poslužitelj pokreće se s:

npx expo start --dev-client

Prije početka snimanja potvrdite dozvole za kameru, mikrofon i lokaciju. Snimite kratke scene u različitim uvjetima (jedno vozilo, više vozila, dan/noć), otvorite pojedinu sesiju i provjerite jesu li detekcije smisleno vezane uz dokazne kadrove. Rezultate detekcije, OCR-a i buke tretirajte kao eksperimentalne dok se ne potvrde kroz terenska testiranja.

Privatnost i sigurnosna napomena

• Snimke se u ovoj fazi čuvaju lokalno na uređaju.
• Lokacija je zadano isključena; kad je korisnik uključi, sprema se samo približna lokacija.
• Korisnik je odgovoran za zakonito korištenje kamere i mikrofona te poštovanje privatnosti drugih osoba.
• Rezultati budućih modula bit će procjene, a ne certificirana mjerenja ili dokaz o prometnom prekršaju.
• Aplikacija ne smije ometati vozača. Snimanje treba obavljati samo sigurno i u skladu s prometnim propisima.

Tehnologije

• Expo SDK 57
• React Native 0.86.3
• TypeScript
• expo-camera
• expo-file-system
• expo-video
• react-native-audio-api
• AsyncStorage

AI model

Javni repozitorij uključuje službeni EfficientDet-Lite0 int8 v1 pod Apache-2.0 licencom. Izvor, SHA-256, ulazno-izlazni ugovor i ograničenja opisani su u modelskoj kartici.

Smjer projekta

JEKA AOPS je otvoreni istraživačko-razvojni projekt pod licencom Apache-2.0. Sljedeći korak je terenska provjera lokalnog modela, OCR-a i praćenja u Android development buildu. Bez kalibracije scene rezultati se ne smiju predstavljati kao mjerenje.

Doprinos i sigurnost

Pravila doprinosa opisana su u CONTRIBUTING.md, odgovorna obrada podataka u PRIVACY.md, a privatna prijava ranjivosti u SECURITY.md. Ne prilažite stvarne prometne snimke, GPS podatke ni osobne podatke u issue ili pull request.

Licenca

Izvorni kod distribuira se pod licencom Apache-2.0. Naziv i vizualni identitet projekta nisu automatski licencirani kao zaštitni znakovi. Ovisnosti i budući modeli ostaju pod vlastitim licencama.