4. User is automatically added as an organization member
12
13
### Editing Users
14
Click a username to view their profile, then "Edit" to change:
15
- Name, email
16
- Active/inactive status
17
- Staff status (access to Super Admin)
18
- Org role assignment
19
20
### Changing Passwords
21
From the user detail page, click "Change Password". Admins can change any user's password. Users can change their own password from their profile page.
22
23
### Deactivating Users
24
Edit the user and uncheck "Active". This prevents login without deleting the account. The user's history and contributions are preserved.
Click "Create Role" to define a custom role with a specific permission set. The permission picker groups permissions by app (Organization, Projects, Pages, Fossil).
41
42
### Initializing Roles
43
If no roles exist, click "Initialize Roles" to create the four predefined roles. This runs the `seed_roles` management command.
44
45
### How Roles Work
46
Each role maps to a Django Group with the same permissions. When a user is assigned a role, their previous role group is removed and the new one added. Permissions are synced automatically.
47
48
## Teams
49
50
Navigate to **Admin > Teams** in the sidebar.
51
52
Teams are groups of users that can be assigned to projects with specific access levels.
53
54
### Creating Teams
55
1. Click "New Team"
56
2. Enter name and description
57
3. Add members from the user list
58
59
### Assigning Teams to Projects
60
1. Go to the project overview
61
2. Click the project name > Teams section
62
3. Click "Add Team"
63
4. Select team and role (read/write/admin)
64
65
## Project Groups
66
67
Navigate to **Admin > Groups** in the sidebar.
68
69
Groups organize related projects together in the sidebar. For example, "Fossil SCM" group might contain the source code repo, forum repo, and docs repo.
70
71
### Creating Groups
72
1. Click "Create Group"
73
2. Enter name and description
74
3. Assign projects to the group via the project edit form
75
76
## Organization Settings
77
78
Navigate to **Admin > Settings** in the sidebar.
79
80
Configure the organization name, website, and description. This appears in the site header and various admin pages.
81
82
## Audit Log
83
84
Navigate to **Admin > Audit Log** in the sidebar.
85
86
Shows all model changes across the application, powered by django-simple-history. Filter by model type to see changes to specific entities.
87
88
## Super Admin
89
90
Navigate to **Admin > Super Admin** in the sidebar.
91
92
This is Django's built-in admin interface. Use it for:
93
- Direct database access to any model
94
- Constance runtime settings
95
- Celery task results and beat schedule
96
- Advanced permission management
97
- Data import/export
98
99
Most day-to-day operations should be done through the main UI, not Super Admin.
100
101
## Project Settings
102
103
Each project has its own settings tab (visible to project admins):