cds-web/README.md

52 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

2022-10-09 00:15:25 +00:00
# Site CDS
## Structure du projet
* .env : fichier de configuration
2022-10-21 01:12:22 +00:00
* controllers : actions possibles par l'API REST
* docs : doc swagger (swagger -i)
* routes : configuration des routes
2022-10-09 00:15:25 +00:00
* views : fichiers html dynamiques
* dao : fichiers pour faire des requetes en BDD
2022-10-21 01:15:09 +00:00
* models : structures utilisées pour manipuler le contenu de la base de
données
2022-10-09 00:15:25 +00:00
## Lancement
2022-10-21 01:15:09 +00:00
### Frontend
Le frontend utilise **Rust** et **WASM**. Il vous faut Trunk en plus de Cargo
pour pouvoir compiler les fichiers Rust en WASM. Il faut en premier installer
les dépendances JS puis compiler les fichiers avec cargo puis Trunk.
```
cd front
npm install
cargo build
trunk build
```
JS est nécessaire pour une crate qui permet d'utiliser les propriétés d'une
bibliothèque JS.
2022-10-21 01:12:22 +00:00
### Backend
2022-10-21 01:15:09 +00:00
Il faut mettre en place une base de données
[MongoDB](https://www.mongodb.com/). Il est nécessaire d'avoir [une
application Discord](https://discord.com/developers/) et [une clé d'API
Steam](https://steamcommunity.com/dev). Configurez ensuite le fichier
`example.env` et renommez le en `.env`.
2022-10-09 00:15:25 +00:00
Lancez le serveur avec `go run main.go`.
2022-10-21 01:12:22 +00:00
### Documentation
Installer swager avec Go et lancer le. Vous pouvez démarrer le serveur et aller
2022-10-21 01:15:09 +00:00
sur le lien [de la documentation](localhost:8080/swagger) pour pouvoir la lire
en ligne.
2022-10-21 01:12:22 +00:00
```
go install github.com/swaggo/swag
swag init
```