fengshao1227/yuezi-saas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 第一阶段基础框架搭建

Browse Source 
后端 (Laravel 10 + Sanctum):
- RBAC 四层权限系统 (users→roles→permissions→menus)
- 门店隔离中间件 (BelongsToStore Trait + StoreIsolation Middleware)
- 操作日志中间件 (自动记录写操作)
- 权限检查中间件 (CheckPermission)
- 16张数据库表迁移 (系统基础+RBAC+字典+配置)
- 11个 Eloquent Model
- Auth API (登录/登出/用户信息)
- 系统设置模块 CRUD (门店/部门/职务/用户/角色/菜单/权限/字典/日志)
- 45条 RESTful API 路由
- InitSeeder 初始数据 (超管/角色/76权限/31菜单)

前端 (Vue 3 + Element Plus + Vite):
- Axios 请求封装 + Token 注入
- Pinia 状态管理 (user + permission store)
- 动态路由 (服务端菜单→前端路由自动生成)
- 后台布局 (侧边栏+顶栏+主内容区)
- 登录页 + 仪表盘首页
- 系统设置 7 个 CRUD 页面

技术方案文档 (7卷):
- 技术总览/数据库设计/API规范/RBAC设计/模块详设/小程序设计/部署方案
This commit is contained in:
li
2026-03-13 19:52:09 +08:00
commit 11c177a432
144 changed files with 25209 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
backend/app/Models/Department.php
+38
View File
@@ -0,0 +1,38 @@
<?php
namespace App\Models;
use App\Traits\BelongsToStore;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
class Department extends Model
{
use BelongsToStore;
protected $fillable = [
'store_id', 'parent_id', 'name', 'sort', 'status',
];
protected $casts = [
'status' => 'integer',
];
public function children(): HasMany
{
return $this->hasMany(self::class, 'parent_id');
}
public function users(): HasMany
{
return $this->hasMany(User::class);
}
/**
* 递归获取部门树
*/
public function childrenRecursive(): HasMany
{
return $this->children()->with('childrenRecursive');
}
}
backend/app/Models/Dictionary.php
+20
View File
@@ -0,0 +1,20 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
class Dictionary extends Model
{
protected $fillable = ['name', 'code', 'description', 'is_system'];
protected $casts = [
'is_system' => 'boolean',
];
public function items(): HasMany
{
return $this->hasMany(DictionaryItem::class)->orderBy('sort');
}
}
backend/app/Models/DictionaryItem.php
+20
View File
@@ -0,0 +1,20 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
class DictionaryItem extends Model
{
protected $fillable = ['dictionary_id', 'label', 'value', 'sort', 'status'];
protected $casts = [
'status' => 'integer',
];
public function dictionary(): BelongsTo
{
return $this->belongsTo(Dictionary::class);
}
}
backend/app/Models/Menu.php
+55
View File
@@ -0,0 +1,55 @@
<?php
namespace App\Models;
use App\Enums\MenuType;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
class Menu extends Model
{
protected $fillable = [
'parent_id', 'name', 'path', 'component', 'icon',
'permission_code', 'type', 'visible', 'sort', 'status',
];
protected $casts = [
'type' => MenuType::class,
'visible' => 'integer',
'status' => 'integer',
];
public function children(): HasMany
{
return $this->hasMany(self::class, 'parent_id');
}
public function childrenRecursive(): HasMany
{
return $this->children()->with('childrenRecursive')->orderBy('sort');
}
/**
* 获取完整菜单树
*/
public static function tree(): array
{
$all = self::where('status', 1)->orderBy('sort')->get()->toArray();
return self::buildTree($all);
}
private static function buildTree(array $items, int $parentId = 0): array
{
$tree = [];
foreach ($items as $item) {
if ($item['parent_id'] == $parentId) {
$children = self::buildTree($items, $item['id']);
if ($children) {
$item['children'] = $children;
}
$tree[] = $item;
}
}
return $tree;
}
}
backend/app/Models/OperationLog.php
+28
View File
@@ -0,0 +1,28 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
class OperationLog extends Model
{
public $timestamps = false;
protected $fillable = [
'store_id', 'user_id', 'user_name', 'module', 'action',
'target', 'target_id', 'ip', 'method', 'url',
'before', 'after', 'created_at',
];
protected $casts = [
'before' => 'array',
'after' => 'array',
'created_at' => 'datetime',
];
public function user(): BelongsTo
{
return $this->belongsTo(User::class);
}
}
backend/app/Models/Permission.php
+53
View File
@@ -0,0 +1,53 @@
<?php
namespace App\Models;
use App\Enums\PermissionType;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\HasMany;
class Permission extends Model
{
protected $fillable = [
'parent_id', 'name', 'code', 'module', 'type', 'description', 'sort',
];
protected $casts = [
'type' => PermissionType::class,
];
public function children(): HasMany
{
return $this->hasMany(self::class, 'parent_id');
}
public function roles(): BelongsToMany
{
return $this->belongsToMany(Role::class, 'role_permission');
}
/**
* 获取权限树
*/
public static function tree(): array
{
$all = self::orderBy('sort')->get()->toArray();
return self::buildTree($all);
}
private static function buildTree(array $items, int $parentId = 0): array
{
$tree = [];
foreach ($items as $item) {
if ($item['parent_id'] == $parentId) {
$children = self::buildTree($items, $item['id']);
if ($children) {
$item['children'] = $children;
}
$tree[] = $item;
}
}
return $tree;
}
}
backend/app/Models/Position.php
+13
View File
@@ -0,0 +1,13 @@
<?php
namespace App\Models;
use App\Traits\BelongsToStore;
use Illuminate\Database\Eloquent\Model;
class Position extends Model
{
use BelongsToStore;
protected $fillable = ['store_id', 'name', 'sort'];
}
backend/app/Models/Region.php
+20
View File
@@ -0,0 +1,20 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
class Region extends Model
{
protected $fillable = ['name', 'sort', 'status'];
protected $casts = [
'status' => 'integer',
];
public function stores(): HasMany
{
return $this->hasMany(Store::class);
}
}
backend/app/Models/Role.php
+27
View File
@@ -0,0 +1,27 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
class Role extends Model
{
protected $fillable = [
'store_id', 'name', 'code', 'description', 'is_system',
];
protected $casts = [
'is_system' => 'boolean',
];
public function users(): BelongsToMany
{
return $this->belongsToMany(User::class, 'role_user');
}
public function permissions(): BelongsToMany
{
return $this->belongsToMany(Permission::class, 'role_permission');
}
}
backend/app/Models/Store.php
+38
View File
@@ -0,0 +1,38 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
class Store extends Model
{
protected $fillable = [
'region_id', 'name', 'code', 'address', 'phone', 'logo', 'status',
];
protected $casts = [
'status' => 'integer',
];
public function region(): BelongsTo
{
return $this->belongsTo(Region::class);
}
public function departments(): HasMany
{
return $this->hasMany(Department::class);
}
public function users(): HasMany
{
return $this->hasMany(User::class);
}
public function positions(): HasMany
{
return $this->hasMany(Position::class);
}
}
backend/app/Models/SystemConfig.php
+33
View File
@@ -0,0 +1,33 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class SystemConfig extends Model
{
protected $fillable = ['store_id', 'group', 'key', 'value', 'description'];
/**
* 获取配置值
*/
public static function getValue(string $key, ?int $storeId = null, $default = null)
{
$config = self::where('key', $key)
->where('store_id', $storeId)
->first();
return $config ? $config->value : $default;
}
/**
* 设置配置值
*/
public static function setValue(string $key, $value, ?int $storeId = null, string $group = 'general'): void
{
self::updateOrCreate(
['key' => $key, 'store_id' => $storeId],
['value' => $value, 'group' => $group]
);
}
}
backend/app/Models/User.php
+118
View File
@@ -0,0 +1,118 @@
<?php
namespace App\Models;
use App\Enums\UserStatus;
use App\Traits\BelongsToStore;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Laravel\Sanctum\HasApiTokens;
class User extends Authenticatable
{
use HasApiTokens, HasFactory, SoftDeletes, BelongsToStore;
protected $fillable = [
'store_id', 'department_id', 'position_id',
'username', 'password', 'name', 'phone', 'email',
'avatar', 'status', 'is_super', 'last_login_at',
];
protected $hidden = ['password'];
protected function casts(): array
{
return [
'status' => UserStatus::class,
'is_super' => 'boolean',
'last_login_at' => 'datetime',
'password' => 'hashed',
];
}
public function department(): BelongsTo
{
return $this->belongsTo(Department::class);
}
public function position(): BelongsTo
{
return $this->belongsTo(Position::class);
}
public function roles(): BelongsToMany
{
return $this->belongsToMany(Role::class, 'role_user');
}
/**
* 获取用户所有权限标识
*/
public function getAllPermissionCodes(): array
{
if ($this->is_super) {
return ['*'];
}
return $this->roles()
->with('permissions')
->get()
->pluck('permissions')
->flatten()
->pluck('code')
->unique()
->values()
->toArray();
}
/**
* 检查是否有指定权限
*/
public function hasPermission(string $code): bool
{
if ($this->is_super) {
return true;
}
return in_array($code, $this->getAllPermissionCodes());
}
/**
* 获取用户菜单树
*/
public function getMenuTree(): array
{
if ($this->is_super) {
$menus = Menu::where('status', 1)->orderBy('sort')->get();
} else {
$permissionCodes = $this->getAllPermissionCodes();
$menus = Menu::where('status', 1)
->where(function ($q) use ($permissionCodes) {
$q->whereIn('permission_code', $permissionCodes)
->orWhereNull('permission_code');
})
->orderBy('sort')
->get();
}
return self::buildTree($menus->toArray());
}
private static function buildTree(array $items, int $parentId = 0): array
{
$tree = [];
foreach ($items as $item) {
if ($item['parent_id'] == $parentId) {
$children = self::buildTree($items, $item['id']);
if ($children) {
$item['children'] = $children;
}
$tree[] = $item;
}
}
return $tree;
}
}