# Acquabooks

## Semilavorato digitale per librai in erba

###

##### Una produzione CS Django

##### Scenggiatura e regia di Mario Incandenza

## Esigenze

- Tenere traccia del venduto

  (prima: presitoriche barre verticali su carta)

- Produrre documenti per rendicontazione

  (prima: decodifica e del dato su carta e digitazlizzaione dello stesso)

- Mettere in condizione chiunque di "gestire una transazione"

  (anche se questo chiunque non è propriamente in condizione di gentirne una )

Parte tecnica che vi sriparmio!

## Linee guida

Adesione bilaterale al paradigma KISS

UI da terminale: "Estetica è saturazione di mercati"

Utilizzo di un lettore di codici a barre

## Nasce Acquabooks

in Java quindi Write Once Run Anywhere

## Modalità vendita

    acquabooks-0.1.5$ ./bin/acquabooks -s

- Modalità ascolto continuo
- Incremento del venduto di una unità
- Possibilità di specificare l'incremento (anche "0") con ":"

#####
{POC time}

## Modalità importazione/aggiornamento

    acquabooks-0.1.5$ ./bin/acquabooks -i foo.json

oppure

    acquabooks-0.1.5$ ./bin/acquabooks -u foo.json

- Importazione: prende i libri censiti nel tracciato json e li indicizza. Se trova un libro già inserito lo skippa
- Aggiornamento: prende i libri censiti nel tracciato json e li indicizza. Se trova un libro già inserito lo aggiorna

#####
{POC time}

## **zzo è un tracciato json ?

E' un documento di testo editabile da qualsiasi editor di testi (aka NotePad) che contiente gli oggetti "libro" (cos'è?) con le relative proprietà

    [
      {
        "barcode": "9788897339229",
        "titolo": "n. 4/2013 Animal Studies (Rivista). Gli animali di Foucault",
        "autore": "AA.VV.",
        "editore": "novalogos",
        "tag": "macerono",
        "prezzo": 4.0,
        "percentuale": 0.25,
        "qa": 1,
        "qv": 1,
        "sconto": 0.15
      },
      {
        "barcode": "9788889987636",
        "titolo": "Oggi e dopodomani",
        "autore": "Ourednik, Patrik",
        "editore": "duepunti",
        "tag": "macerono",
        "prezzo": 4.0,
        "percentuale": 1.0,
        "qa": 2,
        "qv": 0,
        "sconto": 0.0
      },
    ...
      {
        "barcode": "9788867991167",
        "titolo": "Tigre di carta",
        "autore": "Olivier Rolin",
        "editore": "clichy",
        "tag": "catalogo,contovendita",
        "prezzo": 17.0,
        "percentuale": 0.35,
        "qa": 1,
        "qv": 0,
        "sconto": 0.0
      }
    ]

<

## Modalità estrazione

    acquabooks-0.1.5$ ./bin/acquabooks -x T,json

"T" sta per tutti, lultimo paramento è il formato di esportazione json|excel

    acquabooks-0.1.5$ ./bin/acquabooks -x E,eleuthera,excel

"E" estrae per editore, secondo parametro, cercato in "tag" o "edtore"

    acquabooks-0.1.5$ ./bin/acquabooks -x VE,clichy,json

"VE" come "E" ma estrae solo libri che hanno realizzato almeno una vendita

## Modalità azzera venduto

    acquabooks-0.1.5$ ./bin/acquabooks -z foo.json

- Nasce per trovare un modo gi gestire il post-regolazione conti con gli editori
- E' una modaltà speciale di import alimentato da un tracciato json di cui interessano solo i "barcode"
- Legge il libro indicizzato con il barcode dato e sottrae il "venduto" all'"arrivato"
- azzera il venduto e re-indicizza il record letto

## ### ALT ###

E' un'operazione delicata, si raccomanda il backup* prima di eseguirla

*:

    -x T,json

## Altre mobilità

- Modifica interattiva
- Modalità dettaglio

#####
Vedi l'help

    acquabooks-0.1.5$ ./bin/acquabooks -h

## How to

Censimento nuovi libri arrivati da nuovo fornitore

    acquabooks-0.1.5$ ./bin/acquabooks -i foo.json

(il tracciato va prparato a manella in genere a partire dall'excel con cui si prepara l'ordine)

Modifica di uno o piu dati di uno o più libri

    acquabooks-0.1.5$ ./bin/acquabooks -x T,json

estraggo tutti i libri (valutare usare una estrazione più restrittiva) e modifico i dati eventualmente elimando i libri che non ci interessano

    acquabooks-0.1.5$ ./bin/acquabooks -e T,foo.json

reimporto i dati in update

Rendicontazione dell'editore xxxx

    acquabooks-0.1.5$ ./bin/acquabooks -x E,xxxx,excel

ed editare l'estratto con LibreOffice

    acquabooks-0.1.5$ ./bin/acquabooks -z foo.json

dei libri di cui ho rendicontato e di cui è stato realizzato un venduto preparare una lista in json e azzerare il venduto

## !!! grazie !!!

### ..:: infos ::..

mario.incandenza@autistici.org

### ..:: codice sorgente ::..

https://github.com/lucaconte/acquabooks/