Development

Documentation/it_IT/jobeet/1_2/02 (diff)

You must first sign up to be able to contribute.

Changes from Version 1 of Documentation/it_IT/jobeet/1_2/02

Show
Ignore:
Author:
ringhio (IP: 80.16.201.174)
Timestamp:
12/03/08 10:35:49 (9 years ago)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/it_IT/jobeet/1_2/02

    v0 v1  
     1Giorno 2: Il progetto 
     2================== 
     3 
     4Precedentemente su Jobeet 
     5-------------------- 
     6 
     7Non abbiamo scritto ancora una sola linea di codice, ma [ieri] (http://www.symfony-project.org/jobeet/1_2/en/01), 
     8abbiamo impostato l'ambiente di sviluppo, creato una struttura vuota di progeto e  
     9ci siamo assicurati di partire con buone impostazioni di default riguardanti la sicurezza. 
     10Se avete seguito tutti i passaggi state guardando il monitor estasiati visto che  
     11vi mostra la bellissima pagina di default che symfony propone per le nuove applicazioni. 
     12 
     13![Congratulation page](http://www.symfony-project.org/images/jobeet/1_2/01/congratulations.png) 
     14 
     15Ma volete di più. Volete imparare tutti i minimi dettagi sullo sviluppo delle applicazioni 
     16con symfony. Quindi riprendiamo il nostro viaggio nel "symfony development 
     17nirvana." 
     18 
     19Oggi impegneremo il nostro tempo per descrivere i requisiti del progetto 
     20Jobeet con alcuni semplici mockup. 
     21 
     22Impostazione del progetto 
     23----------------- 
     24 
     25Tutti parlano di crisi in questo periodo. La disoccupazione è nuovamente in aumento. 
     26 
     27Lo so, gli sviluppatori symfony non sono molto preoccupati, ecco perchè volete 
     28imparare symfony prima di tutto. Ricordate però che è abbastanza difficle trovare 
     29buoni sviluppatori per symfony. 
     30 
     31Dove potete trovare uno sviluppatore symfony? Dove potete pubblicizzare le vostre skill 
     32su symffony? 
     33 
     34Avete bisogno di trovare una buona **bacheca per gli annunci di lavoro**. Avete detto Monster? 
     35Pensate meglio. Quello di cui avete bisogno è una bacheca molto specifica. Una dove 
     36trovare le persone migliori, gli esperti. Una bacheca dove sia semplice, veloce e divertente 
     37cercare un lavoro oppure offrirlo. 
     38 
     39Non cercate più. Jobeet è quello che vi serve. Jobeet è un software Open-Source 
     40che fa solamente una cosa, ma la fa bene. E' facile da usare, customizzare, ampliare e 
     41integrare nei vostri siti. Supporta diverse lingue di default e certamente usa le ultime 
     42tecnologie in fatto di Web 2.0 per rendere migliore la user experience dell'utente. 
     43Inoltre mette a disposizione feed e API per interagire con essa. 
     44 
     45Esiste già? Come utente potreste trovare diverse bacheche per gli annunci di  
     46lavoro simili a Jobeet su Internet. Ma provate a trovarne una Open-Source e ricca  
     47di funzionalità come quella che proponiamo qui. 
     48 
     49Chi ha detto che basterebbero meno di 24 ore per svilupparla con symfony? 
     50Bene, sarà meglio iniziare subito! 
     51 
     52Le User Stories del progetto 
     53------------------------ 
     54 
     55Prima di tuffarsi nel codice a capofitto descriviamo un po' di più il progetto. 
     56La sezione seguente descrive le funzionalità che vogliamo implementare nella prima 
     57versione/iterazione del progetto con alcune semplici storie. 
     58 
     59Il sito Jobeet ha quattro tipi di utenti: 
     60 
     61 * **admin**: Gestisce il sito ed ha tutti i poteri 
     62 * **user**: Visita il sito per cercare o offrire un lavoro 
     63 * **poster**: Propone un lavoro 
     64 * **affiliate**: Ri-pubblica alcuni lavori sul suo sito web 
     65 
     66Il progetto ha due applicazioni: il **frontend** (storie da F1 a F7, di seguito) 
     67dove l'utente interagisce con il sito, ed il **backend** (storie da B1 a B3) dove 
     68gli amministratori possono gestire il sito stesso. 
     69 
     70Il backend è riservato e richiede delle credenziali per l'accesso. 
     71 
     72### Storia F1: sulla homepage, l'utente vede gli ultimi lavori disponibili 
     73 
     74Quando un utente arriva sul sito di Jobeet vede una lista di lavori disponibili. 
     75I lavori sono ordinati per categoria e per data di pubblicazione (i più recenti prima). 
     76Per ogni lavoro solo il luogo, la posizione aperta e la società sono visualizzate. 
     77 
     78Per ogni categoria la lista mostra solamente i primi 10 lavori ed un link permette 
     79di visualizzare tutti i lavori per una data categoria (storia F3). 
     80 
     81Sulla homepage l'utente può restringere la lista dei lavori (storia F2) o inserire una 
     82nuova opportunità di lavoro (storia F5). 
     83 
     84![Homepage Mockup](http://www.symfony-project.org/images/jobeet/1_2/02/mockup_homepage.png) 
     85 
     86### Storia F2: un utente può richiedere tutti i lavori di una data categoria 
     87 
     88Quando un utente clicca su una categoria o su un link "altri lavori" sulla homepage 
     89vedrà tutti gli annunci per quella categoria ordinati per data.. 
     90 
     91La lista è dotata di paginazione con 20 offerte per pagina. 
     92 
     93![The Category Page](http://www.symfony-project.org/images/jobeet/1_2/02/mockup_category.png) 
     94 
     95### Storia F3: un utente restringe la ricerca con alcune parole chiave 
     96 
     97L'utente può utilizzare alcune parole chiave per migliorare la propria ricerca. Queste 
     98parole chiave possono essere parole presenti nel luogo, nella posizione aperta, nella categoria 
     99o nella società. 
     100 
     101### Storia F4: un utente clicca su un'offerta per avere informazioni dettagliate 
     102 
     103L'utente può selezionare un lavoro dalla lista per vedere i dettagli su quell'offerta. 
     104 
     105![The Job Page](http://www.symfony-project.org/images/jobeet/1_2/02/mockup_job.png) 
     106 
     107### Storia F5: un utente inserisce un'offerta di lavoro 
     108 
     109Un utente può inserire un'offerta di lavoro. Un'offerta è composta da molte informazioni: 
     110 
     111  * Società 
     112  * Tipo (full-time, part-time, freelance) 
     113  * Logo (opzionale) 
     114  * URL (opzionale) 
     115  * Posizione aperta 
     116  * Luogo 
     117  * Categoria (l'utente seleziona da una lista di categorie possibili) 
     118  * Descrizione del lavoro (URL e email vengono linkate automaticamente) 
     119  * Come proporsi (URL e email vengono linkate automaticamente) 
     120  * Pubblico (indica se l'inserzione può essere pubblicata sui siti affiliati o meno) 
     121  * Email (email di chi ha inserito l'offerta) 
     122 
     123Non è necessario creare un account per inserire un'offerta di lavoro. 
     124 
     125Il processo è semplice con due soli step: il primo è quello dove l'utente 
     126compila il form con tutte le informazioni necessarie per descrivere il lavoro,  
     127il secondo è rappresentato dal controllo dei dati inseriti nella preview della 
     128pagina finale. 
     129 
     130Anche se l'utente non ha un account, un'offerta può essere modificata in seguito grazie 
     131ad un URL specifico (protetto da un token dato all'utente quando l'inserzione viene creata). 
     132 
     133Ogni annuncio di lavoro rimane online per 30 giorni (questo parametro è configurabile 
     134dagli admin - vedi storia B2). Un utente può tornare per riattivare o estendere la  
     135validità di un lavoro per ulteriori 30 giorni solo quando l'inserizione starà per scadere 
     136in meno di 5 giorni. 
     137 
     138![The Job Creation Page](http://www.symfony-project.org/images/jobeet/1_2/02/mockup_post.png) 
     139 
     140### Storia F6: un utente richiede l'affiliazione 
     141 
     142Un utente deve far richiesta per l'affiliazione ed essere autorizzato per usare 
     143le API di Jobeet. Per proporsi deve fornire le seguenti informazioni: 
     144 
     145  * Nome 
     146  * Email 
     147  * URL del sito web 
     148 
     149L'account dell'affiliato deve essere attivato da un admin (storia B3). 
     150Una volta che sarà stato attivato, l'affiliato riceverà via mail un token da usare  
     151con le API. 
     152 
     153### Storia F7: un affiliato recupera l'attuale lista di inserzioni attive 
     154 
     155Un affiliato può recuperare l'attuale lista di offerte di lavoro utilizzando 
     156le API con il proprio token. La lista può essere restituita in vari formati: 
     157XML, JSON o YAML. 
     158 
     159La lista contiene solamente le informazioni pubbliche di ogni lavoro. 
     160 
     161L'affiliato può inoltre limitare il numero di lavori da restituire e raffinare 
     162la propria richiesta specificando una categoria. 
     163 
     164### Storia B1: un admin configura il sito 
     165 
     166Un admin può editare le categorie disponibile sul sito. 
     167 
     168Inoltre può anche cambiare alcune impostazioni: 
     169 
     170  * Numero massimo di offerte di lavoro visualizzate sulla homepage 
     171  * Lingua del sito 
     172  * Numero di giorni per cui un'offerta è attiva 
     173 
     174### Storia B2: un admin gestisce un'inserzione 
     175 
     176Un admin può editare o cancellare ogni offerta di lavoro inserita. 
     177 
     178### Storia B3: un admin gestisce gli affiliati 
     179 
     180L'admin può creare o modificare gli affiliati. E' responsabile per l'attivazione e  
     181la disattivazione degli affiliati. 
     182 
     183Quando l'admin attiva un nuovo affiliato il sistema crea un token univoco 
     184che dovrà essere utilizzato dall'affiliato. 
     185 
     186A domani 
     187---------------- 
     188 
     189Come per ogni progetto web non inizierete mai a scrivere codice dal primo giorno. 
     190Avrete bisogno di raccogliere i requisiti e lavorare sulla progettazione di qualche mockup. 
     191E' quello che abbiamo fatto oggi. 
     192 
     193Come ieri, il codice di oggi è stato reso pubblico sull'SVN repository di Jobeet. 
     194Checkout `release_day_02` tag: 
     195 
     196    $ svn co http://svn.jobeet.org/tags/release_day_02/ jobeet/