A modern, lightweight learning management system.
Doubtfire web migration from AngularJS/Coffeescript to Angular/Typescirpt, including refactoring all components, is currently in development.
See the progress of component migration below.
SUMMARY:
30 / 213 components migrated
MIGRATED:
- ./src/app/tasks/task-comments-viewer/extension-comment/extension-comment.component.ts
- ./src/app/tasks/task-comments-viewer/intelligent-discussion-player/intelligent-discussion-player.component.ts
- ./src/app/tasks/task-comments-viewer/intelligent-discussion-player/intelligent-discussion-recorder/intelligent-discussion-recorder.component.ts
- ./src/app/tasks/task-comments-viewer/comment-bubble-action/comment-bubble-action.component.ts
- ./src/app/tasks/task-comments-viewer/task-comments-viewer.component.ts
- ./src/app/tasks/task-comment-composer/task-comment-composer.component.ts
- ./src/app/tasks/task-comment-composer/discussion-prompt-composer/discussion-prompt-composer.component.ts
- ./src/app/projects/states/dashboard/directives/student-task-list/create-portfolio-task-list-item/create-portfolio-task-list-item.component.ts
- ./src/app/projects/states/dashboard/directives/student-task-list/task-list-item/task-list-item.component.ts
- ./src/app/projects/states/dashboard/directives/task-dashboard/directives/task-plagiarism-card/task-plagiarism-card.component.ts
- ./src/app/projects/states/dashboard/directives/task-dashboard/directives/task-description-card/task-description-card.component.ts
- ./src/app/admin/states/campuses/campus-list/campus-list.component.ts
- ./src/app/admin/states/activities/activity-type-list/activity-type-list.component.ts
- ./src/app/units/states/institution-settings/institution-settings.component.ts
- ./src/app/units/states/tasks/inbox/directives/staff-task-list/staff-task-list.component.ts
- ./src/app/units/states/edit/directives/unit-students-editor/student-tutorial-select/student-tutorial-select.component.ts
- ./src/app/units/states/edit/directives/unit-students-editor/unit-students-editor.component.ts
- ./src/app/units/states/edit/directives/unit-students-editor/student-campus-select/student-campus-select.component.ts
- ./src/app/units/states/edit/directives/unit-tutorials-manager/unit-tutorials-manager.component.ts
- ./src/app/units/states/edit/directives/unit-tutorials-list/unit-tutorials-list.component.ts
- ./src/app/common/audio-recorder/audio/audio-comment-recorder/audio-comment-recorder.ts
- ./src/app/common/audio-recorder/audio/microphone-tester/microphone-tester.component.ts
- ./src/app/common/audio-player/audio-player.component.ts
- ./src/app/common/modals/extension-modal/extension-modal.component.ts
- ./src/app/common/modals/about-doubtfire-modal/about-doubtfire-modal.component.ts
- ./src/app/common/modals/calendar-modal/calendar-modal.component.ts
- ./src/app/common/pdf-viewer/pdf-viewer.component.ts
- ./src/app/common/status-icon/status-icon.component.ts
- ./src/app/common/user-icon/user-icon.component.ts
- ./src/app/common/pdf-viewer-panel/pdf-viewer-panel.component.ts
TODO:
- ./src/app/visualisations/alignment-bar-chart.coffee
- ./src/app/visualisations/summary-task-status-scatter.coffee
- ./src/app/visualisations/target-grade-pie-chart.coffee
- ./src/app/visualisations/achievement-custom-bar-chart.coffee
- ./src/app/visualisations/student-task-status-pie-chart.coffee
- ./src/app/visualisations/alignment-bullet-chart.coffee
- ./src/app/visualisations/progress-burndown-chart.coffee
- ./src/app/visualisations/task-status-pie-chart.coffee
- ./src/app/visualisations/achievement-box-plot.coffee
- ./src/app/visualisations/task-completion-box-plot.coffee
- ./src/app/visualisations/visualisations.coffee
- ./src/app/home/home.coffee
- ./src/app/home/states/home/home.coffee
- ./src/app/home/states/states.coffee
- ./src/app/home/states/new-user-wizard/new-user-wizard.coffee
- ./src/app/tasks/task-submission-viewer/task-submission-viewer.coffee
- ./src/app/tasks/task-status-selector/task-status-selector.coffee
- ./src/app/tasks/tasks.coffee
- ./src/app/tasks/task-sheet-viewer/task-sheet-viewer.coffee
- ./src/app/tasks/modals/modals.coffee
- ./src/app/tasks/modals/upload-submission-modal/upload-submission-modal.coffee
- ./src/app/tasks/modals/grade-task-modal/grade-task-modal.coffee
- ./src/app/tasks/modals/plagiarism-report-modal/plagiarism-report-modal.coffee
- ./src/app/tasks/task-definition-selector/task-definition-selector.coffee
- ./src/app/tasks/task-plagiarism-report-viewer/task-plagiarism-report-viewer.coffee
- ./src/app/tasks/task-plagiarism-file-viewer/task-plagiarism-file-viewer.coffee
- ./src/app/tasks/project-tasks-list/project-tasks-list.coffee
- ./src/app/tasks/task-ilo-alignment/task-ilo-alignment-rater/task-ilo-alignment-rater.coffee
- ./src/app/tasks/task-ilo-alignment/modals/task-ilo-alignment-modal/task-ilo-alignment-modal.coffee
- ./src/app/tasks/task-ilo-alignment/modals/task-ilo-alignment.coffee
- ./src/app/tasks/task-ilo-alignment/task-ilo-alignment-editor/task-ilo-alignment-editor.coffee
- ./src/app/tasks/task-ilo-alignment/task-ilo-alignment.coffee
- ./src/app/tasks/task-ilo-alignment/task-ilo-alignment-viewer/task-ilo-alignment-viewer.coffee
- ./src/app/tasks/task-definition-editor/task-definition-editor.coffee
- ./src/app/tasks/task-submission-wizard/task-submission-wizard.coffee
- ./src/app/config/privacy-policy/privacy-policy.coffee
- ./src/app/config/config.coffee
- ./src/app/config/runtime/runtime.coffee
- ./src/app/config/root-controller/root-controller.coffee
- ./src/app/config/local-storage/local-storage.coffee
- ./src/app/config/routing/routing.coffee
- ./src/app/config/vendor-dependencies/vendor-dependencies.coffee
- ./src/app/config/analytics/analytics.coffee
- ./src/app/config/debug/debug.coffee
- ./src/app/projects/projects.coffee
- ./src/app/projects/project-progress-dashboard/project-progress-dashboard.coffee
- ./src/app/projects/states/states.coffee
- ./src/app/projects/states/all/directives/directives.coffee
- ./src/app/projects/states/all/directives/all-projects-list/all-projects-list.coffee
- ./src/app/projects/states/all/all.coffee
- ./src/app/projects/states/groups/groups.coffee
- ./src/app/projects/states/feedback/feedback.coffee
- ./src/app/projects/states/dashboard/directives/directives.coffee
- ./src/app/projects/states/dashboard/directives/progress-dashboard/progress-dashboard.coffee
- ./src/app/projects/states/dashboard/directives/student-task-list/student-task-list.coffee
- ./src/app/projects/states/dashboard/directives/task-dashboard/directives/task-assessment-card/task-assessment-card.coffee
- ./src/app/projects/states/dashboard/directives/task-dashboard/directives/directives.coffee
- ./src/app/projects/states/dashboard/directives/task-dashboard/directives/task-outcomes-card/task-outcomes-card.coffee
- ./src/app/projects/states/dashboard/directives/task-dashboard/directives/task-submission-card/task-submission-card.coffee
- ./src/app/projects/states/dashboard/directives/task-dashboard/directives/task-due-card/task-due-card.coffee
- ./src/app/projects/states/dashboard/directives/task-dashboard/directives/task-status-card/task-status-card.coffee
- ./src/app/projects/states/dashboard/directives/task-dashboard/task-dashboard.coffee
- ./src/app/projects/states/dashboard/dashboard.coffee
- ./src/app/projects/states/outcomes/outcomes.coffee
- ./src/app/projects/states/portfolio/directives/portfolio-review-step/portfolio-review-step.coffee
- ./src/app/projects/states/portfolio/directives/directives.coffee
- ./src/app/projects/states/portfolio/directives/portfolio-learning-summary-report-step/portfolio-learning-summary-report-step.coffee
- ./src/app/projects/states/portfolio/directives/portfolio-add-extra-files-step/portfolio-add-extra-files-step.coffee
- ./src/app/projects/states/portfolio/directives/portfolio-grade-select-step/portfolio-grade-select-step.coffee
- ./src/app/projects/states/portfolio/directives/portfolio-welcome-step/portfolio-welcome-step.coffee
- ./src/app/projects/states/portfolio/directives/portfolio-tasks-step/portfolio-tasks-step.coffee
- ./src/app/projects/states/portfolio/portfolio.coffee
- ./src/app/projects/states/index/index.coffee
- ./src/app/projects/states/tutorials/tutorials.coffee
- ./src/app/projects/project-outcome-alignment/project-outcome-alignment.coffee
- ./src/app/admin/modals/teaching-period-settings-modal/teaching-period-settings-modal.coffee
- ./src/app/admin/modals/create-break-modal/create-break-modal.coffee
- ./src/app/admin/modals/rollover-teaching-period-modal/rollover-teaching-period-modal.coffee
- ./src/app/admin/modals/modals.coffee
- ./src/app/admin/modals/user-notification-settings-modal/user-notification-settings-modal.coffee
- ./src/app/admin/modals/user-settings-modal/user-settings-modal.coffee
- ./src/app/admin/modals/create-unit-modal/create-unit-modal.coffee
- ./src/app/admin/states/states.coffee
- ./src/app/admin/states/units/units.coffee
- ./src/app/admin/states/users/users.coffee
- ./src/app/admin/states/teaching-periods/teaching-period-list/teaching-period-list.coffee
- ./src/app/admin/states/teaching-periods/teaching-period-edit/directives/directives.coffee
- ./src/app/admin/states/teaching-periods/teaching-period-edit/directives/teaching-period-breaks/teaching-period-breaks.coffee
- ./src/app/admin/states/teaching-periods/teaching-period-edit/directives/teaching-period-details-editor/teaching-period-details-editor.coffee
- ./src/app/admin/states/teaching-periods/teaching-period-edit/directives/teaching-period-units/teaching-period-units.coffee
- ./src/app/admin/states/teaching-periods/teaching-period-edit/edit-teaching-period.coffee
- ./src/app/admin/admin.coffee
- ./src/app/groups/group-selector/group-selector.coffee
- ./src/app/groups/group-set-manager/group-set-manager.coffee
- ./src/app/groups/group-member-contribution-assigner/group-member-contribution-assigner.coffee
- ./src/app/groups/group-member-list/group-member-list.coffee
- ./src/app/groups/group-set-selector/group-set-selector.coffee
- ./src/app/groups/tutor-group-manager/tutor-group-manager.coffee
- ./src/app/groups/groups.coffee
- ./src/app/groups/student-group-manager/student-group-manager.coffee
- ./src/app/units/modals/unit-student-enrolment-modal/unit-student-enrolment-modal.coffee
- ./src/app/units/modals/modals.coffee
- ./src/app/units/modals/unit-ilo-edit-modal/unit-ilo-edit-modal.coffee
- ./src/app/units/units.coffee
- ./src/app/units/states/states.coffee
- ./src/app/units/states/plagiarism/directives/directives.coffee
- ./src/app/units/states/plagiarism/directives/unit-student-plagiarism-list/unit-student-plagiarism-list.coffee
- ./src/app/units/states/plagiarism/plagiarism.coffee
- ./src/app/units/states/tasks/inbox/directives/directives.coffee
- ./src/app/units/states/tasks/inbox/inbox.coffee
- ./src/app/units/states/tasks/tasks.coffee
- ./src/app/units/states/tasks/viewer/directives/directives.coffee
- ./src/app/units/states/tasks/viewer/directives/task-sheet-view/task-sheet-view.coffee
- ./src/app/units/states/tasks/viewer/directives/task-details-view/task-details-view.coffee
- ./src/app/units/states/tasks/viewer/directives/unit-task-list/unit-task-list.coffee
- ./src/app/units/states/tasks/viewer/viewer.coffee
- ./src/app/units/states/tasks/definition/definition.coffee
- ./src/app/units/states/tasks/offline/offline.coffee
- ./src/app/units/states/portfolios/portfolios.coffee
- ./src/app/units/states/all/directives/all-units-list/all-units-list.coffee
- ./src/app/units/states/all/directives/directives.coffee
- ./src/app/units/states/all/all.coffee
- ./src/app/units/states/groups/groups.coffee
- ./src/app/units/states/edit/directives/directives.coffee
- ./src/app/units/states/edit/directives/unit-group-set-editor/unit-group-set-editor.coffee
- ./src/app/units/states/edit/directives/unit-details-editor/unit-details-editor.coffee
- ./src/app/units/states/edit/directives/unit-staff-editor/unit-staff-editor.coffee
- ./src/app/units/states/edit/directives/unit-ilo-editor/unit-ilo-editor.coffee
- ./src/app/units/states/edit/directives/unit-tasks-editor/unit-tasks-editor.coffee
- ./src/app/units/states/edit/edit.coffee
- ./src/app/units/states/rollover/directives/directives.coffee
- ./src/app/units/states/rollover/directives/unit-dates-selector/unit-dates-selector.coffee
- ./src/app/units/states/rollover/rollover.coffee
- ./src/app/units/states/index/index.coffee
- ./src/app/units/states/students-list/students-list.coffee
- ./src/app/units/states/analytics/directives/directives.coffee
- ./src/app/units/states/analytics/directives/unit-achievement-stats/unit-achievement-stats.coffee
- ./src/app/units/states/analytics/directives/task-status-stats/task-status-stats.coffee
- ./src/app/units/states/analytics/directives/unit-stats-download/unit-stats-download.coffee
- ./src/app/units/states/analytics/directives/task-completion-stats/task-completion-stats.coffee
- ./src/app/units/states/analytics/directives/unit-target-grade-stats/unit-target-grade-stats.coffee
- ./src/app/units/states/analytics/analytics.coffee
- ./src/app/common/filters/filters.coffee
- ./src/app/common/long-press/on-long-press.coffee
- ./src/app/common/content-editable/content-editable.coffee
- ./src/app/common/alert-list/alert-list.coffee
- ./src/app/common/modals/confirmation-modal/confirmation-modal.coffee
- ./src/app/common/modals/comments-modal/comments-modal.coffee
- ./src/app/common/modals/modals.coffee
- ./src/app/common/modals/csv-result-modal/csv-result-modal.coffee
- ./src/app/common/modals/progress-modal/progress-modal.coffee
- ./src/app/common/grade-icon/grade-icon.coffee
- ./src/app/common/file-uploader/file-uploader.coffee
- ./src/app/common/common.coffee
- ./src/app/common/header/header.coffee
- ./src/app/common/header/unit-dropdown/unit-dropdown.coffee
- ./src/app/common/services/header-service.coffee
- ./src/app/common/services/grade-service.coffee
- ./src/app/common/services/date-service.coffee
- ./src/app/common/services/group-service.coffee
- ./src/app/common/services/unit-service.coffee
- ./src/app/common/services/project-service.coffee
- ./src/app/common/services/alert-service.coffee
- ./src/app/common/services/media-service.coffee
- ./src/app/common/services/task-service.coffee
- ./src/app/common/services/recorder-service.coffee
- ./src/app/common/services/outcome-service.coffee
- ./src/app/common/services/listener-service.coffee
- ./src/app/common/services/analytics-service.coffee
- ./src/app/common/services/services.coffee
- ./src/app/sessions/auth/http-auth-injector.coffee
- ./src/app/sessions/auth/auth.coffee
- ./src/app/sessions/auth/roles/roles.coffee
- ./src/app/sessions/auth/roles/if-role.coffee
- ./src/app/sessions/current-user/current-user.coffee
- ./src/app/sessions/sessions.coffee
- ./src/app/sessions/states/states.coffee
- ./src/app/sessions/states/sign-in/sign-in.coffee
- ./src/app/sessions/states/sign-out/sign-out.coffee
- ./src/app/sessions/cookies/cookies.coffee
- ./src/app/api/resource-plus.coffee
- ./src/app/api/models/task.coffee
- ./src/app/api/models/task-similarity.coffee
- ./src/app/api/models/intended-learning-outcome.coffee
- ./src/app/api/models/group-set.coffee
- ./src/app/api/models/tutor.coffee
- ./src/app/api/models/task-feedback.coffee
- ./src/app/api/models/group.coffee
- ./src/app/api/models/task-comment.coffee
- ./src/app/api/models/unit-role.coffee
- ./src/app/api/models/task-completion-csv.coffee
- ./src/app/api/models/project.coffee
- ./src/app/api/models/models.coffee
- ./src/app/api/models/teaching-period.coffee
- ./src/app/api/models/group-member.coffee
- ./src/app/api/models/tutorial.coffee
- ./src/app/api/models/task-alignment.coffee
- ./src/app/api/models/portfolion-submission.coffee
- ./src/app/api/models/user.coffee
- ./src/app/api/models/task-definition.coffee
- ./src/app/api/models/user-role.coffee
- ./src/app/api/models/rollover-unit.coffee
- ./src/app/api/models/learning-alignments.coffee
- ./src/app/api/models/students.coffee
- ./src/app/api/models/convenor.coffee
- ./src/app/api/models/break.coffee
- ./src/app/api/models/unit.coffee
- ./src/app/api/api.coffee
- ./src/app/errors/errors.coffee
- ./src/app/errors/states/states.coffee
- ./src/app/errors/states/unauthorised/unauthorised.coffee
- ./src/app/errors/states/not-found/not-found.coffee
- ./src/app/errors/states/timeout/timeout.coffee
If you will be using Docker, follow the instructions there.
Before you get started, make sure you have the Doubtfire API up and running. You will need to do this before continuing.
First, clone the web repository, and change to the root directory:
$ git clone https://github.com/doubtfire-lms/doubtfire-web.git
$ cd ./doubtfire-web
You can automate the installation process by running the automated setup script:
$ ./setup.sh
Or, you can continue following the below steps to manually install doubtfire-web
.
Install Node.js either by downloading it and installing it manually, or via Homebrew on OS X:
$ brew install node
or by using apt-get
on Linux:
$ curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
$ sudo apt-get install nodejs
Install Ruby SASS:
$ gem install sass
If gem
fails, you should read the Doubfire API README to install ruby. If you are not using rbenv
, e.g., using Docker instead, you may need to prepend sudo
to the above commands to have root write access.
If using rbenv
, rehash to ensure each of the gems are on your PATH
:
$ rbenv rehash
Install all node dependencies using npm
, as well as grunt-cli globally:
$ npm install
Note: You may need to install grunt-cli
globally in Linux using sudo
.
Lastly, to compile and run a watch server and web server, use npm start
:
$ npm start
This will automatically run the angular 1 grunt watch
, and the angular 7 ng serve
.
You can then navigate to the Doubtfire web interface at http://localhost:8000.
To compile the front-end, ensure doubtfire-api
is placed as a sibling directory to doubtfire-web
, then run:
$ cd /path/to/repos
$ ls
doubtfire-api doubtfire-web
$ cd ./doubtfire-api
$ grunt deploy
You may prefix this command with the following environment variables:
DF_API_URL
- the URL of the API (e.g.,https://doubtfire.com/api
). This will default towindow.location.host
if not set and dynamically generate a URL.DF_EXTERNAL_NAME
- a new name that removes references to the Doubtfire name should you so want to not use such its original name (😢).
Doubtfire Web is an Angular application built using Bootstrap. It uses many Open Source libraries, which you can read up on:
- Lodash
- Moment.js
- Font Awesome
- UI Router
- UI Bootstrap
- UI Select
- NVD3 Charts
- Angular X-Editable
- Angular Filters
- Angular Markdown Filter
Refer to CONTRIBUTING.md
Licensed under GNU Affero General Public License (AGPL) v3