Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/devs-group/liquiswiss
Liquidity planning
https://github.com/devs-group/liquiswiss
Last synced: about 1 month ago
JSON representation
Liquidity planning
- Host: GitHub
- URL: https://github.com/devs-group/liquiswiss
- Owner: devs-group
- License: agpl-3.0
- Created: 2024-12-19T22:51:28.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-21T19:57:17.000Z (about 2 months ago)
- Last Synced: 2024-12-21T20:18:29.979Z (about 2 months ago)
- Language: Go
- Size: 4.01 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LiquiSwiss
Liquidity Planning
- [Landing Page](https://liquiswiss.ch/)
- [Discord](https://discord.gg/7ckBNzskYh)
# Configuration
> We are planning to add [Mailpit](https://mailpit.axllent.org/) for local e-mail testing and replace fixer.io with a
> local mock
1. Copy the [.env.example](.env.example) into the same directory and name it `.env`
- Set your credentials for [MariaDB](https://hub.docker.com/_/mariadb)
2. Copy the [backend/.env.example](backend/.env.example) into the same directory and name it `.env`
- The `WEB_HOST` is set to http://localhost:3000 and works for local dev
- THE `JWT_KEY` can be anything for local development but make sure to set it for [production](#production)
- Set your credentials for [MariaDB](https://hub.docker.com/_/mariadb) and make sure they
match [.env.example](.env.example)
- Set your Token for [SendGrid](https://app.sendgrid.com/)
- This requires you to have an account with SendGrid
- Create an API key [here](https://app.sendgrid.com/settings/api_keys)
- You also need to have a [Dynamic Template](https://mc.sendgrid.com/dynamic-templates) and get the ID
- The template for LiquiSwiss looks like this:
- 
- The values to submit can be found in [this model](backend/pkg/models/mail.go)
- You can find the usage in the [SendgridService](backend/internal/service/sendgrid_service.go)
- Set your credentials for [Fixer](https://fixer.io/)
- This requires you to have an account with Fixer
- Copy the API key that you find in the [Dashboard](https://fixer.io/dashboard)
3. Copy the [fronted/.env.example](frontend/.env.example) into the same directory and name it `.env`
- The `NUXT_API_HOST` works fine for local dev but must be changed for production
## Production
For production make sure you define the proper values for your envs (no matter in which way you provide them)
- `WEB_HOST` - Reflects your Frontend URL (eg. https://yourdomain.com)
- `JWT_KEY` - Should be a long and secure password
- `NUXT_API_HOST` - Reflects your Backend URL (eg https://api.yourdomain.com)
# Frontend (Nuxt 3)
Look at the [Nuxt 3 documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.
> Make sure you are in the [frontend](frontend) directory for all the following actions
## Setup
```
npm install
```
## Development Server
```
npm run dev or npm run dev-host (to expose host and be able to connect from another device)
```
# Backend (Golang)
> Make sure you are in the [backend](backend) directory for all the following actions
## Setup
```
go get OR go mod tidy
```
## Development Server
1. Install [Air](https://github.com/cosmtrek/air): `go install github.com/cosmtrek/air@latest`
```
air
```
## Migrations
- Create Migration: `goose --dir internal/db/migrations create sql`
- Apply Migration: `goose --dir internal/db/migrations mysql liquiswiss:password@/liquiswiss up`
- Rollback Migration: `goose --dir internal/db/migrations mysql liquiswiss:password@/liquiswiss down`
- Or check out the [Makefile](backend/Makefile)
## Tests
> Make sure you are in the [backend](backend) directory
1. Install [Mockgen](https://github.com/uber-go/mock) with `go install go.uber.org/mock/mockgen@latest` to generate
mocks
- There are `go generate` commands already in the files so you can simply do `go generate ./...`
2. You can run all tests with `go test ./...`