Gaia/Clock: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
m (Add a Security Review section)
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The Alarm app offers users the ability to manage time across multiple timezones, a traditional alarm clock with ringtone options, and a stopwatch/timer feature.
== Design Specs ==
 
For the latest UX specifications, please visit:  
== Status & Team ==
https://mozilla.box.com/applications
* See: [https://docs.google.com/spreadsheet/ccc?key=0AiBigu584YY7dGlNSlY0QzhJb3M5anRBa1gxalV0Y3c#gid=0 B2G - Milestone 3 Plan]


== Use Cases ==
== Use Cases ==
Line 10: Line 9:
*Tom likes to sleep in, especially on the weekends, and uses the snooze button so he can see how his dream ends.
*Tom likes to sleep in, especially on the weekends, and uses the snooze button so he can see how his dream ends.
*Because Tom loves to cook, he finds it very convenient that his phone offers him the ability to use the timer feature in the Alarm app so he doesn't overcook his meals
*Because Tom loves to cook, he finds it very convenient that his phone offers him the ability to use the timer feature in the Alarm app so he doesn't overcook his meals


== Requirements ==  
== Requirements ==  
;Gaia v1
;Gaia v1
*The Alarm app is broken out into 3 components:
*Clock home page
**Alarm clock - features:
**Show current time
***User has the ability to set the time
**Show all active alarms
***User has the ability to set the repeat frequency, v1 will support:
*Alarm clock:
****No repeat
**Set an alarm
****Daily
***Set time using the time picker
****Select day of the week
***Set repeat option:
***User has the ability to select from default set of ringtones
****Select individual days (Monday, Tuesday, ... Saturday, Sunday)
***User has the ability to snooze
****All days are unselected by default
****Snooze is set to 7 mins by default (not adjustable)
***Set snooze time:
**Stopwatch
****Select 5 (default), 10, 20, or 30 minutes
***User has the ability to start the clock, stop the clock, and reset the clock
***Set alarm label option:
**Timer
****Default string is "Alarm", or overwrite with your own label
***User has the ability to set the clock to count down from 24 hours
***Set alarm sound:
****Hour increments
****Select from our predefined list of sounds
****Minute increments
***Set alarm color:
***Default ringtone for when the timer is complete
****Select from our predefined list of colors
***Delete alarm
**Set multiple alarms
***Add new alarm
***Turn alarms on and off from the clock home page (alarms are on by default)
***Each alarm should show:
****Time (e.g.6:50pm or 18:50)
****Label string
****Repeat state (e.g. Weekdays, Weekends, Mon, Tue, Wed)
****Alarm color
****Alarm on/off state
****Press and hold to delete
***After setting an alarm, show a countdown indicator: "This alarm is set for 10 hour and 20 minutes from now."
*Lock screen
**Indicator that there is an upcoming alarm set
***Alarm icon and color
***Alarm time
**When the alarm goes off
***Show alarm icon and color
***Show alarm label
***Show alarm time
***Show big snooze button
****Tap to close alarm dialog
****Show "Snooze for n minutes" toast
***Show big stop button
*Time Zones
**Set time zone automatically, but allow user to override
*Time Format
**Obey system 24/12 hr setting
*Alarm Sounds
**Alarm sound should gradually fade up (10-30 seconds) so it's not jarring when it goes off (wake up scenario)


;Gaia v2
;Gaia v2
*User has the ability to manage/view multiple time zones
*Clock
**The user can add/delete time zones
**Select clock themes (styles, analog, large size, etc.)
*Alarm clock features:
**Display date
**User has the ability to select ringtones from their Music library
**Display weather
**User has the ability to setup multiple alarms
**World clocks
*Stopwatch
*Stopwatch
**Add a lap timer that save up to 20 laps
*Timer
*Timer
**User has the ability to select ringtones from the default set on the phone
**Sound for the timer should not gradually fade up like the alarm clock
 
== Development ==


== Design Specs ==
* [https://github.com/mozilla-b2g/gaia/tree/master/apps/clock Source code on Github]
* . . .
 
== Security Review ==
The security review of this app can be found [https://wiki.mozilla.org/Security/Reviews/Gaia/clock here].

Latest revision as of 14:31, 28 October 2013

Design Specs

For the latest UX specifications, please visit: https://mozilla.box.com/applications

Use Cases

  • Tom has family and friends in Asia and keeps in touch with them every few months - he loves using the Alarm app to help him keep track of time zone differences so he make sure to call them at a appropriate time of the day
  • Tom no longer owns an alarm clock and solely relies on his mobile phone as an alarm clock to wake himself up each day
  • Tom has a diverse schedule and needs to set different alarm times throughout the weekdays and weekends. He is able to customize the alarms with different labels and sounds.
  • Tom likes to sleep in, especially on the weekends, and uses the snooze button so he can see how his dream ends.
  • Because Tom loves to cook, he finds it very convenient that his phone offers him the ability to use the timer feature in the Alarm app so he doesn't overcook his meals


Requirements

Gaia v1
  • Clock home page
    • Show current time
    • Show all active alarms
  • Alarm clock:
    • Set an alarm
      • Set time using the time picker
      • Set repeat option:
        • Select individual days (Monday, Tuesday, ... Saturday, Sunday)
        • All days are unselected by default
      • Set snooze time:
        • Select 5 (default), 10, 20, or 30 minutes
      • Set alarm label option:
        • Default string is "Alarm", or overwrite with your own label
      • Set alarm sound:
        • Select from our predefined list of sounds
      • Set alarm color:
        • Select from our predefined list of colors
      • Delete alarm
    • Set multiple alarms
      • Add new alarm
      • Turn alarms on and off from the clock home page (alarms are on by default)
      • Each alarm should show:
        • Time (e.g.6:50pm or 18:50)
        • Label string
        • Repeat state (e.g. Weekdays, Weekends, Mon, Tue, Wed)
        • Alarm color
        • Alarm on/off state
        • Press and hold to delete
      • After setting an alarm, show a countdown indicator: "This alarm is set for 10 hour and 20 minutes from now."
  • Lock screen
    • Indicator that there is an upcoming alarm set
      • Alarm icon and color
      • Alarm time
    • When the alarm goes off
      • Show alarm icon and color
      • Show alarm label
      • Show alarm time
      • Show big snooze button
        • Tap to close alarm dialog
        • Show "Snooze for n minutes" toast
      • Show big stop button
  • Time Zones
    • Set time zone automatically, but allow user to override
  • Time Format
    • Obey system 24/12 hr setting
  • Alarm Sounds
    • Alarm sound should gradually fade up (10-30 seconds) so it's not jarring when it goes off (wake up scenario)
Gaia v2
  • Clock
    • Select clock themes (styles, analog, large size, etc.)
    • Display date
    • Display weather
    • World clocks
  • Stopwatch
  • Timer
    • Sound for the timer should not gradually fade up like the alarm clock

Development

Security Review

The security review of this app can be found here.