sharee.bike-App/TINKLib/Model/Connector/Command/ICommand.cs

159 lines
6.3 KiB
C#
Raw Normal View History

2021-05-13 20:03:07 +02:00
using System;
using System.Threading.Tasks;
2021-06-26 20:57:55 +02:00
using TINK.Repository.Request;
2021-05-13 20:03:07 +02:00
using TINK.Model.User.Account;
2021-06-26 20:57:55 +02:00
using TINK.Model.Device;
2021-08-01 17:24:15 +02:00
using System.Collections.Generic;
2021-05-13 20:03:07 +02:00
namespace TINK.Model.Connector
{
public interface ICommand
{
/// <summary> Is raised whenever login state has changed.</summary>
event LoginStateChangedEventHandler LoginStateChanged;
/// <summary>
/// Logs user in.
/// If log in succeeds either and session might be updated if it was no more valid (logged in by an different device).
/// If log in fails (password modified) session cookie is set to empty.
/// If communication fails an exception is thrown.
/// </summary>
Task<IAccount> DoLogin(string p_strMail, string p_strPassword, string p_strDeviceId);
/// <summary> Logs user out. </summary>
Task DoLogout();
/// <summary> Request to reserve a bike.</summary>
2022-04-10 17:38:34 +02:00
/// <param name="bike">Bike to book.</param>
Task DoReserve(Bikes.Bike.BC.IBikeInfoMutable bike);
2021-05-13 20:03:07 +02:00
/// <summary> Request to cancel a reservation.</summary>
2022-04-10 17:38:34 +02:00
/// <param name="bike">Bike to book.</param>
Task DoCancelReservation(Bikes.Bike.BC.IBikeInfoMutable bike);
2021-05-13 20:03:07 +02:00
/// <summary> Get authentication keys to connect to lock.</summary>
/// <param name="bike">Bike to book.</param>
Task CalculateAuthKeys(Bikes.Bike.BluetoothLock.IBikeInfoMutable bike);
2022-04-10 17:38:34 +02:00
/// <summary> Notifies COPRI about start of returning sequence. </summary>
/// <remarks> Operator specific call.</remarks>
/// <param name="bike">Bike to return.</param>
/// <returns>Response on notification about start of returning sequence.</returns>
2022-04-25 22:15:15 +02:00
Task StartReturningBike(Bikes.Bike.BC.IBikeInfoMutable bike);
2022-04-10 17:38:34 +02:00
2021-05-13 20:03:07 +02:00
/// <summary> Updates COPRI lock state for a booked bike. </summary>
2022-04-10 17:38:34 +02:00
/// <param name="bike">Bike to update locking state for.</param>
2021-05-13 20:03:07 +02:00
/// <param name="location">Geolocation of lock when returning bike.</param>
/// <returns>Response on updating locking state.</returns>
Task UpdateLockingStateAsync(Bikes.Bike.BluetoothLock.IBikeInfoMutable bike, LocationDto location = null);
/// <summary> Request to book a bike.</summary>
/// <param name="bike">Bike to book.</param>
2022-04-25 22:15:15 +02:00
Task DoBook(Bikes.Bike.BC.IBikeInfoMutable bike);
/// <summary> Request to book a bike and open its lock.</summary>
/// <param name="bike">Bike to book and to open lock for.</param>
Task BookAndOpenAync(Bikes.Bike.CopriLock.IBikeInfoMutable bike);
/// <summary> Request to open lock.</summary>
/// <param name="bike">Bike for which lock has to be opened.</param>
Task OpenLockAsync(Bikes.Bike.CopriLock.IBikeInfoMutable bike);
/// <summary> Request to close lock.</summary>
/// <param name="bike">Bike for which lock has to be closed.</param>
Task CloseLockAsync(Bikes.Bike.CopriLock.IBikeInfoMutable bike);
2021-05-13 20:03:07 +02:00
/// <summary> Request to return a bike.</summary>
/// <param name="bike">Bike to return.</param>
2021-06-26 20:57:55 +02:00
/// <param name="location">Geolocation of lock when returning bike.</param>
/// <param name="smartDevice">Provides info about hard and software.</param>
2022-04-25 22:15:15 +02:00
Task<BookingFinishedModel> DoReturn(Bikes.Bike.BC.IBikeInfoMutable bike, LocationDto geolocation = null, ISmartDevice smartDevice = null);
/// <summary> Request to return bike and close the lock.</summary>
/// <param name="bike">Bike to return.</param>
/// <param name="smartDevice">Provides info about hard and software.</param>
Task<BookingFinishedModel> ReturnAndCloseAsync(Bikes.Bike.CopriLock.IBikeInfoMutable bike, ISmartDevice smartDevice = null);
2021-05-13 20:03:07 +02:00
/// <summary> True if connector has access to copri server, false if cached values are used. </summary>
bool IsConnected { get; }
/// <summary> True if user is logged in false if not. </summary>
string SessionCookie { get; }
Task DoSubmitFeedback(IUserFeedback userFeedback, Uri opertorUri);
2021-08-01 17:24:15 +02:00
/// <summary> Submits mini survey to copri server. </summary>
/// <param name="answers">Collection of answers.</param>
Task DoSubmitMiniSurvey(IDictionary<string, string> answers);
2021-06-26 20:57:55 +02:00
#if USCSHARP9
2021-05-13 20:03:07 +02:00
/// <summary>
/// Feedback given by user when returning bike.
/// </summary>
public interface IUserFeedback
{
2021-06-26 20:57:55 +02:00
/// <summary> Id of the bike to which the feedback is related to.</summary>
string BikeId { get; }
2021-05-13 20:03:07 +02:00
/// <summary>
/// Holds whether bike is broken or not.
/// </summary>
bool IsBikeBroken { get; }
/// <summary>
/// Holds either
/// - general feedback
/// - error description of broken bike
/// or both.
/// </summary>
string Message { get; }
}
2021-06-26 20:57:55 +02:00
#endif
2021-05-13 20:03:07 +02:00
}
/// <summary>Defines delegate to be raised whenever login state changes.</summary>
2022-04-10 17:38:34 +02:00
/// <param name="eventArgs">Holds session cookie and mail address if user logged in successfully.</param>
public delegate void LoginStateChangedEventHandler(object sender, LoginStateChangedEventArgs eventArgs);
2021-05-13 20:03:07 +02:00
2021-06-26 20:57:55 +02:00
#if !USCSHARP9
/// <summary>
/// Feedback given by user when returning bike.
/// </summary>
public interface IUserFeedback
{
/// <summary> Id of the bike to which the feedback is related to.</summary>
string BikeId { get; }
/// <summary>
/// Holds whether bike is broken or not.
/// </summary>
bool IsBikeBroken { get; }
/// <summary>
/// Holds either
/// - general feedback
/// - error description of broken bike
/// or both.
/// </summary>
string Message { get; }
}
#endif
2021-05-13 20:03:07 +02:00
/// <summary> Event arguments to notify about changes of logged in state.</summary>
public class LoginStateChangedEventArgs : EventArgs
{
public LoginStateChangedEventArgs() : this(string.Empty, string.Empty)
{ }
2022-04-10 17:38:34 +02:00
public LoginStateChangedEventArgs(string sessionCookie, string mail)
2021-05-13 20:03:07 +02:00
{
2022-04-10 17:38:34 +02:00
SessionCookie = sessionCookie;
Mail = mail;
2021-05-13 20:03:07 +02:00
}
public string SessionCookie { get; }
public string Mail { get; }
}
}