Git Product home page Git Product logo

bas-celik's Introduction

Baš Čelik

Baš Čelik je čitač elektronskih ličnih karata, zdravstvenih knjižica i saobraćajnih dozvola. Program je osmišljen kao zamena za zvanične aplikacije poput Čelika. Nažalost, zvanične aplikacije mogu se pokrenuti samo na Windows operativnom sistemu, dok Baš Čelik funkcioniše na tri operativna sistema (Windows/Linux/OSX).

Baš Čelik je besplatan program, sa potpuno otvorenim kodom dostupnim na adresi github.com/ubavic/bas-celik.

Interfejs

Upotreba

Povežite čitač za računar i pokrenite Baš Čelik. Ubacite karticu u čitač. Program će pročitati informacije sa kartice i prikazati ih. Tada možete sačuvati PDF pritiskom na donje desno dugme.

Kreirani PDF dokument izgleda maksimalno približno dokumentu koji se dobija sa zvaničnim aplikacijama.

Pokretanje na Linuksu

Baš Čelik zahteva instalirane ccid i opensc/pcscd pakete. Nakon instalacije ovih paketa, neophodno je i pokrenuti pcscd servis:

sudo systemctl start pcscd
sudo systemctl enable pcscd

Pokretanje u komandnoj liniji

Baš Čelik prihvata sledeće opcije:

  • -atr: ATR kôd kartice biće prikazan u konzoli.
  • -help: informacija o opcijama biće prikazana u konzoli.
  • -json PATH: grafički interfejs neće biti pokrenut, a sadržaj dokumenta biće direktno sačuvan u JSON datoteku na PATH lokaciji.
  • -list: lista raspoloživih čitača biće prikazana u konzoli.
  • -pdf PATH: grafički interfejs neće biti pokrenut, a sadržaj dokumenta biće direktno sačuvan u PDF datoteku na PATH lokaciji.
  • -verbose: tokom rada aplikacije detalji o greškama biće prikazani u konzoli.
  • -version: informacija o verziji programa biće prikazana u konzoli.
  • -reader INDEX: postavlja odabrani čitač za čitanje podataka. Parametar INDEX označava prirodan broj koji je naveden u ispisu list komande. Izbor utiče samo na čitanje sa pdf i json opcijama.

U slučaju json i pdf opcija, program ne dodaje ekstenziju na kraj lokacije koju je korisnik naveo.

Pri pokretanju sa atr, json ili pdf opcijom, program očekuje da je kartica smeštena u čitač i neće čekati na ubacivanje kartice kao što je to slučaj sa grafičkim okruženjem.

Pri pokretanju sa atr, help, list ili version opcijama podaci sa kartice neće biti očitani (osim eventualno ATR koda). Program će prestati izvršavanje nakon ispisa odgovarajuće informacije.

Čitači i drajveri

Baš Čelik bi trebalo da funkcioniše sa svim čitačima pametnih kartica koji su trenutno dostupni u prodaji (Gemalto, Hama, Samtec...). Korisnici Windows (7, 8, 10, 11) i macOS operativnih sistema ne moraju da instaliraju ni jedan dodatni program (drajver).

Preuzimanje

Izvršne datoteke poslednje verzije programa možete preuzeti sa Releases stranice.

Dostupan je i AUR paket za Arch korisnike.

Kompilacija

Potrebno je posedovati go kompajler. Na Linuksu je potrebno instalirati i libpcsclite-dev i pakete za Fyne (možda i pkg-config).

Nakon preuzimanja repozitorijuma, dovoljno je pokrenuti

go mod download
go build

Prva kompilacija može potrajati nekoliko minuta (i do deset), jer je neophodno da se preuzmu i kompajliraju sve Golang biblioteke. Sve naredne kompilacije se izvršavaju u nekoliko sekundi.

Kroskompilacija

Uz pomoć fyne-cross programa moguće je na jednom operativnom sistemu iskompajlirati program za sva tri operativna sistema. Ovaj program zahteva Docker na vašem operativnom sistemu.

Planirane nadogradnje

  • Potpisivanje dokumenata sa sertifikatom smeštenim na LK
  • Verifikacija podataka na karticama
  • Opcija promene PIN koda na LK
  • Podrška za dokumente iz susednih država (CG, BiH, HR...)

Poznati problemi

Baš Čelik bi trebalo da podržava očitavanje svih ličnih karata, zdravstvenih knjižica i saobraćajnih dozvola. Unapred sam zahvalan za bilo kakvu povratnu informaciju o problemima.

Eventualni bug u Baš Čelik aplikaciji ne utiče na "sigurnost" vašeg dokumenta. Baš Čelik isključivo čita podatke sa kartice.

Ćirilica i latinica

Program prikazuje i eksportuje podatke onako kako su zapisani na kartici. Ako na nekom dokumentu uočite podatke na oba pisma, u pitanju nije bug već stanje na kartici.

Arhitektura aplikacije

Aplikacija je podeljena na sledeće pakete:

  • document - paket definiše tri tipa IdDocument, MedicalDocument i VehicleDocument koji zadovoljavaju Document interfejs. Ovi tipovi se koriste kroz celu aplikaciju. Uz definicije tipova, implementirane su i metode za eksport struktura u PDF i JSON.
  • card - paket definiše funkcije za komunikaciju sa pametnim karticama i funkcije za parsiranje Document struktura iz TLV i BER datoteka.
  • gui - definicija grafičkog interfejsa uključujući i pooler kartice.
  • localization - skup pomoćnih funkcije da za formatiranje datuma, podršku za različita pisma, itd..

Ostali direktorijumi u okviru projekta:

  • embed i assets - dodatne datoteke. Neke se linkuju u izvršnu verziju prilikom kompilacije.
  • script - dodatne skripte.

Doprinos

Pre kreiranja issue-a i pull request-ova, pročitati CONTRIBUTING.md.

Slični projekti

Postoje takođe i drugi projekti otvorenog koda koji imaju izvesne sličnosti sa Baš Čelikom:

  • JFreesteel i jevrc Java programi čiji kôd mi je pomogao pri implementaciji nekih delova Baš Čelika.
  • SerbianIdReader Rust program za očitavanje ličnih karata.
  • mup-rs-api-delphi, BashChelik i Saobracajna.NET wraperi u različitim jezicima za svanične MUP-ove biblioteke (sličost u nazivu sa jednom od biblioteka je slučajna).
  • golksd stariji čitač ličnih i saobraćajnih napisan u Golanu.

Licenca

Program i izvorni kôd su objavljeni pod MIT licencom.

Font Liberation je objavljen pod SIL Open Font licencom.

bas-celik's People

Contributors

ubavic avatar milemik avatar najdanovicivan avatar pilipovicn avatar codelieutenant avatar dusnm avatar lukica00 avatar mikecitt avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.