/mentorship-android

Mentorship System is an application that matches women in tech to mentor each other, on career development, through 1:1 relations during a certain period of time. This is the Android application of this project.

Primary LanguageKotlinGNU General Public License v3.0GPL-3.0

project chat License: GPL v3 GitHub forks GitHub stars

Mentorship System (Android)

Branch Travis Codacy
master Build Status Codacy Badge
develop Build Status Codacy Badge

Mentorship System is an application that allows women in tech to mentor each other, on career development topics, through 1:1 relations for a certain period.

This is the Android client for the Mentorship System.

Features

  • Once the App is installed user can view an onboarding screen which introduces the app and give user an idea of how it works.
  • A member gets an option to be a Mentor, Mentee or Both.
  • A member can build/customise the app profile with username, bio, skills, interests, location, occupation, etc. anytime.
  • A member can read and know more about Mentorship System including the terms and conditions, privacy and policy and code of conduct.
  • A member can directly access the AnitaB-org Github repo, Zulip chat and website from this App.
  • A member can refresh the every page.
  • A member can view a list of other members and search for a member on the Members Page.
  • A member can search for particular members there in Mentorship System.
  • A member can sort other members on the basis of their name either (A-Z) OR (Z-A), registration date, age.
  • A member can filter other members by the label need mentoring or available to mentor, interest, location and skills that given while creating profile.
  • A member can either send mentorship requests to other members as a Mentor or Mentee according to their interests or reject mentorship requests from other members.
  • A member can track the number of Pending Resquests, Accepted Requests, Rejected Requests, and Completed Requests and view Recent Achievements on the Home Page.
  • A member can view the details of pending, past, all the mentorship requests in the Requests Page.
  • A member can create, update, or delete tasks in their current mentorship relation.
  • A member can send feedback about the Mentorship System such as reporting a bug, giving suggestions or other comments.
  • A member can delete their account.
  • A member can change their account password anytime.

Setting up the project

To setup the project locally read these wiki pages and follow the instructions:

Contributing

Please read our Contributing guidelines, Code of Conduct and Reporting Guidelines

Please follow our Commit Message Style Guide while sending PRs.

Please follow Kotlin official docs for Coding Conventionsto maintain a consistent code style in the repository.

Running the UI tests

To run the existing UI tests follow the steps given below:

  • Connect your Android device or open the emulator.
  • On the terminal type: ./gradlew clean build connectedAndroidTest --stacktrace
  • If the above command is not working try using the command: gradlew clean build connectedAndroidTest --stacktrace
  • Wait until all the tests are completed.
  • You will get a report generated with a test summary.
  • See the complete report ./mentorship-android/app/build/reports/androidTests/connected/index.html
  • The report ./mentorship-android/app/build/reports/androidTests/connected/index.html will show all the testsuites that have passed as well as failed.
  • To get a more detailed explanation about the tests of a particular testsuite visit respective html file of the testsuite. For e.g.: org.systers.mentorship.LoginActivityTest.html will contain the results of all the tests run under that particular testsuite.
  • You can find the respective html files of the different testsuites under the heading classes in index.html report.

Documentation

To learn more about this app you can look at this project's wiki.

Check out the design history at User Interface Design.

Our tech stack includes:

  • Language: Kotlin
  • Architecture: Model View ViewModel (MVVM)
  • Libraries: Retrofit, RxJava, ViewModel, LiveData, DataBinding

Branches

The repository has the following permanent branches:

  • master This contains the code which has been released.

  • develop This contains the latest code. All the contributing PRs must be sent to this branch. When we want to release the next version of the app, this branch is merged into the master branch.

  • apk This branch contains the apks for the code in the develop branch. The apks are automatically updated when a commit is pushed to develop branch.

Screenshots

Splashscreen SignUp Screen Login Page
Home Page Profile Page Edit Profile Page
Relations Page Tasks Page Members Page
Member Profile Send Request Page Requests Page
Settings Screen About Page Change Password Page

Contact

You can reach our community at AnitaB.org Open Source Zulip.

We use #mentorship-system stream on Zulip to discuss this project and interact with the community. If you're interested in contributing to this project, join us there!

License

Mentorship System is licensed under the GNU General Public License v3.0. Learn more about it in the LICENSE file.