Bine ai venit in repo-ul scrapeathon-ului CZL. Prima etapa a aplicatiei "Ce zice legea", un proiect Code for Romania care isi propune sa ofere urmarirea la zi a tuturor schimbarilor legislative din Romania.
Etapa consta in crearea unor mecanisme care sa preia informatii la un interval regulat din platformele institutiilor statului. Impreuna cu alinierea acestora in procesul legislativ putem prezenta informatiile necesare oricarui cetatean interesat de o anumita categorie de legi, sau mai multe.
Fiecare echipa este libera sa-si aleaga tehnologiile si approach-urile asupra scraper-ului. Dorim insa sa incurajam o aliniere a modelelor de date. Am creat un API valabil pe perioada evenimentului in care se poate face POST cu urmatoarele modele:
http://czl-api.code4.ro/api/publications/
{
"identifier": "lawproposal-first-document-name-slug-or-something", // un identificator unic, predictibil (repetabil), pereferabil human-readable
"title": "Proiectul de ordin al ministrului justiției pentru aprobarea Regulamentului privind organizarea și desfășurarea activităților și programelor educative, de asistență psihologică și asistență socială din locurile de deținere aflate în subordinea Aministrației Naționale a Penitenciarelor", // titlul actului legislativ propus
"type": "HG", // HG, OUG, LEGE, OG, OM
"institution": "justitie", // ID-ul platformei din care provine actul legislativ
"date": "2017-03-08", // ISO 8601
"description": "Cookie jelly-o sesame snaps donut sesame snaps sweet roll chocolate. Tootsie roll pie bonbon tart chocolate cake. Gummi bears gummies chupa chups ice cream croissant donut marzipan. Macaroon bear claw halvah carrot cake liquorice powder.",
"feedback_days": 12, // numarul zilelor disponibile pentru feedback
"contact": {"tel": "12345", "email": "feedback@example.org"}, // dictionar cu datale de contact. chei sugerate: "tel", "email", "addr"
"documents": [ // array de dictionare
{
"type": "anexa", // free text momentan
"url": "http://www.just.ro/wp-content/uploads/2017/02/Proiect.docx" // da, este un link catre un document oficial de la MJ
}
]
}POST-ul catre API va fi autentificat cu o cheie-token, trimisa cu un header HTTP Authorization. Cheia va primi ca prefix string-ul literal "Token", de care este separata printr-un spatiu:
Authorization: Token am-un-token-si-fac-ce-vreau-cu-el
Token-urile vor fi distribuite pe parcursul evenimentului. API-ul este hostat pe AWS, va rugam sa nu le distribuiti in afara echipei in care lucrati.
Institutiile de la care vom trage datele necesare dezvoltarii aplicatiei le gasesti in tabelul de mai jos si in endpoint-ul de aici. Iti recomandam sa-l folosesti, are cateva informatii in plus pentru mentinerea standardelor in date.
Am vrea sa avem o baza de date populata cu tool-uri care pot fi rulate regulat pentru a identifica ulterior statusul oricarei propuneri legislative.
- code review in echipa ta
- documentatie + notat exceptii
Orice intrebare are un raspuns la colegii cu stickere code4. Primesti si tu la finalul zilei.