Differenze tra le versioni di "IoGateway"

Da NoiOpen.
Vai alla navigazioneVai alla ricerca
 
(26 versioni intermedie di 3 utenti non mostrate)
Riga 1: Riga 1:
[[Category:IoGateway]]
+
[[Category:IO-Gateway]]
  
In questa pagina ci sono informazioni per lo sviluppo di IoGateway.
+
Informazioni per lo sviluppo di IO-Gateway.  
  
 
== Cosa è? ==  
 
== Cosa è? ==  
  
IO-Gateway è un server per l'invio di messaggi ai cittadini italiani usando l'[https://io.italia.it/ app IO], l'app dei servizi pubblici italiani.
+
IO-Gateway è un server per l'invio di messaggi ai cittadini italiani usando l'[https://io.italia.it/ '''app IO'''], l'app dei servizi pubblici italiani.
  
Si tratta di un server a nodo singolo, progettato per l'uso periferico e decentralizzato, che può essere installato anche in workstation o server interni ai datacenter delle pubbliche amministrazioni.  
+
È ottimizzato per raccogliere dati da varie fonti, tramite plugin detti connettori, ed è estendibile con nuovi connettori che possono essere sviluppati da terze parti.
  
È ottimizzato per raccogliere dati da varie fonti, tramite plugin detti connettori, ed è estendibile con nuovi connettore che possono essere sviluppati da terze parti.
+
Il server è una iniziativa di [https://www.pagopa.gov.it/ PagoPA spa], sviluppato come progetto Open Source e gestito dall'[https://noiopen.it Associazione NoiOpen]
  
Il server è un progetto Open Source, sponsorizzato da [https://www.pagopa.gov.it/ PagoPA spa] e gestito dall'[https://noiopen.it Associazione NoiOpen]
+
== Elenco Specifiche ==
 +
 
 +
Questa è la lista dei documenti di specifica da scrivere prima di implementare una feature
 +
 
 +
* [[IoGatewayValidazioneForm|Validazione Form]]
 +
* [[IoGatewayDockerCompose|Docker Compose]]
 +
* [[IoGatewayGestioneMessaggi|Gestione Messaggi]]
 +
 
 +
Se vuoi aggiungere una tua specifica, edita questa sezione, aggiungi un nuovo elemento alla lista di specifiche, salva  e clicca sul link per creare la pagina (è un wiki! Funzionano tutti così....).
  
 
== Sei uno sviluppatore e vuoi collaborare al progetto? ==
 
== Sei uno sviluppatore e vuoi collaborare al progetto? ==
  
1. Per prima cosa consulta [[IoGatewayProject|questa pagina]] per informazioni su cosa c`è da fare. Aggiungi pure le tue proposte e i tuoi progetti nel [[IoGatewayBacklog|Backlog]] creandoti anche pagine di dettaglio se necessario.
+
1. Prima di cominciare a lavorare, unisciti alla community e discuti cosa vuoi fare nel [https://noiopen.discourse.group/c/progetti/iogateway/18 '''forum'''] di NoiOpen, categoria IO-Gateway.
 
 
2. Prima di cominciare a lavorare, discuti nel forum cosa vuoi fare [https://noiopen.discourse.group/c/progetti/iogateway/18 Categoria IoGateway nel forum di NoiOpen].
 
  
3. Una volta che hai concordato un task, assicurati che [https://github.com/noiopen/io-gateway/issues ci sia una issue qui] relativa al task che stai facendo e che ti venga assegnato.  
+
2. Consulta la pagina [[IoGatewayTODO|'''TODO''']] per informazioni su cosa c`è da fare. Aggiungi pure le tue proposte e i tuoi progetti nel [[IoGatewayBacklog|'''backlog''']] creandoti anche pagine di dettaglio se necessario.
  
4. [https://docs.github.com/en/github/getting-started-with-github/fork-a-repo Forka] questo [https://github.com/noiopen/io-gateway repository], e fai pure il tuo task.
+
3. Una volta che hai individuato un task, assicurati che [https://github.com/pagopa/io-gateway/projects '''ci sia una card'''] relativa al task che stai facendo nei progetti, e fattela assegnare dal [https://linkedin.com/in/msciab project manager] attuale.  
  
5. Quando hai finito il lavoro crea una [https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests pull request], e nei commenti del codice aggiungi ''closes #xx'' dove ''xx'' è l'id della issue che ti è stata assegnata.  
+
4. Fai un [https://docs.github.com/en/github/getting-started-with-github/fork-a-repo  '''fork''' ] di [https://github.com/pagopa/io-gateway '''questo repository'''], e fai pure il tuo task.  
  
 +
5. Quando hai finito il lavoro crea una [https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests '''pull request'''], e nei commenti del codice aggiungi ''closes #xx'' dove ''xx'' è l'id della issue che ti è stata assegnata.
  
=== Come Aiutarci ===
+
== Come Aiutarci a contenere il caos ==
  
Per evitare il caos, le informazioni vanno messe al posto giusto.  
+
Il tempo è poco per tutti, e non trovare le informazioni è una perdita di tempo. Aiutaci mettendo le informazioni nel posto giusto.  
  
* Il posto giusto per i bug è lo issue tracker dei '''pagopa/io-gateway'''
+
* Segnala i bug nello issue tracker [https://github.com/pagopa/io-gateway/issues '''pagopa/io-gateway''']. Se trovi un baco e non apri subito una issue, probabilmente non verrà corretto perchè nessuno lo sa; se lo metti nello issue tracker verrà certamente preso in considerazione (sperabilmente il più presto possibile).
* Il posto giusto per aggiungere idee, proposte e progetti è il '''wiki'''
 
* Il posto giusto per discussioni è il '''forum'''.  
 
* Il posto giusto per task e cose da fare è lo issue tracker di '''noiopen/io-gateway'''
 
  
Per favore:
+
* Prima di metterti al lavoro, discuti nel [https://noiopen.discourse.group/c/progetti/iogateway/18 forum] quello che vuoi fare in modo da evitare sovrapposizioni, e poi segnala a cosa stai lavorando con una card nei [https://github.com/pagopa/io-gateway/projects progetti]
  
* invece di discutere nello issue tracker, usa il forum
+
* Il posto giusto per aggiungere idee, proposte e progetti è questo wiki. Non lasciare informazioni rilevanti nel forum, dove è difficile reperirle, riportale nel wiki.
* la documentazione non va nel forum, ci sta il wiki per questo
 
* se iniziare a lavorare senza aver aperto una issue, nessuno saprà cosa stai facendo
 
* se trovi un baco e no apri subito una issue, non verrà corretto
 

Versione attuale delle 11:49, 12 dic 2020


Informazioni per lo sviluppo di IO-Gateway.

Cosa è?

IO-Gateway è un server per l'invio di messaggi ai cittadini italiani usando l'app IO, l'app dei servizi pubblici italiani.

È ottimizzato per raccogliere dati da varie fonti, tramite plugin detti connettori, ed è estendibile con nuovi connettori che possono essere sviluppati da terze parti.

Il server è una iniziativa di PagoPA spa, sviluppato come progetto Open Source e gestito dall'Associazione NoiOpen

Elenco Specifiche

Questa è la lista dei documenti di specifica da scrivere prima di implementare una feature

Se vuoi aggiungere una tua specifica, edita questa sezione, aggiungi un nuovo elemento alla lista di specifiche, salva e clicca sul link per creare la pagina (è un wiki! Funzionano tutti così....).

Sei uno sviluppatore e vuoi collaborare al progetto?

1. Prima di cominciare a lavorare, unisciti alla community e discuti cosa vuoi fare nel forum di NoiOpen, categoria IO-Gateway.

2. Consulta la pagina TODO per informazioni su cosa c`è da fare. Aggiungi pure le tue proposte e i tuoi progetti nel backlog creandoti anche pagine di dettaglio se necessario.

3. Una volta che hai individuato un task, assicurati che ci sia una card relativa al task che stai facendo nei progetti, e fattela assegnare dal project manager attuale.

4. Fai un fork di questo repository, e fai pure il tuo task.

5. Quando hai finito il lavoro crea una pull request, e nei commenti del codice aggiungi closes #xx dove xx è l'id della issue che ti è stata assegnata.

Come Aiutarci a contenere il caos

Il tempo è poco per tutti, e non trovare le informazioni è una perdita di tempo. Aiutaci mettendo le informazioni nel posto giusto.

  • Segnala i bug nello issue tracker pagopa/io-gateway. Se trovi un baco e non apri subito una issue, probabilmente non verrà corretto perchè nessuno lo sa; se lo metti nello issue tracker verrà certamente preso in considerazione (sperabilmente il più presto possibile).
  • Prima di metterti al lavoro, discuti nel forum quello che vuoi fare in modo da evitare sovrapposizioni, e poi segnala a cosa stai lavorando con una card nei progetti
  • Il posto giusto per aggiungere idee, proposte e progetti è questo wiki. Non lasciare informazioni rilevanti nel forum, dove è difficile reperirle, riportale nel wiki.