micro-users 1.0.0__py3-none-any.whl

micro_users-1.0.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 DeBeski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

micro_users-1.0.0.dist-info/METADATA

@@ -0,0 +1,114 @@
+Metadata-Version: 2.1
+Name: micro-users
+Version: 1.0.0
+Summary: Django user management app with abstract user, permissions, and activity logging
+Home-page: https://github.com/debeski/micro-users
+Author: DeBeski
+Author-email: DeBeski <debeski1@gmail.com>
+License: MIT
+Keywords: django,users,permissions,authentication
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django (>=5.17)
+Requires-Dist: django-crispy-forms (>=2.4)
+Requires-Dist: django-tables2 (>=2.7.5)
+Requires-Dist: django-filter (>=25.1)
+Requires-Dist: pillow (>=11.0)
+Requires-Dist: babel (>=2.1)
+
+# Micro Users - Django User Management App
+
+[![PyPI version](https://badge.fury.io/py/micro-users.svg)](https://pypi.org/project/micro-users/)
+
+A lightweight, reusable Django app providing user management with abstract user, permissions, localization, and activity logging.
+
+## Features
+- Custom AbstractUser model
+- User permissions system  
+- Activity logging (login/logout tracking)
+- Localization support
+- Admin interface integration
+- CRUD views and templates
+- Filtering and tabulation
+
+## Installation
+
+```bash
+pip install git+https://github.com/debeski/micro-users.git
+# OR local
+pip install micro-users
+```
+
+## Configuration
+
+1. Add to `INSTALLED_APPS`:
+```python
+INSTALLED_APPS = [
+    ...
+    'django_tables2',
+    'django_filters', 
+    'crispy_forms',
+    'users',  # Add this
+]
+```
+
+2. Set custom user model in settings.py:
+```python
+AUTH_USER_MODEL = 'users.User'
+```
+
+3. Include URLs in your main project folder `urls.py`:
+```python
+urlpatterns = [
+    ...
+    path('users/', include('users.urls')),
+]
+```
+
+4. make migrations and migrate:
+```bash
+python manage.py makemigrations users
+python manage.py migrate users
+```
+
+## Requirements
+- Python 3.9+
+- Django 5.1+
+- See setup.py for full dependencies
+
+## Structure
+```
+users/
+├── models.py      # User model, permissions, activity logs
+├── views.py       # CRUD operations
+├── urls.py        # URL routing
+├── admin.py       # Admin integration
+├── templates/     # HTML templates
+└── migrations/    # Database migrations
+```
+```
+
+## **Directory structure:**
+```
+micro-users/
+├── users/          # This is the actual package name
+│   ├── __init__.py
+│   ├── models.py
+│   ├── views.py
+│   ├── urls.py
+│   ├── admin.py
+│   └── templates/
+├── setup.py
+└── README.md
+```

micro_users-1.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+users/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+users/admin.py,sha256=VF0V6hQ9Obcdinnjb8nBHaknas2p3O5w-6yAJ-DeARQ,636
+users/apps.py,sha256=Xb1nGvCl08KaUVqcUG82-jYdG6-KTVjaw_lgr5GIuYY,1133
+users/filters.py,sha256=9-yrWBF-CdWb1nrAhmifWb1AHI0z4LQma1uR_9jLr2U,4797
+users/forms.py,sha256=q3kVpGKEunYXuGNSBl3h_I-Q8hdD_7nru1lx9vMGoLA,18356
+users/models.py,sha256=KX_6LoiNJN6PCTFOuuGp5so4CNn5pAh1Vpaigv4fKk4,2060
+users/signals.py,sha256=5Kd3KyfPT6740rvwZj4vy1yXsmjVhmaQ__RB8p5R5aE,1336
+users/tables.py,sha256=JS3fvZvwzcNPGAH1LfCCUNnuQXgauDnB--rFt4okC0I,1717
+users/urls.py,sha256=gmk_ZkSg9Bj-fUpIRACL_X7MEADTgZ7uvmbvXoAo5fo,956
+users/views.py,sha256=yfzWkIDha66YK-Rgz7GH7MhQsupSCojf59C7fBqkppI,7209
+micro_users-1.0.0.dist-info/LICENSE,sha256=Fco89ULLSSxKkC2KKnx57SaT0R7WOkZfuk8IYcGiN50,1063
+micro_users-1.0.0.dist-info/METADATA,sha256=NUdccS9etYjBfjthrCZ48Dz1Vp-x0irUmnCFycIPRWs,2921
+micro_users-1.0.0.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
+micro_users-1.0.0.dist-info/top_level.txt,sha256=tWT24ZcWau2wrlbpU_h3mP2jRukyLaVYiyHBuOezpLQ,6
+micro_users-1.0.0.dist-info/RECORD,,

micro_users-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.40.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

micro_users-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+users

users/admin.py

@@ -0,0 +1,18 @@
+# Imports of the required python modules and libraries
+######################################################
+from django.contrib import admin
+from django.contrib.auth.admin import UserAdmin
+from django.contrib.auth import get_user_model
+from django.contrib.auth.models import Group
+
+User = get_user_model()
+
+class CustomUserAdmin(UserAdmin):
+    model = User
+    list_display = ['username', 'email', 'is_staff', 'is_active', 'phone', 'occupation']
+    list_filter = ['is_staff', 'is_active']
+    search_fields = ['username', 'email']
+    ordering = ['username']
+
+admin.site.register(User, CustomUserAdmin)
+admin.site.unregister(Group)

users/apps.py

@@ -0,0 +1,30 @@
+# Imports of the required python modules and libraries
+######################################################
+from django.apps import AppConfig
+
+def custom_permission_str(self):
+    """Custom Arabic translations for Django permissions"""
+    model_name = str(self.content_type)
+    permission_name = str(self.name)
+
+    # Translate default permissions
+    if "Can add" in permission_name:
+        permission_name = permission_name.replace("Can add", " إضافة ")
+    elif "Can change" in permission_name:
+        permission_name = permission_name.replace("Can change", " تعديل ")
+    elif "Can delete" in permission_name:
+        permission_name = permission_name.replace("Can delete", " حذف ")
+    elif "Can view" in permission_name:
+        permission_name = permission_name.replace("Can view", " عرض ")
+
+    return f"{permission_name}"
+
+
+class UsersConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'users'
+    verbose_name = "المستخدمين"
+
+    def ready(self):
+        from django.contrib.auth.models import Permission
+        Permission.__str__ = custom_permission_str

users/filters.py

@@ -0,0 +1,120 @@
+# Imports of the required python modules and libraries
+######################################################
+import django_filters
+from django.contrib.auth import get_user_model
+from crispy_forms.helper import FormHelper
+from crispy_forms.layout import Layout, Row, Column, Field, HTML
+from django.db.models import Q
+from .models import UserActivityLog
+
+User = get_user_model()  # Use custom user model
+
+class UserFilter(django_filters.FilterSet):
+    keyword = django_filters.CharFilter(
+        method='filter_keyword',
+        label='',
+    )
+
+    class Meta:
+        model = User
+        fields = []
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.form.helper = FormHelper()
+        self.form.helper.form_method = 'GET'
+        self.form.helper.form_class = 'form-inline'
+        self.form.helper.form_show_labels = False
+        self.form.helper.layout = Layout(
+            Row(
+                Column(Field('keyword', placeholder="البحث"), css_class='form-group col-auto flex-fill'),
+                Column(HTML('<button type="submit" class="btn btn-secondary w-100"><i class="bi bi-search bi-font text-light me-2"></i>بحـــث</button>'), css_class='col-auto text-center'),
+                Column(HTML('{% if request.GET and request.GET.keys|length > 1 %} <a href="{% url "manage_users" %}" class="btn btn-warning bi-font">clear</a> {% endif %}'), css_class='form-group col-auto text-center'),
+                css_class='form-row'
+            ),
+        )
+
+    def filter_keyword(self, queryset, name, value):
+        """
+        Filter the queryset by matching the keyword in username, email, phone, and occupation.
+        """
+        return queryset.filter(
+            Q(username__icontains=value) |
+            Q(email__icontains=value) |
+            Q(phone__icontains=value) |
+            Q(occupation__icontains=value) |
+            Q(first_name__icontains=value) |
+            Q(last_name__icontains=value)
+        )
+
+
+
+class UserActivityLogFilter(django_filters.FilterSet):
+    keyword = django_filters.CharFilter(
+        method='filter_keyword',
+        label='',
+    )
+
+    year = django_filters.ChoiceFilter(
+        field_name="timestamp__year",
+        lookup_expr="exact",
+        choices=[],
+        empty_label="السنة",
+    )
+
+    class Meta:
+        model = UserActivityLog
+        fields = {
+            'timestamp': ['gte', 'lte'],
+        }
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        
+        # Fetch distinct years dynamically
+        years = UserActivityLog.objects.dates('timestamp', 'year').distinct()
+        self.filters['year'].extra['choices'] = [(year.year, year.year) for year in years]
+
+        self.filters['year'].field.widget.attrs.update({
+            'onchange': 'this.form.submit();'
+        })
+
+        self.form.helper = FormHelper()
+        self.form.helper.form_method = 'GET'
+        self.form.helper.form_class = 'form-inline'
+        self.form.helper.form_show_labels = False
+        
+        self.form.helper.layout = Layout(
+            Row(
+                Column(Field('keyword', placeholder="البحث"), css_class='form-group col-auto flex-fill'),
+                Column(Field('year', placeholder="السنة", dir="rtl"), css_class='form-group col-auto'),
+                Column(
+                    Row(
+                        Column(Field('timestamp__gte', css_class='flatpickr', placeholder="من "), css_class='col-6'),
+                        Column(Field('timestamp__lte', css_class='flatpickr', placeholder="إلى "), css_class='col-6'),
+                    ), 
+                    css_class='col-auto flex-fill'
+                ),
+                Column(HTML('<button type="submit" class="btn btn-secondary w-100"><i class="bi bi-search bi-font text-light me-2"></i>بحـــث</button>'), css_class='col-auto text-center'),
+                Column(HTML('{% if request.GET and request.GET.keys|length > 1 %} <a href="{% url "user_activity_log" %}" class="btn btn-warning bi-font">clear</a> {% endif %}'), css_class='form-group col-auto text-center'),
+                css_class='form-row'
+            ),
+        )
+
+    def filter_keyword(self, queryset, name, value):
+        """
+        Filter the queryset by matching the keyword in username, email, phone, and occupation.
+        """
+        return queryset.filter(
+            Q(user__username__icontains=value) |
+            Q(user__email__icontains=value) |
+            Q(user__profile__phone__icontains=value) |
+            Q(user__profile__occupation__icontains=value) |
+            Q(action__icontains=value) |
+            Q(model_name__icontains=value) |
+            Q(number__icontains=value) |
+            Q(ip_address__icontains=value)
+        )
+
+
+

users/forms.py

@@ -0,0 +1,364 @@
+# Imports of the required python modules and libraries
+######################################################
+from django import forms
+from django.contrib.auth.models import Permission as Permissions
+from django.contrib.auth.forms import UserCreationForm, UserChangeForm, PasswordChangeForm, SetPasswordForm
+from django.contrib.auth import get_user_model
+from crispy_forms.helper import FormHelper
+from crispy_forms.layout import Layout, Field, Div, HTML, Submit
+from crispy_forms.bootstrap import FormActions
+from PIL import Image
+from django.core.exceptions import ValidationError
+from django.utils.translation import gettext_lazy as _
+
+User = get_user_model()
+
+# Custom User Creation form layout
+class CustomUserCreationForm(UserCreationForm):
+    permissions = forms.ModelMultipleChoiceField(
+        queryset=Permissions.objects.all(),
+        required=False,
+        widget=forms.CheckboxSelectMultiple,
+        label="الصلاحيات"
+    )
+
+    class Meta:
+        model = User
+        fields = ["username", "email", "password1", "password2", "first_name", "last_name", "phone", "occupation", "is_staff", "permissions", "is_active"]
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        
+        self.fields["username"].label = "اسم المستخدم"
+        self.fields["email"].label = "البريد الإلكتروني"
+        self.fields["first_name"].label = "الاسم"
+        self.fields["last_name"].label = "اللقب"
+        self.fields["is_staff"].label = "صلاحيات انشاء و تعديل المستخدمين"
+        self.fields["password1"].label = "كلمة المرور"
+        self.fields["password2"].label = "تأكيد كلمة المرور"
+        self.fields["is_active"].label = "تفعيل الحساب"
+
+        # Help Texts
+        self.fields["username"].help_text = "اسم المستخدم يجب أن يكون فريدًا، 50 حرفًا أو أقل. فقط حروف، أرقام و @ . + - _"
+        self.fields["email"].help_text = "أدخل عنوان البريد الإلكتروني الصحيح"
+        self.fields["is_staff"].help_text = "يحدد ما إذا كان بإمكان المستخدم الوصول إلى قسم ادارة المستخدمين."
+        self.fields["is_active"].help_text = "يحدد ما إذا كان يجب اعتبار هذا الحساب نشطًا."
+        self.fields["password1"].help_text = "كلمة المرور يجب ألا تكون مشابهة لمعلوماتك الشخصية، وأن تحتوي على 8 أحرف على الأقل، وألا تكون شائعة أو رقمية بالكامل.."
+        self.fields["password2"].help_text = "أدخل نفس كلمة المرور السابقة للتحقق."
+
+        # Split permissions queryset into two parts for 2 columns
+        permissions_list = list(Permissions.objects.exclude(
+            codename__in=[
+                'add_logentry', 'change_logentry', 'delete_logentry', 'view_logentry',
+                'add_theme', 'change_theme', 'delete_theme', 'view_theme',
+                'add_group', 'change_group', 'delete_group', 'view_group',
+                'add_permission', 'change_permission', 'delete_permission', 'view_permission',
+                'add_permissions', 'change_permissions', 'delete_permissions', 'view_permissions',
+                'add_contenttype', 'change_contenttype', 'delete_contenttype', 'view_contenttype',
+                'add_session', 'change_session', 'delete_session', 'view_session',
+                'add_government', 'delete_government', 'view_government',
+                'add_minister', 'delete_minister', 'view_minister',
+                'add_decreecategory', 'delete_decreecategory', 'view_decreecategory',
+                'add_periodictask', 'change_periodictask', 'delete_periodictask', 'view_periodictask',
+                'add_periodictasks', 'change_periodictasks', 'delete_periodictasks', 'view_periodictasks',
+                'add_clockedschedule', 'change_clockedschedule', 'delete_clockedschedule', 'view_clockedschedule',
+                'add_crontabschedule', 'change_crontabschedule', 'delete_crontabschedule', 'view_crontabschedule',
+                'add_intervalschedule', 'change_intervalschedule', 'delete_intervalschedule', 'view_intervalschedule',
+                'add_solarschedule', 'change_solarschedule', 'delete_solarschedule', 'view_solarschedule',
+                'add_customuser', 'change_customuser', 'delete_customuser', 'view_customuser',
+                'add_useractivitylog', 'change_useractivitylog', 'delete_useractivitylog', 'view_useractivitylog',
+                'download_doc', 'gen_pub_pdf', 'download_doc', 'delete_decree', 'delete_publication', 'delete_objection',
+                'delete_formplus', 'view_decree', 'view_formplus', 'gen_pub_pdf', 'view_publication',
+            ]
+        ))
+        mid_point = len(permissions_list) // 2
+        permissions_right = permissions_list[:mid_point]
+        permissions_left = permissions_list[mid_point:]
+
+        # Create two fields with only one column of permissions each
+        self.fields["permissions_right"] = forms.ModelMultipleChoiceField(
+            queryset=Permissions.objects.filter(id__in=[p.id for p in permissions_right]),
+            required=False,
+            widget=forms.CheckboxSelectMultiple,
+            label="الصلاحيـــات"
+        )
+        self.fields["permissions_left"] = forms.ModelMultipleChoiceField(
+            queryset=Permissions.objects.filter(id__in=[p.id for p in permissions_left]),
+            required=False,
+            widget=forms.CheckboxSelectMultiple,
+            label=""
+        )
+
+        # Use Crispy Forms Layout helper
+        self.helper = FormHelper()
+        self.helper.layout = Layout(
+            "username",
+            "email",
+            "password1",
+            "password2",
+            HTML("<hr>"),
+            Div(
+                Div(Field("first_name", css_class="col-md-6"), css_class="col-md-6"),
+                Div(Field("last_name", css_class="col-md-6"), css_class="col-md-6"),
+                css_class="row"
+            ),
+            Div(
+                Div(Field("phone", css_class="col-md-6"), css_class="col-md-6"),
+                Div(Field("occupation", css_class="col-md-6"), css_class="col-md-6"),
+                css_class="row"
+            ),
+            HTML("<hr>"),
+            Div(
+                Div(Field("permissions_right", css_class="col-md-6"), css_class="col-md-6"),
+                Div(Field("permissions_left", css_class="col-md-6"), css_class="col-md-6"),
+                css_class="row"
+            ),
+            "is_staff",
+            "is_active",
+            FormActions(
+                HTML(
+                    """
+                    <button type="submit" class="btn btn-success">
+                        <i class="bi bi-person-plus-fill text-light me-1 h4"></i>
+                        إضافة
+                    </button>
+                    """
+                ),
+                HTML(
+                    """
+                    <a href="{% url 'manage_users' %}" class="btn btn-secondary">
+                        <i class="bi bi-arrow-return-left text-light me-1 h4"></i> إلغـــاء
+                    </a>
+                    """
+                )
+            )
+        )
+
+    def save(self, commit=True):
+        user = super().save(commit=False)
+        if commit:
+            user.save()
+        # Manually set permissions from both fields
+        user.user_permissions.set(self.cleaned_data["permissions_left"] | self.cleaned_data["permissions_right"])
+        return user
+
+
+# Custom User Editing form layout
+class CustomUserChangeForm(UserChangeForm):
+    permissions = forms.ModelMultipleChoiceField(
+        queryset=Permissions.objects.all(),
+        required=False,
+        widget=forms.CheckboxSelectMultiple,
+        label="الصلاحيات"
+    )
+
+    class Meta:
+        model = User
+        fields = ["username", "email", "first_name", "last_name", "phone", "occupation", "is_staff",  "permissions", "is_active"]
+
+    def __init__(self, *args, **kwargs):
+        user = kwargs.get('instance')
+        super().__init__(*args, **kwargs)
+        
+        # Labels
+        self.fields["username"].label = "اسم المستخدم"
+        self.fields["email"].label = "البريد الإلكتروني"
+        self.fields["first_name"].label = "الاسم الاول"
+        self.fields["last_name"].label = "اللقب"
+        self.fields["is_staff"].label = "صلاحيات انشاء و تعديل المستخدمين"
+        self.fields["is_active"].label = "الحساب مفعل"
+        
+        # Help Texts
+        self.fields["username"].help_text = "اسم المستخدم يجب أن يكون فريدًا، 50 حرفًا أو أقل. فقط حروف، أرقام و @ . + - _"
+        self.fields["email"].help_text = "أدخل عنوان البريد الإلكتروني الصحيح"
+        self.fields["is_staff"].help_text = "يحدد ما إذا كان بإمكان المستخدم الوصول إلى قسم ادارة المستخدمين."
+        self.fields["is_active"].help_text = "يحدد ما إذا كان يجب اعتبار هذا الحساب نشطًا. قم بإلغاء تحديد هذا الخيار بدلاً من الحذف."
+        
+        # Split permissions queryset into two parts for 2 columns
+        permissions_list = list(Permissions.objects.exclude(
+            codename__in=[
+                'add_logentry', 'change_logentry', 'delete_logentry', 'view_logentry',
+                'add_theme', 'change_theme', 'delete_theme', 'view_theme',
+                'add_group', 'change_group', 'delete_group', 'view_group',
+                'add_permission', 'change_permission', 'delete_permission', 'view_permission',
+                'add_permissions', 'change_permissions', 'delete_permissions', 'view_permissions',
+                'add_contenttype', 'change_contenttype', 'delete_contenttype', 'view_contenttype',
+                'add_session', 'change_session', 'delete_session', 'view_session',
+                'add_government', 'delete_government', 'view_government',
+                'add_minister', 'delete_minister', 'view_minister',
+                'add_decreecategory', 'delete_decreecategory', 'view_decreecategory',
+                'add_periodictask', 'change_periodictask', 'delete_periodictask', 'view_periodictask',
+                'add_periodictasks', 'change_periodictasks', 'delete_periodictasks', 'view_periodictasks',
+                'add_clockedschedule', 'change_clockedschedule', 'delete_clockedschedule', 'view_clockedschedule',
+                'add_crontabschedule', 'change_crontabschedule', 'delete_crontabschedule', 'view_crontabschedule',
+                'add_intervalschedule', 'change_intervalschedule', 'delete_intervalschedule', 'view_intervalschedule',
+                'add_solarschedule', 'change_solarschedule', 'delete_solarschedule', 'view_solarschedule',
+                'add_customuser', 'change_customuser', 'delete_customuser', 'view_customuser',
+                'add_useractivitylog', 'change_useractivitylog', 'delete_useractivitylog', 'view_useractivitylog',
+                'download_doc', 'gen_pub_pdf', 'download_doc', 'delete_decree', 'delete_publication', 'delete_objection',
+                'delete_formplus', 'view_decree', 'view_formplus', 'gen_pub_pdf', 'view_publication',
+            ]
+        ))
+        mid_point = len(permissions_list) // 2
+        self.permissions_right = permissions_list[:mid_point]
+        self.permissions_left = permissions_list[mid_point:]
+
+        # Get user's current permissions
+        if user:
+            user_permissions = set(user.user_permissions.all())
+
+            # Set initial values based on user's existing permissions
+            initial_right = [p.id for p in self.permissions_right if p in user_permissions]
+            initial_left = [p.id for p in self.permissions_left if p in user_permissions]
+        else:
+            initial_right = []
+            initial_left = []
+
+        # Create two fields with only one column of permissions each
+        self.fields["permissions_right"] = forms.ModelMultipleChoiceField(
+            queryset=Permissions.objects.filter(id__in=[p.id for p in self.permissions_right]),
+            required=False,
+            widget=forms.CheckboxSelectMultiple,
+            label="الصلاحيـــات",
+            initial=initial_right
+        )
+        self.fields["permissions_left"] = forms.ModelMultipleChoiceField(
+            queryset=Permissions.objects.filter(id__in=[p.id for p in self.permissions_left]),
+            required=False,
+            widget=forms.CheckboxSelectMultiple,
+            label="",
+            initial=initial_left
+        )
+
+        # Use Crispy Forms Layout helper
+        self.helper = FormHelper()
+        self.helper.form_tag = False
+        self.helper.layout = Layout(
+            "username",
+            "email",
+            HTML("<hr>"),
+            Div(
+                Div(Field("first_name", css_class="col-md-6"), css_class="col-md-6"),
+                Div(Field("last_name", css_class="col-md-6"), css_class="col-md-6"),
+                css_class="row"
+            ),
+            Div(
+                Div(Field("phone", css_class="col-md-6"), css_class="col-md-6"),
+                Div(Field("occupation", css_class="col-md-6"), css_class="col-md-6"),
+                css_class="row"
+            ),
+            HTML("<hr>"),
+            Div(
+                Div(Field("permissions_right", css_class="col-md-6"), css_class="col-md-6"),
+                Div(Field("permissions_left", css_class="col-md-6"), css_class="col-md-6"),
+                css_class="row"
+            ),
+            "is_staff",
+            "is_active",
+            FormActions(
+                HTML(
+                    """
+                    <button type="submit" class="btn btn-success">
+                        <i class="bi bi-person-plus-fill text-light me-1 h4"></i>
+                        تحديث
+                    </button>
+                    """
+                ),
+                HTML(
+                    """
+                    <a href="{% url 'manage_users' %}" class="btn btn-secondary">
+                        <i class="bi bi-arrow-return-left text-light me-1 h4"></i> إلغـــاء
+                    </a>
+                    """
+                ),
+                HTML(
+                    """
+                    <button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#resetPasswordModal">
+                        <i class="bi bi-key-fill text-light me-1 h4"></i> إعادة تعيين كلمة المرور
+                    </button>
+                    """
+                )
+            )
+        )
+
+
+    def save(self, commit=True):
+        user = super().save(commit=False)
+        if commit:
+            user.save()
+        # Manually set permissions from both fields
+        user.user_permissions.set(self.cleaned_data["permissions_left"] | self.cleaned_data["permissions_right"])
+        return user
+
+
+# Custom User Reset Password form layout
+class ResetPasswordForm(SetPasswordForm):
+    username = forms.CharField(label="اسم المستخدم", widget=forms.TextInput(attrs={"readonly": "readonly"}))
+
+    def __init__(self, user, *args, **kwargs):
+        super().__init__(user, *args, **kwargs)
+        self.fields['username'].initial = user.username
+        self.helper = FormHelper()
+        self.fields["new_password1"].label = "كلمة المرور الجديدة"
+        self.fields["new_password2"].label = "تأكيد كلمة المرور"
+        self.helper.layout = Layout(
+            Div(
+                Field('username', css_class='col-md-12'),
+                Field('new_password1', css_class='col-md-12'),
+                Field('new_password2', css_class='col-md-12'),
+                css_class='row'
+            ),
+            Submit('submit', 'تغيير كلمة المرور', css_class='btn btn-primary'),
+        )
+
+    def save(self, commit=True):
+        user = super().save(commit=False)
+        if commit:
+            user.save()
+        return user
+
+
+class UserProfileEditForm(forms.ModelForm):
+    class Meta:
+        model = User
+        fields = ['username', 'email', 'first_name', 'last_name', 'phone', 'occupation', 'profile_picture']
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.fields['username'].disabled = True  # Prevent the user from changing their username
+        self.fields['email'].label = "البريد الالكتروني"  # Prevent the user from changing their email
+        self.fields['first_name'].label = "الاسم الاول"
+        self.fields['last_name'].label = "اللقب"
+        self.fields['phone'].label = "رقم الهاتف"
+        self.fields['occupation'].label = "جهة العمل"
+        self.fields['profile_picture'].label = "الصورة الشخصية"
+
+    def clean_profile_picture(self):
+        profile_picture = self.cleaned_data.get('profile_picture')
+
+        # Check if the uploaded file is a valid image
+        if profile_picture:
+            try:
+                img = Image.open(profile_picture)
+                img.verify()  # Verify the image is not corrupt
+                # Check if the image size is within the limits
+                if img.width > 600 or img.height > 600:
+                    raise ValidationError("The image must not exceed 600x600 pixels.")
+            except Exception as e:
+                raise ValidationError("Invalid image file.")
+        return profile_picture
+
+
+class ArabicPasswordChangeForm(PasswordChangeForm):
+    old_password = forms.CharField(
+        label=_('كلمة المرور القديمة'),
+        widget=forms.PasswordInput(attrs={'autocomplete': 'current-password', 'dir': 'rtl'}),
+    )
+    new_password1 = forms.CharField(
+        label=_('كلمة المرور الجديدة'),
+        widget=forms.PasswordInput(attrs={'autocomplete': 'new-password', 'dir': 'rtl'}),
+    )
+    new_password2 = forms.CharField(
+        label=_('تأكيد كلمة المرور الجديدة'),
+        widget=forms.PasswordInput(attrs={'autocomplete': 'new-password', 'dir': 'rtl'}),
+    )

users/models.py

@@ -0,0 +1,40 @@
+# Imports of the required python modules and libraries
+######################################################
+from django.db import models
+from django.contrib.auth.models import AbstractUser
+from django.conf import settings  # Use this to reference the custom user model
+from django.contrib.postgres.fields import JSONField
+
+class CustomUser(AbstractUser):
+    phone = models.CharField(max_length=15, blank=True, null=True, verbose_name="رقم الهاتف")
+    occupation = models.CharField(max_length=100, blank=True, null=True, verbose_name="جهة العمل")
+    profile_picture = models.ImageField(upload_to='profile_pictures/', null=True, blank=True)
+
+    @property
+    def full_name(self):
+        return f"{self.first_name} {self.last_name}".strip()
+
+class UserActivityLog(models.Model):
+    ACTION_TYPES = [
+        ('LOGIN', 'تسجيل دخـول'),
+        ('LOGOUT', 'تسجيل خـروج'),
+        ('CREATE', 'انشـاء'),
+        ('UPDATE', 'تعديـل'),
+        ('DELETE', 'حــذف'),
+        ('VIEW', 'عـرض'),
+        ('DOWNLOAD', 'تحميل'),
+        ('CONFIRM', 'تأكيـد'),
+        ('REJECT', 'رفــض'),
+    ]
+
+    user = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.SET_NULL, verbose_name="اسم المستخدم", null=True, blank=True)
+    action = models.CharField(max_length=10, choices=ACTION_TYPES, verbose_name="العملية")
+    model_name = models.CharField(max_length=100, blank=True, null=True, verbose_name="القسم")
+    object_id = models.IntegerField(blank=True, null=True, verbose_name="ID")
+    number = models.CharField(max_length=50, null=True, blank=True, verbose_name="المستند")
+    ip_address = models.GenericIPAddressField(blank=True, null=True, verbose_name="عنوان IP")
+    user_agent = models.TextField(blank=True, null=True, verbose_name="agent")
+    timestamp = models.DateTimeField(auto_now_add=True, verbose_name="الوقت")
+
+    def __str__(self):
+        return f"{self.user} {self.action} {self.model_name or 'General'} at {self.timestamp}"

users/signals.py

@@ -0,0 +1,41 @@
+# Imports of the required python modules and libraries
+######################################################
+from django.dispatch import receiver
+from django.utils.timezone import now
+from .models import UserActivityLog
+from django.contrib.auth.signals import user_logged_in, user_logged_out
+
+@receiver(user_logged_in)
+def log_login(sender, request, user, **kwargs):
+    """Log user login actions."""
+    UserActivityLog.objects.create(
+        user=user,
+        action="LOGIN",
+        model_name="مصادقة",
+        object_id=None,
+        ip_address=get_client_ip(request),
+        user_agent=request.META.get("HTTP_USER_AGENT", ""),
+        timestamp=now(),
+    )
+
+@receiver(user_logged_out)
+def log_logout(sender, request, user, **kwargs):
+    """Log user logout actions."""
+    UserActivityLog.objects.create(
+        user=user,
+        action="LOGOUT",
+        model_name="مصادقة",
+        object_id=None,
+        ip_address=get_client_ip(request),
+        user_agent=request.META.get("HTTP_USER_AGENT", ""),
+        timestamp=now(),
+    )
+
+def get_client_ip(request):
+    """Extract client IP address from request."""
+    x_forwarded_for = request.META.get("HTTP_X_FORWARDED_FOR")
+    if x_forwarded_for:
+        ip = x_forwarded_for.split(",")[0]
+    else:
+        ip = request.META.get("REMOTE_ADDR")
+    return ip

users/tables.py

@@ -0,0 +1,40 @@
+# Imports of the required python modules and libraries
+######################################################
+import django_tables2 as tables
+from django.contrib.auth import get_user_model
+from .models import UserActivityLog
+
+User = get_user_model()  # Use custom user model
+
+class UserTable(tables.Table):
+    username = tables.Column(verbose_name="اسم المستخدم")
+    email = tables.Column(verbose_name="البريد الالكتروني")
+    full_name = tables.Column(verbose_name="الاسم بالكامل", orderable=False,)
+    last_login = tables.DateColumn(
+        format="H:i Y-m-d ",  # This is the format you want for the timestamp
+        verbose_name="اخر دخول"
+    )
+    # Action buttons for edit and delete (summoned column)
+    actions = tables.TemplateColumn(
+        template_name='users/user_actions.html',
+        orderable=False,
+        verbose_name=''
+    )
+
+    class Meta:
+        model = User
+        template_name = "django_tables2/bootstrap5.html"
+        fields = ("username", "email", "full_name", "phone", "occupation", "is_staff", "is_active","last_login", "actions")
+        attrs = {'class': 'table table-hover align-middle'}
+
+class UserActivityLogTable(tables.Table):
+    user = tables.Column(verbose_name="اسم الدخول")
+    timestamp = tables.DateColumn(
+        format="H:i Y-m-d ",  # This is the format you want for the timestamp
+        verbose_name="وقت العملية"
+    )
+    class Meta:
+        model = UserActivityLog
+        template_name = "django_tables2/bootstrap5.html"
+        fields = ("timestamp", "user", "user.full_name", "action", "model_name", "object_id", "number")
+        attrs = {'class': 'table table-hover align-middle'}

users/urls.py

@@ -0,0 +1,18 @@
+# Imports of the required python modules and libraries
+######################################################
+from django.urls import path
+from . import views
+from django.contrib.auth import views as auth_views
+
+urlpatterns = [
+    path('login/', auth_views.LoginView.as_view(), name='login'),
+    path('logout/', auth_views.LogoutView.as_view(), name='logout'),
+    path("users/", views.UserListView.as_view(), name="manage_users"),
+    path('users/create/', views.create_user, name='create_user'),
+    path('users/edit/<int:user_id>/', views.edit_user, name='edit_user'),
+    path('users/delete/<int:user_id>/', views.delete_user, name='delete_user'),
+    path("profile", views.user_profile, name="user_profile"),
+    path('profile/edit/', views.edit_profile, name='edit_profile'),
+    path("logs/", views.UserActivityLogView.as_view(), name="user_activity_log"),
+    path('reset_password/<int:user_id>/', views.reset_password, name="reset_password"),
+]

users/views.py

@@ -0,0 +1,198 @@
+# Fundemental imports
+######################################################
+from django.utils import timezone
+from django.contrib import messages
+from django.contrib.auth import get_user_model, update_session_auth_hash
+from django.contrib.auth.decorators import login_required, user_passes_test
+from django.contrib.auth.mixins import LoginRequiredMixin, UserPassesTestMixin
+from django.http import JsonResponse
+from django.shortcuts import render, redirect, get_object_or_404
+from django_tables2 import RequestConfig, SingleTableView
+from django_filters.views import FilterView
+
+# Project imports
+#################
+
+from .signals import get_client_ip
+from .tables import UserTable, UserActivityLogTable
+from .forms import CustomUserCreationForm, CustomUserChangeForm, ArabicPasswordChangeForm, ResetPasswordForm, UserProfileEditForm
+from .filters import UserFilter, UserActivityLogFilter
+from .models import UserActivityLog
+
+User = get_user_model() # Use custom user model
+
+#####################################################################
+
+# Function to recognize staff
+def is_staff(user):
+    return user.is_staff
+
+
+# Function to recognize superuser
+def is_superuser(user):
+    return user.is_superuser 
+
+# Class Function for managing users
+class UserListView(LoginRequiredMixin, UserPassesTestMixin, FilterView, SingleTableView):
+    model = User
+    table_class = UserTable
+    filterset_class = UserFilter  # Set the filter class to apply filtering
+    template_name = "users/manage_users.html"
+    
+    # Restrict access to only staff users
+    def test_func(self):
+        return self.request.user.is_staff
+
+    def get_queryset(self):
+        # Apply the filter and order by any logic you need
+        qs = super().get_queryset().order_by('date_joined')
+        # Apply ordering here if needed, for example:
+        return qs
+
+    def get_context_data(self, **kwargs):
+        context = super().get_context_data(**kwargs)
+        user_filter = self.get_filterset(self.filterset_class)
+
+        # Apply the pagination
+        RequestConfig(self.request, paginate={'per_page': 10}).configure(self.table_class(user_filter.qs))
+        
+        context["filter"] = user_filter
+        context["users"] = user_filter.qs
+        return context
+
+
+# Function for creating a new User
+@user_passes_test(is_staff)
+def create_user(request):
+    
+    if request.method == "POST":
+        form = CustomUserCreationForm(request.POST or None)
+        if form.is_valid():
+            form.save()
+            return redirect("manage_users")
+        else:
+            return render(request, "users/user_form.html", {"form": form})
+    else:
+        form = CustomUserCreationForm()
+    
+    return render(request, "users/user_form.html", {"form": form})
+
+
+# Function for editing an existing User
+@user_passes_test(is_staff)
+def edit_user(request, user_id):
+    user = get_object_or_404(User, id=user_id)
+    form_reset = ResetPasswordForm(user, data=request.POST or None)
+
+    if request.method == "POST":
+        form = CustomUserChangeForm(request.POST, instance=user)
+        if form.is_valid():
+            form.save()
+            return redirect("manage_users")
+        else:
+            # Validation errors will be automatically handled by the form object
+            return render(request, "users/user_form.html", {"form": form, "edit_mode": True, "form_reset": form_reset})
+
+    else:
+        form = CustomUserChangeForm(instance=user)
+
+    return render(request, "users/user_form.html", {"form": form, "edit_mode": True, "form_reset": form_reset})
+
+
+# Function for deleting a User
+@user_passes_test(is_superuser)
+def delete_user(request, user_id):
+    user = get_object_or_404(User, id=user_id)
+    if request.method == "POST":
+        user.delete()
+        UserActivityLog.objects.create(
+            user=request.user,
+            action="DELETE",
+            model_name='مستخدم',
+            object_id=user.pk,
+            number=user.username,  # Save the relevant number
+            timestamp=timezone.now(),
+            ip_address=get_client_ip(request),  # Assuming you have this function
+            user_agent=request.META.get("HTTP_USER_AGENT", ""),
+        )
+        return redirect("manage_users")
+    return redirect("manage_users")  # Redirect instead of rendering a separate page
+
+
+# Class Function for the Log
+class UserActivityLogView(LoginRequiredMixin, UserPassesTestMixin, SingleTableView):
+    model = UserActivityLog
+    table_class = UserActivityLogTable
+    filterset_class = UserActivityLogFilter
+    template_name = "user_activity_log.html"
+
+    def test_func(self):
+        return self.request.user.is_staff  # Only staff can access logs
+    
+    def get_queryset(self):
+        # Order by timestamp descending by default
+        return super().get_queryset().order_by('-timestamp')
+
+    def get_context_data(self, **kwargs):
+        context = super().get_context_data(**kwargs)
+        context["filter"] = self.filterset_class  # Make sure 'filter' is added
+        return context
+
+
+# Function that resets a user password
+@user_passes_test(is_staff)
+def reset_password(request, user_id):
+    user = get_object_or_404(User, id=user_id)
+
+    if request.method == "POST":
+        form = ResetPasswordForm(user=user, data=request.POST)  # ✅ Correct usage with SetPasswordForm
+        if form.is_valid():
+            form.save()
+            return redirect("manage_users")  # Redirect after successful reset
+        else:
+            print("Form errors:", form.errors)  # Debugging
+            return redirect("edit_user", user_id=user_id)  # Redirect to edit user on failure
+    
+    return redirect("manage_users")  # Fallback redirect
+
+
+# Function for the user profile
+@login_required
+def user_profile(request):
+    user = request.user
+    password_form = ArabicPasswordChangeForm(user)
+    if request.method == 'POST':
+        password_form = ArabicPasswordChangeForm(user, request.POST)
+        if password_form.is_valid():
+            password_form.save()
+            update_session_auth_hash(request, password_form.user)  # Prevent user from being logged out
+            messages.success(request, 'تم تغيير كلمة المرور بنجاح!')
+            return redirect('user_profile')
+        else:
+            # Log form errors
+            messages.error(request, "هناك خطأ في البيانات المدخلة")
+            print(password_form.errors)  # You can log or print errors here for debugging
+
+    return render(request, 'users/profile.html', {
+        'user': user,
+        'password_form': password_form
+    })
+
+
+# Function for editing the user profile
+@login_required
+def edit_profile(request):
+    if request.method == 'POST':
+        form = UserProfileEditForm(request.POST, request.FILES, instance=request.user)
+        if form.is_valid():
+            form.save()
+            messages.success(request, 'تم حفظ التغييرات بنجاح')
+            return redirect('user_profile')
+        else:
+            messages.error(request, 'حدث خطأ أثناء حفظ التغييرات')
+
+    else:
+        form = UserProfileEditForm(instance=request.user)
+
+    return render(request, 'users/profile_edit.html', {'form': form})
+