aziily / bs_design_2023_autumn

The project of ZJU BS design in autumn 2023

ZJU B/S Design 2023 autumn

Summary

This is the project for the assignment of ZJU BS Design in 2023 autumn-winter term

Quick Start

Docker

# pull the image
docker pull azily/bs_design
# run one container
docker run -dit -p 15000:5000 -p 19528:9528 --name BS azily/bs_design:latest /bin/sh /start.sh

After waiting for about 15s for the container initializtion, then the server can be used on localhost:19528.

Also, the API documentary will on localhost:15000/apidocs

P.S.: remember to use ports are not in usage

Local

1. Run env.sh to prepare environment for all service

2. Different serivce

   1. Backend: this is the backend for console

      cd backend
      . .venv/bin/activate
      .venv/bin/python app.py

   2. Frontend: this is the frontend for console

      cd frontend
      npm run dev

   3. Server: this is the mqtt server

      cd server
      . .venv/bin/activate
      .venv/bin/python server.py
      
      # if need mock, run below
      .venv/bin/python mock/sensor.py
      .venv/bin/python mock/actuator.py

3. By default, backend is running on :5000, frontend is running on :9528, server is depending on broker.emqx.io:1883

4. Use localhost:9528 to see the panel

Organization

• assets - assets for the project
• backend - backend code for console, using python with frame flask
• frontend- frontend code for console, using vue2 with frame vue-element-admin
• server - server code for mqtt, using python

Inference

• Frontend
  • vue-element-admin (panjiachen.github.io)
  • Element - A Desktop UI Toolkit for Web
  • 组件 | vue-amap (guyixi.cn)
  • 概述-地图 JS API | 高德地图API (amap.com)
• Backend
  • Flask 中文网 (github.net.cn)
    • Flask-SQLAlchemy — Flask-SQLAlchemy Documentation (3.1.x) (palletsprojects.com)
    • Flask-RESTful — Flask-RESTful 0.3.10 documentation
    • Flask-JWT-Extended’s Documentation — flask-jwt-extended 4.5.3 documentation
• Server
  • paho-mqtt · PyPI
  • The Free Global Public MQTT Broker | Try Now | EMQ (emqx.com)

P.S.

Th backend api doc can be seen in localhost:5000/apidocs

The init data script is in backend/database/__init__.py, if you do not want to use the init data, comment them. Remember there need at least a admiin user, or you may not use all function.

bs_design_2023_autumn's Issues

About creating the database and the tables

Is there a separate file like create.sql in this project? Or the job is done by backend/database/models.py? If so, how?

When I was trying to replicate this project on my local machine, I stumbled through running backend and frontend as instructed. When it comes to the mqtt server, it gave errors like

pymysql.err.OperationalError: (1049, "Unknown database 'bs_iot_db'")

(bs_iot_db is the name i chose for the database, I have edited it accordingly in two config.yaml files)

I suppose it's because the database and the tables have not been created as expected (so, obviously the backend and frontend weren't functioning properly either).

I wonder which part of this project is responsible for creating the database, so that I can work on it from that point.