A social media invitation app with a focus on connecting people on a human level by allowing users to send invitations to other people to do actual events such as enjoy a cup of coffee or attend an office party. Amongst all of the social media apps out there that are connecting people with others across the world, our app has the fine opportunity of connecting people on a more intimate level. Not across the world, but maybe across the street.

The files in this repository are for building the front end android client.

Here’s our Apache 2.0 License

Team Members:

• Alex Rael: Did most of the Room Persistence ORM manipulation throughout the app. That includes grabbing the necessary information to create a new user from Google Sign In, displaying that info in the user profile section including a users display name and display image, grabbing info from the create invitation fragment including the location of the event and the date and time of the event and displaying it in a new invitation view for the user who receives it. Also setup most of the Retrofit calls to communicate with the backend.

• Dina Rabanal: I created recycler views for the people and invitations fragments. Making the basic recycler knowing that it would expand into backend use of the list of people in each quadrant. I also concentrated on the UI design. I believe that the look of the app is just as important as design of the code.

• Brian Bleck: Built the back-end using the Spring Boot Framework (Tomcat, Spring MVC, Spring Security, and Spring HATEOAS) and deployed it onto AWS Elastic Beanstalk. The database is an Apache Derby database and Hibernate was used as the ORM layer on top of it. The Jackson library was used to serialize/deserialize the data coming from/to the back-end. Created the early architectural bones for the front-end to be fleshed out around. Troubleshot data transfer issues between client/server. For the client, coded the location updates and the data update loop to keep the front end connected to the back-end. Coded the logic to maintain the client database with the correct data. Coded the client logic for packaging incoming data for use in the various UI elements, and the client logic for packaging data and making calls to the back-end.

User Stories:

• As a user I want to be able to send an invitation to other people who I can see.
  • As a user I want to be able to invite one other person out to coffee.
  • As a leader of an organization I want to be able to invite everyone in a meeting to lunch.
  • As a user I want to be able to connect with new people in close proximity.
• As a senior I want to be able to alert people around me that I am in need of medical attention.
  • As a user I want to be able to alert people in the immediate vicinity that I am in danger.
  • As a user I want to be able to alert people of a fire.
• As a user I want to able to receive invitations from other users.
• As a store owner I want to be able to inform users of current sales.
  • As a bar owner I want to be able to inform users of bar events.
• As a community organizer I want to be able to alert people that there is a rally coming together.
• As a student I want to be able to invite my friends to a party.
• As a user I want to be able to drop down an event in an area for people to see within that are.
  • As a user I want to be able to see events dropped down by other users within the same area.
• As a user I want to be able to tell everyone that I’ve lost my pet.
  • As a user I want to be able to tell everyone that I have a gig going on.

Wireframes:

A link to our Join Me wireframes.

Entity Relationship Diagram

Technical Information:

The app was developed in mostly English with a restricted Portrait orientation. Operating Systems developed in were Windows and OSx. Software used includes both IntelliJ and Android Studio. Project was developed in Java 8 and the app had a minimum SDK level of 23 but has been tested to work on SDKs 24-28. Most test were ran on both emulators and physical android devices that run at least Marshmellow.

External Services, 3rd Part Libraries with Licenses:

• Google Services (including Google Sign In and Google Location):
  • Licenses:
    • Apache License 2.0
    • Creative Commons Attribution 2.5
  • Dependencies:

    implementation 'com.google.gms:google-services:4.1.0'
    implementation 'com.google.android.gms:play-services-auth:16.0.1'
    implementation 'com.google.android.gms:play-services-location:16.0.0'                                                         
    

• Room Persistence ORM:
  • Licenses:
    • Apache License 2.0
    • Creative Commons Attribution 2.5
  • Dependencies:

    implementation 'android.arch.persistence.room:runtime:1.1.1'
    annotationProcessor "android.arch.persistence.room:compiler:1.1.1"
    testImplementation "android.arch.persistence.room:testing:1.1.1"
    

• Room Persistence ORM:
  • Also add this java compile option directly under the testInstrumentationRunner in your app level build.gradle file:

    javaCompileOptions {
            annotationProcessorOptions {
                arguments = ["room.schemaLocation": "$projectDir/schemas".toString()]
            }
            dataBinding {
                enabled = true
            }
        }
    

• Facebook Stetho:
  • Licences: BSD License

    implementation 'com.facebook.stetho:stetho:1.5.0'
    

• Retrofit and Gson:
  • Licenses:
    • Retrofit Apache License 2.0,
    • Gson Apache License 2.0
  • Dependencies:

    implementation 'com.google.code.gson:gson:2.8.5'
    implementation 'com.squareup.retrofit2:retrofit:2.4.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.4.0'
    

• Glide:
  • Licenses (and other associated Licenses): Licenses
  • Dependencies:

    implementation 'com.github.bumptech.glide:glide:4.8.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.8.0'
    

• Ramotion (Circle Menu):
  • License: MIT License
  • Dependencies:

    implementation 'com.ramotion.circlemenu:circle-menu:0.3.1'
    

• Hdodenof (Circle Image View):
  • License: Apache License 2.0
  • Dependencies:

    implementation 'de.hdodenhof:circleimageview:2.2.0'
    

Build and User Instructions:

• Here’s a link to our Build instructions file.
• Here’s a link to our User Instructions file.

Data Definition Language

Here’s a link to our ClientDB.sql file.

State of Completion and Stretch Goals:

You’re able to create a new account through Google Sign In and see other people, within your area, in the app. You’re able to create invitations and see the details of that invitation. When that invitation is successfully sent, the person will be able to see it in their received invitations view. After all that feel free to head on over to your user profile where you’ll be presented with your image from Google, and your display name. Feel free to head on over to the create invitation screen from here with that button on the bottom.

Here’s some stretch goals

1. Actually be able to send invitations.
2. Allow the user to seend multiple people invitations with just one invitation.
3. Allow people who have accepted an invitation to see all who is attending that event.
4. Allow users to add a description to their profile.
5. Allow people to see other people’s profiles.
6. Implement Google Sign In Oauth2 for secure sign in.
7. Allow user to decide what aspects of their profile they can have uploaded.
8. Take in birthdays and sort out people based on ages to protect minors.
9. Implement an Emergency function with emergency services available.

Thank You

Thank you for stopping by and checking out our project. This was a 3-4 week success, and even though we still have a lot to implement, we’re still proud of what we’ve committed so far. Feel free to watch it grow, if we do continue. Thank you.