Iteration 1

  • Vision Statement
  • Features
  • Actors
  • Use Cases
  • GUI
  • Activity Diagram
  • Domain Diagram
  • Architecture

We plan to write an android based phone location application with social features. The core application will consist a googlemaps style interface where your friends phone location is marked.

Our application will consist of a client program that runs on the phones and a server application that is responsible for managing account information, friend lists, and etc.

The server application will be implemented using J2EE technologies. The client application will run on an Android phone. It will be responsible for responding to location information requests, and presenting friends location information. It will allow grouping of friends for contact purposes.

Features

Location features

  • Locating other people on your phone
  • Marking differnt groups with different colors
  • Finding nearby friends.
  • Finding particular friends specified by group of individual.

Social features

  • define customized group of friends
  • select range you want to see people
  • contact peple who are nearby (text, email, call, IM)
  • create/edit/remove groups of friends
  • invite people to join service
  • add/delete/block friend
    • add by searching server's list of users by name/email/phone number
    • block is temporarily disallow friend from seeing your location

Lost phone features

  • Remote locking of phone
  • Remote wipe
  • Locating (lost) phone

More features

  • account management
  • web interface to service
  • personal profiles
    • picture, status, personal information, ability to update

Actors

  • Users - The person who will be creating an account either using the phone application or through the web application. One user is defined as one account tied to one specific phone. User is in charge of finding, grouping, and communicating with friends.
  • Phone - Provides GPS location information and runs user interface
  • Server - Manages accounts (including group information, user profile), provides web interface, gathers location information from users, enforces privacy constraints, and syncs with phone.
Create Account

Use case: create account 
Primary: new user 
Goal: Allow new user to create with the facemap service

  1. New user visits facemap server or installs/runs app on phone
  2. New user selects createAccount action
  3. User enters their information
  4. Information is verified
    1. Required information
      • Name (First and Last)
      • Email address
      • Phone number (will automatically retrieve from phone)
      • Alphanumeric password
    2. If any part is invalid, user prompted to correct information
  5. Account is created
    • If creating an account through the web interface, server will send text to phone number provided with a confirmation number. Service is activated once the user enters the confirmation number from the text. However, locating services won't start until user installs the full app onto the phone.
Request Friend

Use case: request friend 
Primary actor: user 
Goal: allow user to request the ability to see someone else's phone location 

  1. User logs in/starts app
  2. User selects addFriend action
  3. User selects contact
    • Phone's contact list
    • Manually enters a name
    • Manually enters an email
    • Manually enters a phone number
  4. Friend found?
    • Friend found
      • Send friendship invitation
    • Friend not found
      • If searched person has phone/email, popup to confirm send service invitation
      • If searched person doesn't include contact mode, make user type phone or email before sending service invitation
  5. Other person accepts friendship or service invitation
  6. Server stores new user or connects two existing users
Delete Friend

Use case: delete friend 
Primary actor: user 
Goal: allow user to permanently unlink with another friend in his list

  1. User selects deleteFriend action
  2. User select friend from list of current friends
  3. User confirms deletion
  4. Delete message sent to server
  5. Server sends update to corresponding friend so they are removed from each other's phone.
Create Group

Use case: create group 
Primary actor: user 
Goal: allow user to group their friends 

  1. User select createGroup action
  2. User select friends to add to group
  3. User selects done/save action
  4. Group information saved on server
Delete/Block Group

Use case: Delete or Block an entire Group 
Primary actor: user 
Goal: allow user to delete a group of friends that they have created 
Precondition: user running phone app 

  1. User select deleteGroup or blockGroup action
  2. User selects which group to delete or block
  3. If delete, group removed from server
  4. Note: block indicates that the blocked person can no longer see or communicate with the user.
Edit Group Members

Use case: edit group members 
Primary actor: user 
Goal: allow user to edit members in a group 
Precondition: user running phone app 

  1. User select Group of interest
  2. User select editGroupMembers action
    • Adds members to group
      1. User select addMembers action
      2. User selects friends to add to group
    • Removes group members
      1. User selects members to delete
      2. User selects deleteMembers action
    • Blocks group members
      1. User selects members to block
      2. User selects blockMembers action
      3. Note: block indicates that the blocked person can no longer see or communicate with the user.
  3. Updated group information saved on phone
  4. Note: removing member from a group doesn't delete the member permanently, it merely dissociates member with this specific group. If member is no longer part of any group, he/she is moved to an uncategorized group.
Communicating with group members

Use case: communicate with group 
Primary actor: user 
Secondary actors: facemap server, facemap phone app 
Goal: send a message to the user's nearby friends 
Precondition: user running phone or web app

  1. User selects desired contact group
    1. Default range set at 1 mile radius
    2. If desired, user defines range for "nearby friends" in group
  2. Facemap phone app queries server for location of friends within "nearby" range
  3. Server returns list of friends
  4. Phone app presents user with map of "nearby friends"
  5. User select sendMessage action
  6. User select type of communication (text,IM,email)
  7. User enters message
  8. User select send action
  9. Phone app sends message to all members of the "nearby friends" group via desired medium
Add Nearby Friends

Use case: Add nearby friends
Primary actor: user 
Secondary actor: facemap server 
Goal: allow people to add as friends facemap users in the nearby location
Precondition: user running phone app 
Note: the utility of this use case is very dependent on the number and location of people using the facemap service. There are also privacy concerns with this use case as facemap users may not want random people being able to search for them based on their location unless they are friends

  1. User selects addFriends action
  2. User selects searchNearby
  3. User enters search key (name/email/phone#)
  4. App sends query to server
  5. Server creates list of nearby facemap users
  6. Server searches list and returns matching entries to phone
  7. User selects person from list
  8. User select addFriend action
  9. ... Rest of "add friend" use case follows
Locate Lost Phone

Use case: locate lost phone 
Primary actor: user 
Secondary actor: facemap server 
Goal: allow user to locate their lost phone 
Precondition: user has an account with facemap service

  1. User logs into FaceMap? web app
  2. User selects locateMyPhone action
  3. Server queries phone for current location
    1. If phone doesn't respond within time limit, server returns last known location
  4. Server displays phone location on googlemap style interface

Remote Lock/Wipe

Use case: remote lock/wipe 
Primary actor: user 
Secondary actor: facemap server, user's phone 
Goal: allow user to lock or wipe their phone in the case that it is stolen 

  1. User logs in to facemap web application
  2. User selects lock/wipe action
  3. User confirms action
  4. Facemap server send lock/wipe message to phone
  5. Facemap phone application recieves message and performs task

 

Registration and Log-in
Groups
Add Contacts
Add Contacts to Group
Edit Contacts in Group
Locate Contact From Group on Map
Web Application GUI
Request Friend
Communicate with Nearby Friends

Architecture

Resources

  • Android GPS
  • Android UI libraries
  • J2EE
    • JBoss/Glassfish
    • SpringMVC/Apache Tomcat/JSP/JSF
    • Hibernate/JDBC
  • Database
    • MySQL

Packages

  • phone
    • ui
    • model
  • web UI
    • ui
    • model
  • server
    • data access layer

Deployment

  • App running on the phone
  • Server app
  • Web interface.