V Team SparkRentals

スパークレンタルズプロジェクト

コンテンツ

• について
• ダウンロード
• 使用法
• ライセンスとツール

について

このプロジェクトは、ブレーキンゲ工科大学で Web プログラミングを学ぶ 4 人の学生によって作成されました。私たちは、スクーター会社向けのシステムを作成するという任務を与えられました。そこでは、顧客向けのモバイル対応 Web アプリ、管理用 Web インターフェイス、電動スクーター用のシミュレーション プログラム、自転車のインテリジェンス プログラムなどを作成することになりました。もう 1 つは、システム全体から情報を配布および取得し、データベースに情報を保存する Rest API です。

プロジェクトは以下によって作成されます。

• カスパー・フォーク / FalkenDev
• ジェームス・テイラー
• ジョエル・パーソン
• オスカー・イドバーグ

背景

「Svenska Elsparkcyklar AB」という会社は、スウェーデンの都市で電動スクーターのレンタルを管理するシステムを必要としています。同社は 3 つの異なる都市で事業を展開しており、新しいデータ システムのサポートによりさらに多くの都市に拡大する予定です。

データ システムは次の部分で構成されます。

• データベースに接続して自転車、充電ステーション、駐車ゾーン、自転車通行許可ゾーン、貸し出し/返却、自転車の回収を管理するバックエンドの Web ベースのソリューション。
• カスタム アプリケーションを接続できる REST API。
• 自転車、ステーション、顧客のステータスを確認できる管理 Web インターフェイス。
• 顧客がログインしてアカウント、融資履歴、支払いを表示できるようにするための Web インターフェイス。
• 顧客向けのモバイル対応 Web アプリにより、自転車の貸し出し/返却だけでなく、最後の旅行のステータスや旅行の履歴も確認できます。
• バイクのインテリジェンス、バイクを制御および監視するプログラム (オン、オフ、速度、制限速度、位置、整備/充電の必要性)。

さらに、システムの機能をテストおよび検証できるように、システム全体の動作をシミュレートするオプションが含まれています。

このプロジェクトのリポジトリ

• モバイルアプリ
• 管理者ダッシュボード
• ウェッブクライアント
• スクーターシミュレーター
• REST API
• データジェネレータ

ダウンロード

必要な環境変数

.env:

 #---------------------------------- General ----------------------------------
# -> Configs
API_TOKEN=["API TOKENS"]
JWT_SECRET="JWT Sercret Code"
# Database Location (MongoDB)
DBURI="mongodb://mongodb_container:27017"

#---------------------------------- Dummy Generator ----------------------------------
# -> Configs
CREATE_USER=100
CREATE_PREPAID=100

#---------------------------------- Scooter ----------------------------------
# -> Configs
GEOAPIFY_KEY="Geoapify API Key"
NUMBER_OF_SCOOTERS=50
UPDATE_FREQUENCY_MILLISECONDS=1000
BATTERY_DEPLETION_RATE=0.0005
SIMULATION_CITY=Karlskrona
SIMULATION_ROUTE_PADDING=10

#"DROP ZONE" of scooters
#KARLSKRONA
SIMULATION_MAX_LAT="56.166217"
SIMULATION_MIN_LAT="56.158594"
SIMULATION_MAX_LON="15.593868"
SIMULATION_MIN_LON="15.583096"

#SIMULATION
SIMULATION_EMAIL="The Simulator Account Email"
SIMULATION_PASSWORD="Password to the Simulator Account"

#-------------- REST API URLS ------------------------------
API_URL=http://URL:8393/v1

#---------------------------------- REST API ----------------------------------
# Localhost URL
GOOGLE_CALLBACK_URL="http://"URL-TO-REST-API":8393/v1/auth/google/callback"
GOOGLE_SUCCESS_URL="http://"URL-TO-WEBB-CLIENT":3000/login/google/success"
GOOGLE_FAILURE_URL="http://"URL-TO-WEBB-CLIENT":3000/login/google/failure"

# -> Configs
REST_API_PORT=8393
GOOGLE_CLIENT_ID="Google Client ID"
GOOGLE_CLIENT_SECRET="Google Client Secret Code"
COOKIE_KEY="Cookie Secret Code"
CREATE_SINGLE_PREPAID=2
API_CLUSTER=false

#---------------------------------- REACT ----------------------------------
#SparkRentals
REACT_APP_API_URL="http://"URL-TO-REST-API":8393/v1"

# -> Configs
REACT_APP_REST_API_KEY="React Admin API KEY"
REACT_APP_MAP_UPDATE_INTERVAL_BOOLEAN=1
REACT_APP_MAP_UPDATE_INTERVAL=1000
PORT=3000

#---------------------------------- REACT NATIVE ----------------------------------
API_KEY="Mobile API KEY"

システム全体を Docker 上で実行する

• SparkRentals マップをフォーク/ダウンロードする

• .env ファイルを作成し、環境変数を挿入し、入力を変更します。

ドッカーの構成

使用法

モバイル アプリモバイル アプリを使用するには、qr コードをスキャンするか、モバイルにリンクを入力する必要があります (expo アプリが必要です)。モバイル アプリを実行すると、ターミナルでリンクが表示されます。

管理者ダッシュボード 管理者ダッシュボードを使用するには: http://localhost:3000 それ以外の場合は、docker compose ファイルのポートを確認してください。

スクーター シミュレータースクーター シミュレーターを使用するには、スクーター シミュレーターの手順に従う必要があります。

REST API REST API を使用するには: http://localhost:8393/v1/

docker compose の実行中にデータ ジェネレーターが自動ロードされます。データ ジェネレーターの手順に従って再度実行できます。

Web クライアントWeb クライアントを使用するには: http://localhost:3000 それ以外の場合は、docker compose ファイルのポートを確認してください。

ライセンスとツール

精査者

モバイルアプリ

管理者ダッシュボード

スクーターシミュレーター

REST API

ウェブクライアント