~azzar1/unity/add-show-desktop-key : revision 1552

1

.. IVLE - Informatics Virtual Learning Environment

2

3

4

.. This program is free software; you can redistribute it and/or modify

5

it under the terms of the GNU General Public License as published by

6

the Free Software Foundation; either version 2 of the License, or

7

(at your option) any later version.

8

9

.. This program is distributed in the hope that it will be useful,

10

but WITHOUT ANY WARRANTY; without even the implied warranty of

11

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

12

GNU General Public License for more details.

13

14

.. You should have received a copy of the GNU General Public License

15

along with this program; if not, write to the Free Software

16

Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

17

18

.. _ref-user-roles:

19

20

**********

21

User roles

22

**********

23

24

IVLE users can be given roles, giving them additional power in the system. The

25

roles are centered around a typical university teaching structure, with

26

tutors, lecturers and system administrators.

27

28

This page lists precisely what is permitted by each role.

29

30

Note that the roles are hierarchical. Being a member of a role implies all of

31

the powers of lesser roles.

32

33

Most roles are *per-offering*, which means the user only has the powers of

34

that role when dealing with a specific offering of a subject. (For example, a

35

lecturer of subject "ivle-101" for 2009 semester 1 is just an ordinary user

36

with respect to any other subject, or any other offering of "ivle-101").

37

38

Ordinary users

39

--------------

40

41

This is the default role for any user. Note that we do not refer to "ordinary

42

users" as "students", because "student" implies an enrolment in a particular

43

offering.

44

45

All users have the ability to:

46

47

* Store and edit files in the file system,

48

* Execute Python code in the Python console,

49

* Serve files privately and publically,

50

* View and edit some of their own details (e.g., can edit display name, but

51

not full name, which is required to be the user's formal name).

52

53

Students

54

--------

55

56

The role of "student" is offering-specific. Any user enrolled in an offering

57

is a "student" in that offering.

58

59

In addition to ordinary users, students have the ability to:

60

61

* View the "subject page" for the offering,

62

* View any worksheet in the offering, and its exercises,

63

* Submit attempts at any exercise in any worksheet in the offering,

64

* Receive a mark for worksheet completion in the offering,

65

* Submit a solo project for the offering,

66

* Submit a group project for the offering, on behalf of any group they are in.

67

68

Tutors

69

------

70

71

The role of "tutor" is offering-specific. Users may be enrolled in an offering

72

as "tutor" by a lecturer or admin.

73

74

In addition to students, tutors have the ability to:

75

76

* Enrol a user in the offering as a student, if the system administrator has

77

allowed it (see ``tutors_can_enrol_students`` under

78

:ref:`policy configuration <ref-configuration-policy>`). This is

79

**disabled** by default,

80

* Create and edit worksheets for the offering, if the system administrator has

81

allowed it (see ``tutors_can_edit_worksheets`` under

82

:ref:`policy configuration <ref-configuration-policy>`). This is **enabled**

83

by default,

84

* Create and edit exercises *for any offering* (as exercises are not

85

offering-specific), if the system administrator has allowed it (see

86

``tutors_can_edit_worksheets`` under :ref:`policy configuration

87

<ref-configuration-policy>`). This is **enabled** by default.

88

89

Lecturers

90

---------

91

92

The role of "lecturer" is offering-specific. Users may be enrolled in an

93

offering as "lecturer" by an admin.

94

95

In addition to tutors, lecturers have the ability to:

96

97

* Enrol a user in the offering, as a student or tutor,

98

* Create and edit worksheets for the offering

99

* Create and edit exercises *for any offering* (as exercises are not

100

offering-specific),

101

* Edit the details of the offering (such as description and URL),

102

* Create and edit projects and project sets for the offering,

103

* Create project groups, and add/remove students from them.

104

105

Admins

106

------

107

108

The ultimate role is "admin". This is a site-wide role (it is not specific to

109

any offering).

110

111

Admins have the ability to:

112

113

* Do anything a lecturer can do in any offering,

114

* See stack traces when IVLE generates an internal server error (normal users

115

see a generic error page),

116

* See a list of all users in the system,

117

* View and edit all details for all users, including "fixed" fields such as

118

full name, and change any user's password without knowing the old one,

119

* Enrol a user as a lecturer in any offering,

120

* Upgrade any user to admin status, or revoke admin status,

121

* Disable (ban) any user from accessing the system at all, or enable a user,

122

* See a list of all subjects and offerings in the system,

123

* Create new subjects and offerings,

124

* Edit the details of any subject (nb: not just an offering),

125

* Create new semesters,

126

* Change which subject/semester an offering is bound to.