europ / muni-fi-pa181

MUNI - FI: PA181 2018/2019

PA181 - Services - Systems, Modeling and Execution

About

Term project for course PA181 Services - Systems, Modeling and Execution in year 2019. Within the project, we had to create a fully functional application using the IBM Cloud technology including a detailed documentation and a presentation. The application offers a user-self testing platform, where you can run one of available tests or upload your custom test suite.

Contents

• project documentation
• project presentation
  • project presentation 1
  • project presentation 2
• repository structure
• project setup
• domains of the hosted project
  • pa181.eu-de.cf.appdomain.cloud
  • pa181.eu-de.mybluemix.net

Authors

• Adrián Tóth
• Jan Ondruch
• Jiří Čechák
• Tadeáš Pavlík
• Václav Stehlík

License

This project is available as open source under the terms of the MIT License.

muni-fi-pa181's Issues

Deployment Failed (access problem)

Deployment failed.

• Commit
• Description
• Reason: Missing GitHub token.

Topic

Could you, please, suggest some ideas what to develop for this project?

Volba UI frameworku

Výběr frameworku pro UI.
Hlasujte, prosím:

1. Material UI - https://material-ui.com/demos/app-bar/
2. Bootstrap - https://react-bootstrap.github.io/components/alerts
3. Ant Design - https://ant.design/components/button/
4. Něco jiného - uveď zdroj

Deployment

Inside of /src folder execute the following commands:

# change something
# test your app
# git commit
cf api https://api.eu-de.bluemix.net
cf login
cf push
# git push

Check the deployed app:

cf apps

UI stuff to fix

TODO

• Upload/Download wrongly answered questions as file
• Logo (PREP 4 TESTS) should on click redirect the user to the main page (dashboard with tests)
• Title in "about" section should be just "preparation for tests" as mentioned in #11

NOTE

• 3 bugs related to the language, but does not matter, if you change the title as mentioned above

Input length

Just tested the app - the functionality seems fine to me. Just while typing and clicking like mad trying to break the app, I came across an input length issue on the "new set of questions" creation. I think there's some restriction like 1000 chars or so, I'd just make it a bit less. But it's really just a minor issue, well done guys 👍

Icon image

Our project requires an icon (in vector). Please, propose some.

Presentation & Documentation

Add, replace or remove the following

@jirkacechak

• Presentation

  • MUNI-FI-PA181/pres/pres.tex

    Line 201 in 50cc83b

    Jirka and Václav - create few notes here\\

• Documentation

  • MUNI-FI-PA181/doc/doc.tex

    Line 258 in 50cc83b

    Jirka and Václav - create some sentences here (add some description)\\

@vaclavstehlik

• Presentation

  • MUNI-FI-PA181/pres/pres.tex

    Line 201 in 50cc83b

    Jirka and Václav - create few notes here\\

• Documentation

  • MUNI-FI-PA181/doc/doc.tex

    Line 258 in 50cc83b

    Jirka and Václav - create some sentences here (add some description)\\

Everybody

• Presentation

  • MUNI-FI-PA181/pres/pres.tex

    Line 254 in 50cc83b

    \includegraphics[width=.5\textwidth,height=.5\textheight,keepaspectratio]{img/todo.png}

  • MUNI-FI-PA181/pres/pres.tex

    Line 261 in 50cc83b

    \includegraphics[width=.5\textwidth,height=.5\textheight,keepaspectratio]{img/todo.png}

  • MUNI-FI-PA181/pres/pres.tex

    Line 268 in 50cc83b

    \includegraphics[width=.5\textwidth,height=.5\textheight,keepaspectratio]{img/todo.png}

• Documentation

  • MUNI-FI-PA181/doc/doc.tex

    Line 282 in 50cc83b

    how to use, tutorial, examples, NO IMAGE! (use references to the Screenshot section)\\

  • MUNI-FI-PA181/doc/doc.tex

    Line 290 in 50cc83b

    images (add it to 'img/' folder - vector would be the best or raster with high resolution)\\

  • MUNI-FI-PA181/doc/doc.tex

    Line 296 in 50cc83b

    \includegraphics[scale=0.3]{img/todo.png}

Remove if everything (above) is done

• img/todo.png

Database

Do we need to use a database? Please, let me know if I have to add it or not.

To add a database into our project, there is a step-by-step guide for that:
https://cloud.ibm.com/docs/runtimes/dotnet?topic=Dotnet-getting_started#add_database

@jirkacechak and @vaclavstehlik, the tests are going to be saved into a folder or you would like it to save them into a database?

Anomaly of IBM toolchain - GitHub

Unexpected behavior of IBM toolchain

The toolchain tags the commit and publish a release for each success deployment. The success of deployment should be shown in the "environment" section of the repository as it was set instead of commit tagging and releasing (see section "releases" of the repository).

Environment section of the repository (expected)

Repository releases and tags (unexpected)

Releases

Tags

Entity

První návrh entit. Jelikož neimplementujeme přihlašování, tak nejspíše s více entitami pracovat nemusíme. Atribut count_wrong_answer je kvůli funkcionalitě "funny facts (for example most common wrongs answers)". Ukázka na obrázku:

Upravovat aktuální návrh můžete na odkazu zde

Dropdown default selection

"Hide Info" is selected by default.

Mozilla Firefox 67.0 (64-bit) on Windows 10

Invalid URL

We should use a special view (404 Not Found) for invalid URL.

Invalid URL

https://pa181.eu-de.mybluemix.net/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

Inspiration

https://github.com/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

Unable to run project from source

Console error message:
The character encoding of the plain text document was not declared. The document will render with garbled text in some browser configurations if the document contains characters from outside the US-ASCII range. The character encoding of the file needs to be declared in the transfer protocol or file needs to use a byte order mark as an encoding signature.

Error srouce:
src/src/API/wwwroot/UI/build/index.html

<!doctype html><html lang="en"><head><metaa charset="utf-8"/>

Double "a" in <meta ...> tag.

Platform:

• Mozilla Firefox 66.0.2
• Ubuntu 16.04.6 LTS
• Google Chrome 73.0.3683.103 (Official Build) (64-bit)

\cc @vaclavstehlik @jirkacechak

Broken deployment

...

Updating app PA181...
Mapping routes...
Comparing local files to remote cache...
Packaging files to upload...
Uploading files...

 0 B / 301.98 KiB    0.00%
 301.98 KiB / 301.98 KiB  100.00%
 301.98 KiB / 301.98 KiB  100.00%
 301.98 KiB / 301.98 KiB  100.00%
 301.98 KiB / 301.98 KiB  100.00%
 301.98 KiB / 301.98 KiB  100.00%
 301.98 KiB / 301.98 KiB  100.00% 1s

Waiting for API to complete processing files...

Staging app and tracing logs...
   Downloading dotnet-core_v2_2-20190327-1013...
   Downloading xpages_buildpack...
   Downloading php_buildpack...
   Downloading sdk-for-nodejs_v3_26-20190313-1440...
   Downloading liberty-for-java...
   Downloaded dotnet-core_v2_2-20190327-1013
   Downloading sdk-for-nodejs...
   Downloaded sdk-for-nodejs_v3_26-20190313-1440
   Downloading dotnet-core...
   Downloaded xpages_buildpack
   Downloading swift_buildpack...
   Downloaded php_buildpack
   Downloading staticfile_buildpack...
   Downloaded liberty-for-java
   Downloading java_buildpack...
   Downloaded sdk-for-nodejs
   Downloading ruby_buildpack...
   Downloaded dotnet-core
   Downloading nodejs_buildpack...
   Downloaded staticfile_buildpack
   Downloaded swift_buildpack
   Downloading python_buildpack...
   Downloading go_buildpack...
   Downloaded java_buildpack
   Downloading dotnet-core_v2_1-20181205-1536...
   Downloaded ruby_buildpack
   Downloading liberty-for-java_v3_29-20190223-2128...
   Downloaded go_buildpack
   Downloading liberty-for-java_v3_30-20190325-1301...
   Downloaded python_buildpack
   Downloaded dotnet-core_v2_1-20181205-1536
   Downloading swift_buildpack_v2_0_17-20190212-2123...
   Downloading binary_buildpack...
   Downloaded nodejs_buildpack
   Downloading swift_buildpack_v2_0_18-20190303-1915...
   Downloaded liberty-for-java_v3_29-20190223-2128
   Downloading sdk-for-nodejs_v3_25_1-20190115-1637...
   Downloaded liberty-for-java_v3_30-20190325-1301
   Downloaded swift_buildpack_v2_0_17-20190212-2123
   Downloaded binary_buildpack
   Downloaded swift_buildpack_v2_0_18-20190303-1915
   Downloaded sdk-for-nodejs_v3_25_1-20190115-1637
   Cell 57638bb3-0565-4696-9346-e041fa47a193 creating container for instance 23f0c00e-b7de-4f21-a0e7-c703bc379006
   Cell 57638bb3-0565-4696-9346-e041fa47a193 successfully created container for instance 23f0c00e-b7de-4f21-a0e7-c703bc379006
   Downloading app package...
   Downloading build artifacts cache...
   Downloaded app package (1M)
   Downloaded build artifacts cache (4.3M)
   -----> Dotnet-Core Buildpack version v2.2-20190327-1013
   -----> Supplying Dotnet Core
   -----> Installing libunwind 1.3.1
          Copy [/tmp/buildpacks/c0d85ce1e66854a969f387bb76c3bef0/dependencies/f64d11b5e052c30f7f921bda02e98aeb/libunwind-1.3.1-cflinuxfs2-2399e09e.tar.gz]
          **ERROR** Error searching project for library "System.Drawing.Common": multiple paths: [/tmp/app/src/API/API.csproj /tmp/app/src/Entities/Entities.csproj /tmp/app/src/Repositories/Repositories.csproj /tmp/app/src/Services/Services.csproj] contain a project file, but no .deployment file was used
   Failed to compile droplet: Failed to run all supply scripts: exit status 15
   Exit status 223
   Cell 57638bb3-0565-4696-9346-e041fa47a193 stopping instance 23f0c00e-b7de-4f21-a0e7-c703bc379006
   Cell 57638bb3-0565-4696-9346-e041fa47a193 destroying container for instance 23f0c00e-b7de-4f21-a0e7-c703bc379006
   Cell 57638bb3-0565-4696-9346-e041fa47a193 successfully destroyed container for instance 23f0c00e-b7de-4f21-a0e7-c703bc379006
FAILED
Error staging application: App staging failed in the buildpack compile phase

Finished: FAILED

UI contains "add new test" twice

Add new test is possible via:

1. "add new test" option in the top bar
2. plus button in the bottom right corner

TESTING

Bugs, errors and mistakes detected by testing

Please, test the actual application and report every bug, error and mistakes into this issue.
Do not forget to update the application to the latest version if you want to test it locally.

Výběr funkcionalit

Které funkcionality by měla aplikace obsahovat? Po návrhu vybereme, které budou implementovány.

Volba názvu aplikace

Napište návrhy a zkusíme vybrat.

Help description and example

Please, could you add a note and an example to the help view?

The help contains a test template and its destription, which is alright. Please, add a note that there is a possibility to create multiple-choice test suites by setting up more answer options as true.

Me as user, I would appreciate a real example. Could you, please, add this JSON file below the help content? Name it (add some title above of it) as e.g. "Example" or "Real Example".

Template testových otázek v JSONu

Pro kabellův drill jsem vytvářel/upravoval několik testů, takže je můžeme použít i pro demo naší aplikace. Přikládám JSON jednoho z testů jako šablonu.
questions_PV120.txt

Misplaced elements

The question numbers are misplaced.

test file = https://github.com/europ/MUNI-FI-PA181/blob/master/data/eng-che-chemistry.json