init. 初始化项目，并初步完成前端模板样式

users/admin.py

@@ -0,0 +1,53 @@
+from django.contrib import admin
+from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
+from .models import User
+
+@admin.register(User)
+class UserAdmin(BaseUserAdmin):
+    list_display = ('username', 'cname', 'dept', 'is_active', 'is_staff')
+    list_filter = ('is_active', 'is_staff', 'dept')
+    search_fields = ('username', 'cname')
+    fieldsets = (
+        (None, {'fields': ('username', 'password')}),
+        ('个人信息', {'fields': ('cname', 'dept')}),
+        ('权限', {'fields': ('is_active', 'is_staff', 'is_superuser', 'groups', 'user_permissions')}),
+        ('重要日期', {'fields': ('last_login', 'date_joined')}),
+    )
+    add_fieldsets = (
+        (None, {
+            'classes': ('wide',),
+            'fields': ('username', 'cname', 'password1', 'password2', 'dept'),
+        }),
+    )
+    ordering = ('username',)
+    filter_horizontal = ('groups', 'user_permissions', 'roles')  # 如果 roles 是 ManyToMany
+
+from django.contrib import admin
+from .models import Department
+
+@admin.register(Department)
+class DepartmentAdmin(admin.ModelAdmin):
+    list_display = ('name', 'parent', 'order')
+    list_filter = ('parent',)
+    search_fields = ('name',)
+    ordering = ('order', 'name')
+from django.contrib import admin
+from .models import Role, Permission
+
+@admin.register(Role)
+class RoleAdmin(admin.ModelAdmin):
+    list_display = ('name', 'permission_count')
+    search_fields = ('name',)
+    filter_horizontal = ('permissions',)
+
+    def permission_count(self, obj):
+        return obj.permissions.count()
+    permission_count.short_description = "权限数量"
+
+
+@admin.register(Permission)
+class PermissionAdmin(admin.ModelAdmin):
+    list_display = ('resource', 'action', 'desc')
+    list_filter = ('resource', 'action')
+    search_fields = ('resource', 'desc')
+    ordering = ('resource', 'action')

users/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class UsersConfig(AppConfig):
+    name = 'users'
+    verbose_name = '用户管理'

users/migrations/0001_initial.py

@@ -0,0 +1,80 @@
+# Generated by Django 6.0.3 on 2026-03-24 10:31
+
+import django.contrib.auth.models
+import django.db.models.deletion
+import django.utils.timezone
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('auth', '0012_alter_user_first_name_max_length'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Department',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=100, unique=True, verbose_name='部门名称')),
+                ('order', models.IntegerField(default=0, verbose_name='排序')),
+                ('parent', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.CASCADE, to='users.department', verbose_name='上级部门')),
+            ],
+            options={
+                'verbose_name': '部门',
+                'verbose_name_plural': '部门管理',
+            },
+        ),
+        migrations.CreateModel(
+            name='Permission',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('resource', models.CharField(max_length=50, verbose_name='资源标识')),
+                ('action', models.CharField(choices=[('view', '查看'), ('add', '新增'), ('edit', '编辑'), ('delete', '删除')], max_length=10, verbose_name='操作')),
+                ('desc', models.CharField(max_length=100, verbose_name='描述')),
+            ],
+            options={
+                'unique_together': {('resource', 'action')},
+            },
+        ),
+        migrations.CreateModel(
+            name='Role',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=50, unique=True, verbose_name='角色名称')),
+                ('permissions', models.ManyToManyField(blank=True, to='users.permission')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='User',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('password', models.CharField(max_length=128, verbose_name='password')),
+                ('last_login', models.DateTimeField(blank=True, null=True, verbose_name='last login')),
+                ('is_superuser', models.BooleanField(default=False, help_text='Designates that this user has all permissions without explicitly assigning them.', verbose_name='superuser status')),
+                ('first_name', models.CharField(blank=True, max_length=150, verbose_name='first name')),
+                ('last_name', models.CharField(blank=True, max_length=150, verbose_name='last name')),
+                ('email', models.EmailField(blank=True, max_length=254, verbose_name='email address')),
+                ('is_staff', models.BooleanField(default=False, help_text='Designates whether the user can log into this admin site.', verbose_name='staff status')),
+                ('date_joined', models.DateTimeField(default=django.utils.timezone.now, verbose_name='date joined')),
+                ('username', models.CharField(max_length=30, unique=True, verbose_name='英文名/账号')),
+                ('cname', models.CharField(blank=True, max_length=30, verbose_name='中文名')),
+                ('is_active', models.BooleanField(default=True)),
+                ('groups', models.ManyToManyField(blank=True, help_text='The groups this user belongs to. A user will get all permissions granted to each of their groups.', related_name='user_set', related_query_name='user', to='auth.group', verbose_name='groups')),
+                ('user_permissions', models.ManyToManyField(blank=True, help_text='Specific permissions for this user.', related_name='user_set', related_query_name='user', to='auth.permission', verbose_name='user permissions')),
+                ('dept', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='users.department', verbose_name='所属部门')),
+                ('roles', models.ManyToManyField(blank=True, to='users.role')),
+            ],
+            options={
+                'verbose_name': 'user',
+                'verbose_name_plural': 'users',
+                'abstract': False,
+            },
+            managers=[
+                ('objects', django.contrib.auth.models.UserManager()),
+            ],
+        ),
+    ]

users/models.py

@@ -0,0 +1,59 @@
+from django.contrib.auth.models import PermissionsMixin, AbstractUser
+from django.db import models
+
+
+# Create your models here.
+class Permission(models.Model):
+    CODENAMES = [
+        ('view', '查看'),
+        ('add', '新增'),
+        ('edit', '编辑'),
+        ('delete', '删除'),
+    ]
+    resource = models.CharField("资源标识", max_length=50)  # 如 'article', 'menu', 'carousel'
+    action = models.CharField("操作", max_length=10, choices=CODENAMES)
+    desc = models.CharField("描述", max_length=100)
+
+    class Meta:
+        unique_together = ('resource', 'action')
+
+    def __str__(self):
+        return f"{self.resource}:{self.action}"
+
+
+class Role(models.Model):
+    name = models.CharField("角色名称", max_length=50, unique=True)
+    permissions = models.ManyToManyField('Permission', blank=True)
+
+    def __str__(self):
+        return self.name
+
+
+class Department(models.Model):
+    name = models.CharField("部门名称", max_length=100, unique=True)
+    parent = models.ForeignKey('self', on_delete=models.CASCADE, null=True, blank=True, verbose_name="上级部门")
+    order = models.IntegerField("排序", default=0)
+
+    class Meta:
+        verbose_name = "部门"
+        verbose_name_plural = "部门管理"
+
+    def __str__(self):
+        return self.name
+
+
+class User(AbstractUser, PermissionsMixin):
+    username = models.CharField("英文名/账号", max_length=30, unique=True)
+    cname = models.CharField("中文名", max_length=30, blank=True)
+    dept = models.ForeignKey('Department', on_delete=models.SET_NULL, null=True, blank=True, verbose_name="所属部门")
+    is_active = models.BooleanField(default=True)
+
+    USERNAME_FIELD = 'username'
+    REQUIRED_FIELDS = []
+
+    def __str__(self):
+        return f"{self.cname} ({self.username})"
+
+
+# 给 User 关联 Role（多对多）
+User.add_to_class('roles', models.ManyToManyField(Role, blank=True))

users/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.

users/views.py

@@ -0,0 +1,3 @@
+from django.shortcuts import render
+
+# Create your views here.