Browse Source

docs(sky-map):fix audit and readme

pull/2048/head
miguel 1 year ago committed by MSilva95
parent
commit
acac34f5bf
  1. 43
      subjects/mobile-dev/sky-map/README.md
  2. 26
      subjects/mobile-dev/sky-map/audit/README.md

43
subjects/mobile-dev/sky-map/README.md

@ -1,37 +1,34 @@
# Sky map
## Sky map
### Exercise
A sky map app is a mobile application that provides users with an interactive map of the night sky. It utilizes the device's sensors, such as the GPS, accelerometer, and magnetometer, to determine the user's location and orientation. With this information, the app can display a real-time representation of the stars, planets, constellations, and other celestial objects visible from the user's location.
Your task is to develop an app that utilizes GPS, accelerometer, and magnetometer data to determine the location and position of the device. The app should update an image at least 10 times per second for real-time updates.
### Instructions
Using the sensor data, you will send a request to a public API to retrieve information about celestial objects and display them on a black canvas within the app. When a user taps on an object, a short description of the object should be displayed.
To manage states within the app, you should use either the BLoC or Provider pattern. The objects to be displayed in the app include all planets of the solar system, the sun and moon, and three constellations of your choice.
The main objectives of this exercise are to work with hardware sensors, collect celestial objects using object-oriented programming (OOP) techniques, render objects in real-time, and work with APIs. The Provider pattern is available for reference in the documentation.
To manage states within the app, you should use either the BLoC or Provider pattern.
To complete this exercise, you will need to do the following:
1. Set up a development environment for the app.
2. Utilize the GPS, accelerometer, and magnetometer sensors to determine the location and position of the device.
3. Implement real-time updates by updating an image at least 10 times per second.
4. Send a request to a public API to retrieve information about celestial objects.
5. Display the celestial objects on a black canvas within the app.
6. Allow users to tap on an object to view a short description of it.
7. Use either the BLoC or Provider pattern to manage states within the app.
8. Test the app thoroughly to ensure that it is functioning correctly and all objectives have been met.
Remember to follow best practices for coding and app development, and be sure to document your code and any decisions made during the development process. Don't forget to consider user experience and design when creating the app, as a visually appealing and intuitive interface will be important for its success. Good luck!
- Utilize the `GPS`, `accelerometer`, and `magnetometer` sensors to determine the `location` and `position` of the device.
- Implement `real-time updates` by updating an image at least **_10 times per second_**.
- Send a request to a public API to retrieve information about celestial objects or use a valid file.
- Display the celestial objects on a black canvas within the app.
- Allow users to tap on an object to view a short description of it.
- Use either the `BLoC` or `Provider` pattern to manage states within the app.
- The objects to be displayed in the app include:
- All planets of the solar system
- The sun
- The moon
- At least three constellations of your choice
- When moving the phone around, the celestial objects shown on the display should change
Remember to follow best practices for coding and app development, and be sure to document your code and any decisions made during the development process. Don't forget to consider user experience and design when creating the app, as a visually appealing and intuitive interface will be important for its success.
Possible examples of the app:
<center>
<img src="./resources/skyMap.01.jpg?raw=true" style = "width: 840px !important; height: 420px !important;"/>
<img src="./resources/skyMap.01.jpg?raw=true" style = "width: 500px !important; height: 300px !important;"/>
</center>
<center>
<img src="./resources/skyMap.02.png?raw=true" style = "width: 840px !important; height: 420px !important;"/>
<img src="./resources/skyMap.02.png?raw=true" style = "width: 500px !important; height: 300px !important;"/>
</center>

26
subjects/mobile-dev/sky-map/audit/README.md

@ -1,25 +1,27 @@
#### Functional
> In order to run and hot reload app either on emulator or device, follow the [instructions](https://docs.flutter.dev/get-started/test-drive?tab=androidstudio#run-the-app)
> In order to run and hot reload the app either on emulator or device, follow the [instructions](https://docs.flutter.dev/get-started/test-drive?tab=androidstudio#run-the-app)
###### Was the app committed within the required time period?
###### Does the app run without crashing?
###### Does the app run without crashes?
###### Does the app display celestial objects on a black canvas?
###### Does the app display celestial objects on black canvas?
###### Check the current position of the Sun, is it accurate? (use google or a reliable source to know what is the accurate position and compare it to this app)
###### Check with the current position of the sun, is it accurate?
###### Are the moon, Mars, and Venus visible in the app?
###### Are moon, Mars, and Venus visible in the app?
##### Ask student about the constellations of their choice, and try find them in the app.
###### Ask student about constellations of their choice, and find them in the app?
###### Are the constellations visible in the app?
###### Check if the retrieved data is either from API or from a file. If the data comes from file, check its validity?
###### Check if the retrieved data is either from a public API or from a file. If the data comes from file, check its validity? (ask the student to help you determine if it was an API or a File if necessary)
###### Try moving the phone around, does it change the celestial objects shown on the display?
##### Try tapping on the Sun and Mars.
###### Does the app display a short description about the objects such as mass or name?
###### Try tapping on the sun, mars. Does the app display basic information about objects, such as mass, name.
###### Try moving the phone around, does it change the celestial objects shown on the display?
###### Ask student about pattern implementation. If they used BLoC ask them to explain the pattern, and [check](https://pub.dev/packages/flutter_bloc) whether they implemented it correctly.
##### Ask student about pattern implementation. If they used BLoC ask them to explain the pattern, and [check](https://pub.dev/packages/flutter_bloc) whether they implemented it correctly. If they used Provider ask them to explain the pattern, and [check](https://pub.dev/packages/provider) whether they implemented it correctly.
###### Ask student about pattern implementation. If they used Provider ask them to explain the pattern, and [check](https://pub.dev/packages/provider) whether they implemented it correctly.
###### Was the pattern implemented correctly?

Loading…
Cancel
Save