gengitkan/README.md

# GenGitKan

## Démarrer avec les sources

### Dépendances

- [Go >= 1.13](https://golang.org/)

### Procédure

```bash
cd client && npm install # Installation des dépendances client
make watch  # Surveiller les modifications sur le sources et compiler/démarrer le serveur
```

Au premier lancement, le fichier de configuration doit être complété afin de d'utiliser l'instance Gitea ciblée comme fournisseur OAuth2.

Modifier le fichier `data/server.conf` de la manière suivante (la forge Cadoles est utilisée dans cet exemple):

```ini
Debug = false

[HTTP]
Address     = :3000
PublicDir   = ${GENGITKAN_HTTP_PUBDIR}

[Gitea]
BaseURL      = https://forge.cadoles.com
ClientID     = <ClientID>
ClientSecret = <ClientSecret>
RedirectURL = http://localhost:3000/callback
AuthURL = https://forge.cadoles.com/login/oauth/authorize
LogoutURL = https://forge.cadoles.com/user/logout
TokenURL = https://forge.cadoles.com/login/oauth/access_token
APIBaseURL = https://forge.cadoles.com/api
Scopes = api

[Data]

DBPath = ${GENGITKAN_DATA_DBPATH}
```

Les valeurs pour `<ClientID>` et `<ClientSecret>` sont à récupérer sur la page https://forge.cadoles.com/user/settings/applications, dans la section `Gérer les applications OAuth2`. 

Vous devrez créer une application et configurer l'URL de redirection pour qu'elle corresponde à la valeur `RedirectURL` de votre fichier de configuration afin de pouvoir utiliser votre instance locale de GenGitKan.

## Licence

[AGPL-3.0](./LICENSE)