PrP-11 – blog.fossasia.org

How webclient Settings are Implemented in SUSI.AI Accounts

Post author:PrP-11
Post published:August 21, 2018
Post category:API FOSSASIA GSoC SUSI.AI
Post comments:0 Comments

The goal of accounts.susi is to implement all settings from different clients at a single place where user can change their android, iOS or webclient settings altogether and changes should be implemented directly on the susi server and hence the respective clients. This post focuses on how webclient settings are implemented on accounts.susi. SUSI.AI follows the accounting model across all clients and every settings of a user are stores at a single place in the accounting model itself. These are stored in a json object format and can be fetched directly from the ListUserSettings.json endpoint of the server.

Implementing System Logs in SUSI.AI Admin Panel

Post author:PrP-11
Post published:August 21, 2018
Post category:API FOSSASIA GSoC SUSI.AI
Post comments:0 Comments

The admin panel of SUSI.AI provides a lot of features required by system maintainers and admins to administer and maintain various activities of SUSI. Therefore system logs have been implemented on the admin panel so that admins can check whether SUSI server is working fine or throwing some errors. In this blog we will discuss about how logs are implemented on server and accounts.

Implementing API keys on SUSI.AI server

Post author:PrP-11
Post published:August 21, 2018
Post category:API FOSSASIA GSoC SUSI.AI
Post comments:0 Comments

The clients of SUSI.AI need config keys to work with some APIs like captcha, maps and blog and these keys are stored in the server of SUSI and the clients fetch them using API calls to the server. The admins can add or delete api keys from the server using the

/aaa/apiKeys.json

API. This API stores the API keys in a json format in the apiKeys.json file in the system_keys_dir directory which is in the data directory on the susi server.

For the clients to fetch these API keys and use them in their respective APIs, they need to use

Implementing Search User Feature for Admins

Post author:PrP-11
Post published:August 21, 2018
Post category:API FOSSASIA GSoC SUSI.AI
Post comments:0 Comments

The users tab of admin panel of SUSI.AI provides a list of all users registered on SUSI. This helps admins to get an overview of users and also provides the admins option like change user roles and delete accounts. The list of users is displayed in a table which also uses pagination to handle larger number of users. But to find a particular user can be a difficult task if the user base is large. Therefore a feature to search for users by their email has been implement which searches for users on SUSI server and then sends the searched users to the client. In this post we will discuss both about the server and client side implementation of this feature.

Implementation of Delete Skill Feature for Admins in SUSI.AI

Post author:PrP-11
Post published:August 21, 2018
Post category:API FOSSASIA GSoC SUSI.AI
Post comments:0 Comments

The admin panel of SUSI.AI has an admin panel to manage its users and skills and it also provides the admins to delete skills and restore the deleted ones. In this post we will discuss about how this works on the server and client side.

On the server side there are three APIs associated with this feature. One is to delete a skill, one to restore the skills and another to display the list of deleted skills. The following servlets are responsible for the above APIs and we will discuss about them in detail.

Implementing User Stats for SUSI.AI Admin Panel

Post author:PrP-11
Post published:August 21, 2018
Post category:API FOSSASIA GSoC SUSI.AI
Post comments:0 Comments

SUSI.AI has an admin panel where users with roles operator or above get an overview of various stats and manage other users and skills. The admin panel allows the system admins to get a list of all users registered on susi and also provide an option to change their user roles as well. The admin tab provides us with the statistics of its users. In this post we will discuss how this is implemented on susi server.

How to Change a Password and Forgot Password Feature in the SUSI.AI Server

Post author:PrP-11
Post published:August 21, 2018
Post category:API FOSSASIA GSoC SUSI.AI Tutorial
Post comments:0 Comments

The accounting system of SUSI.AI provides its users the option to change the password of their accounts. This features gives us two options, either we can change our password by entering the older password or if the user forgot the password, they are provided a link on their email address through which we can change our password. Using either option, the user has to authenticate themselves before they can actually change their passwords. If the user has the current password, it is considered as a parameter of authentication. In other case the user has to check their email account for the link which also confirms the authenticity of user. In this post we will discuss how both options works on SUSI.

Youtube search as a Console Service Endpoint in SUSI.AI

Post author:PrP-11
Post published:August 20, 2018
Post category:API FOSSASIA GSoC SUSI.AI
Post comments:0 Comments

SUSI.AI now has the ability to search and play any song or video directly in the webclient and the speaker. When a user asks for a query regarding playing a song, the clients sends a search request to the server. In this post I will discuss about the server side implementation of the Youtube search. Every time a request is made by any client, the client sends a query request to the server in the form of a json object. For more on the working on the webclient side can be seen here.

The endpoint for youtube search is http://api.susi.ai/susi/console.json

Delete User Account Service using LoginService.java API in SUSI.AI

Post author:PrP-11
Post published:August 20, 2018
Post category:API FOSSASIA GSoC SUSI.AI
Post comments:0 Comments

SUSI.AI has an api to handle all account related services called accounts.susi.ai. This API provides services like change password and delete account. the main goal of accounts.susi.ai is to centralise the accounts’ related settings from web, android and iOS clients into a single place like other accounting services. In this post we will discuss one of these features which is the delete user account from SUSI.AI.

The api accounts.susi.ai has a react file DeleteAccount.react.js. This file handle the delete account service and interacts with the LoginServce.java api, which is the core file for authentication. I will discuss in details how these two interact with each other and with other files.

How User preferences data is stored in Chat.susi.ai using Accounting Model

Post author:PrP-11
Post published:August 20, 2018
Post category:API FOSSASIA GSoC SUSI.AI
Post comments:0 Comments

Like any other accounting services SUSI.AI also provides a lot of account preferences. Users can select their language, timezone, themes, speech settings etc. This data helps users to customize their experience when using SUSI.AI.

In the web client these user preferences are fetch from the server by UserPreferencesStore.js and the user identity is fetched by UserIdentityStore.js. These settings are then exported to the settings.react.js file. This file is responsible for the settings page and takes care of all user settings. Whenever a user changes a setting, it identifies the changes and show an option to save these changes. These changes are then updated on the server using the accounting model of SUSI.AI. Let’s take a look at each file discussed above in detail.