yellowfliag1/weave

Golang+Vue3 application starter, Simple but functional.

Weave

Simple but functional Go+Vue application starter, supported by gin, gorm, redis, postgres, vue, element-plus, websocket and much more.

Features

Server support features:

• Restful api, write by gin
• MVC structure
• Postgres storage, via gorm
• Swagger doc, support by swag
• Structured log, support by logrus
• Prometheus monitor
• PProf debug
• Graceful shutdown
• Authentication, support jwt
• Request rate limit, server level or user ip
• Redis cache

Frontend support features:

• Vue3 supported
• UI with element-plus
• Build with vite
• Charts integration, support by echarts
• WebShell supported
• Windi CSS

TODOs

• Redis cache
• Request rate limit
• Authentication
• WebSocket
• Trace
• UI
• WebShell
• Dark theme
• Mobile UI

Run

Run server

install dependencies

make postgres
make redis

run locally

make run

See http://localhost:8080

Test api

Register user

curl -XPOST http://localhost:8080/api/auth/user -d '{"name": "zhang3", "email": "zhang3@t.com","password": "123456"}'

Login, get jwt token

curl -XPOST http://localhost:8080/api/auth/token -d '{"name": "zhang3", "password": "123456"}'

Response as follows, set token in Authorization Header

{
  "code": 200,
  "msg": "success",
  "data": {
    "token": "xxx",
    "describe": "set token in Authorization Header, [Authorization: Bearer {token}]"
  }
}

Get users

token=xxx
curl -X 'GET' 'http://localhost:8080/api/v1/users' -H "Authorization: Bearer $token"

Container web shell

1. login in swagger http://localhost:8080/swagger/index.html#/auth/post_login
2. create container http://localhost:8080/swagger/index.html#/user/post_api_v1_users

{
  "cmd": [
    "top"
  ],
  "image": "alpine",
  "name": "myapp"
}

3. open cloudshell http://localhost:8080/api/v1/containers/{:containerid}/terminal

Run UI

cd web
npm i
npm run dev 

Explore in http://127.0.0.1:8081

Login page

Dashboard page

App page

Webshell page