Uniapp+PHP全栈开发固定资产管理系统实战

李昦

1. 固定资产管理小程序全栈开发实战

最近在团队内部落地了一个基于Uniapp的固定资产借用租赁管理平台，后端同时支持ThinkPHP和Laravel框架。这个项目从技术选型到最终上线踩了不少坑，今天把完整的技术方案和实战经验整理出来，特别适合需要快速搭建资产管理系统的团队参考。

先说说为什么选择这样的技术组合：Uniapp的跨端能力可以同时覆盖微信小程序、H5和App，而后端选择PHP系两大框架则考虑了团队技术栈的兼容性。实际开发中发现，ThinkPHP确实如传闻中那样容易上手，而Laravel在复杂业务流处理上更游刃有余。下面就从架构设计到代码实现，详细拆解这个项目的技术要点。

2. 技术选型与架构设计

2.1 框架对比与选型建议

在项目启动阶段，我们花了三天时间对两个后端框架进行了POC验证。这里分享实测数据：

ThinkPHP 6.2：

API平均响应时间：127ms
开发效率：基础CRUD接口开发速度比Laravel快约30%
学习曲线：有PHP基础的开发者2天可上手
典型问题：复杂事务处理需要手动管理DB连接

Laravel 9.x：

API平均响应时间：153ms
开发效率：Artisan命令行工具节省20%重复工作
学习曲线：需要理解服务容器等概念，约1周适应期
杀手锏：Eloquent ORM的关系处理非常优雅

对于中小型项目，如果追求快速上线，建议选择ThinkPHP。我们有个紧急项目用ThinkPHP三天就完成了基础版本开发。而对于需要长期迭代、业务逻辑复杂的系统，Laravel的扩展性和可维护性优势会越来越明显。

2.2 前后端分离架构

采用标准的RESTful API通信模式，前端Uniapp通过封装统一的请求模块与后端交互。这里特别要强调的是接口安全方案的选择：

JWT vs OAuth2：

JWT更适合移动端场景，无状态特性减轻服务端压力
OAuth2在需要精细权限控制时更有优势
最终选择JWT方案，因资产管理不需要第三方授权

安全加固措施：

所有接口强制HTTPS
敏感操作增加二次验证
登录token设置15分钟过期时间
接口限流：单个IP 100次/分钟

php复制// Laravel Sanctum 配置示例
'api' => [
    'driver' => 'sanctum',
    'provider' => 'users',
    'expiration' => 60 * 15, // 15分钟过期
    'middleware' => [
        'throttle:100,1', // 限流配置
        'encrypt_cookies',
    ],
],

3. 数据库设计与核心实现

3.1 数据模型精讲

固定资产管理的核心是状态追踪，我们设计了7张主表+4张关联表。重点说几个关键设计：

资产表(assets)的字段设计陷阱：

php复制Schema::create('assets', function (Blueprint $table) {
    $table->id();
    $table->string('name', 100)->comment('资产名称');
    $table->enum('type', ['equipment', 'furniture', 'vehicle'])
          ->comment('避免使用数字枚举，提高可读性');
    $table->decimal('price', 10, 2)->nullable()
          ->comment('建议保留两位小数');
    $table->date('purchase_date')->index()
          ->comment('必须建立索引，统计报表常用字段');
    // 状态字段设计在下节专门讲解
});

借用记录表(borrow_logs)的优化点：

使用复合索引(asset_id, status)加速查询
添加expected_return和actual_return两个字段
记录操作人IP和设备信息用于审计

3.2 状态机实现方案

资产流转的核心是状态管理，我们对比了三种实现方式：

数据库枚举字段：

php复制$table->enum('status', [
    'available',     // 可借用
    'pending',       // 审批中
    'borrowed',      // 已借出 
    'maintenance',   // 维修中
    'scrapped'       // 已报废
])->default('available');

优点：简单直接缺点：业务规则分散

状态模式（适合ThinkPHP）：

php复制class AssetStateContext {
    private $state;
    
    public function setState(AssetState $state) {
        $this->state = $state;
    }
    
    public function handleRequest() {
        $this->state->handleRequest($this);
    }
}

class AvailableState implements AssetState {
    public function handleRequest($context) {
        // 处理可用状态下的请求
        $context->setState(new PendingState());
    }
}

Laravel状态机包（推荐）：

bash复制composer require symfony/workflow

配置示例：

yaml复制# config/packages/workflow.yaml
workflows:
  asset:
    type: 'state_machine'
    initial_marking: available
    places:
      - available
      - pending
      - borrowed
      - maintenance
      - scrapped
    transitions:
      request:
        from: available
        to: pending
      approve:
        from: pending
        to: borrowed
      reject:
        from: pending
        to: available

实测发现状态机方案虽然前期配置复杂，但后期维护成本低，特别适合审批流程可能变更的场景。

4. Uniapp前端开发实战

4.1 请求层封装技巧

Uniapp的网络请求需要特殊处理，分享几个实用技巧：

全局请求拦截器：

javascript复制// utils/http.js
const http = {
  async request(options) {
    // 自动添加token
    if (!options.header) options.header = {}
    options.header['Authorization'] = store.state.token
    
    // 超时设置
    options.timeout = options.timeout || 15000
    
    return new Promise((resolve, reject) => {
      // 添加请求标记用于取消请求
      const requestTask = uni.request({
        ...options,
        success: (res) => {
          if (res.statusCode >= 400) {
            this._handleError(res)
            reject(res)
          } else {
            resolve(res.data)
          }
        },
        fail: (err) => {
          this._handleError(err)
          reject(err)
        }
      })
      
      // 存储请求任务
      this._addRequestTask(requestTask)
    })
  },
  
  _handleError(error) {
    // 统一错误处理逻辑
    if (error.statusCode === 401) {
      uni.navigateTo({ url: '/pages/login' })
    }
  }
}

取消重复请求机制：

javascript复制let pendingRequests = []

http._addRequestTask = (task) => {
  pendingRequests.push(task)
}

http.cancelPendingRequests = () => {
  pendingRequests.forEach(task => {
    task.abort()
  })
  pendingRequests = []
}

// 在页面onUnload时调用
onUnload() {
  http.cancelPendingRequests()
}

4.2 性能优化实践

图片加载优化方案：

使用七牛云CDN加速
实现懒加载组件：

vue复制<template>
  <image 
    :src="placeholder" 
    :data-src="realSrc"
    @load="handleLoad"
    lazy-load
  />
</template>

<script>
export default {
  data() {
    return {
      loaded: false
    }
  },
  methods: {
    handleLoad() {
      if (this.loaded) return
      const observer = uni.createIntersectionObserver(this)
      observer.relativeToViewport()
        .observe('.lazy-img', (res) => {
          if (res.intersectionRatio > 0) {
            this.loaded = true
            this.$el.src = this.$el.dataset.src
            observer.disconnect()
          }
        })
    }
  }
}
</script>

列表渲染优化：

使用虚拟列表技术
分页加载时保留已有数据

javascript复制// 改进后的分页加载逻辑
async loadMore() {
  if (this.loading || this.finished) return
  
  this.loading = true
  try {
    const res = await api.getAssets({
      page: this.page + 1,
      pageSize: 10
    })
    
    // 使用Vue.set确保响应式更新
    this.list = [...this.list, ...res.data]
    
    if (res.data.length < 10) {
      this.finished = true
    } else {
      this.page++
    }
  } finally {
    this.loading = false
  }
}

5. 审批流设计与实现

5.1 多级审批方案

根据客户需求，我们实现了三种审批模式：

直线型审批：

固定审批人顺序
当前审批人拒绝则流程终止
实现简单但不够灵活

会签型审批：

需要所有审批人同意
任一拒绝则流程终止
适合重要资产审批

或签型审批：

任一审批人通过即可
效率高但风险较大
适合低值易耗品

数据库设计关键字段：

php复制Schema::create('approval_flows', function (Blueprint $table) {
    $table->id();
    $table->foreignId('asset_id')->constrained();
    $table->enum('type', ['linear', 'and', 'or']);
    $table->json('approvers'); // 存储审批人ID数组
    $table->json('current_approvers'); // 当前待审批人
    $table->timestamps();
});

5.2 审批通知实现

采用多通道通知方案：

小程序模板消息（主要通道）
企业微信通知（备用通道）
短信提醒（紧急情况）

消息队列处理代码：

php复制// Laravel Job示例
class SendApprovalNotification implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public function __construct(
        public ApprovalFlow $flow,
        public User $approver
    ) {}

    public function handle()
    {
        // 优先尝试小程序通知
        try {
            $this->sendWeappMsg();
        } catch (\Exception $e) {
            Log::error('小程序通知失败', ['error' => $e]);
            
            // 降级为企业微信通知
            $this->sendWorkWechatMsg();
        }
    }
    
    private function sendWeappMsg()
    {
        $weapp = app('weapp');
        $weapp->sendTemplateMessage([
            'touser' => $this->approver->weapp_openid,
            'template_id' => config('weapp.templates.approval'),
            'data' => [
                'thing1' => ['value' => $this->flow->asset->name],
                'time2' => ['value' => $this->flow->created_at]
            ]
        ]);
    }
}

6. 部署与运维方案

6.1 服务器配置建议

经过压力测试，推荐以下最低配置：

开发环境：
- CPU：2核
- 内存：4GB
- 磁盘：50GB SSD
- 带宽：5Mbps
生产环境（100人团队）：
- CPU：4核
- 内存：8GB
- 磁盘：100GB SSD + 50GB备份
- 带宽：10Mbps

关键服务配置：

nginx复制# Nginx优化配置
http {
    keepalive_timeout 30;
    client_max_body_size 20m;
    
    # 静态资源缓存
    server {
        location ~* \.(jpg|png|gif|js|css)$ {
            expires 30d;
            add_header Cache-Control "public";
        }
    }
}

6.2 监控方案实施

我们采用Prometheus+Grafana搭建监控系统，重点监控指标：

业务指标：

资产借用成功率
平均审批时长
各状态资产占比

系统指标：

API响应时间P99
MySQL查询耗时
Redis内存使用率

告警规则示例：

yaml复制# prometheus/rules.yml
groups:
- name: business.rules
  rules:
  - alert: HighRejectionRate
    expr: sum(rate(approval_rejected_total[5m])) by (asset_type) / sum(rate(approval_requests_total[5m])) by (asset_type) > 0.3
    for: 10m
    labels:
      severity: warning
    annotations:
      summary: "High rejection rate for {{ $labels.asset_type }}"
      description: "Rejection rate is {{ $value }}"

7. 踩坑经验与优化建议

7.1 性能问题排查

上线后遇到的典型问题及解决方案：

资产列表加载慢：

问题：N+1查询问题
解决方案：

php复制// 优化前
$assets = Asset::all();
foreach ($assets as $asset) {
    $asset->borrowLogs; // 每次循环都查询数据库
}

// 优化后
$assets = Asset::with(['borrowLogs' => function($query) {
    $query->where('status', 'borrowed');
}])->get();

审批状态不同步：

问题：并发操作导致状态覆盖
解决方案：使用数据库悲观锁

php复制DB::transaction(function() {
    $asset = Asset::lockForUpdate()->find($id);
    // 处理审批逻辑
});

7.2 安全加固经验

接口防刷方案：

实现滑动窗口限流

php复制// Laravel中间件
public function handle($request, Closure $next)
{
    $key = 'api_limit:' . $request->ip();
    $limit = 100; // 每分钟100次
    
    $current = Redis::command('LLEN', [$key]);
    if ($current >= $limit) {
        return response()->json(['error' => 'Too many requests'], 429);
    }
    
    Redis::command('LPUSH', [$key, time()]);
    Redis::command('EXPIRE', [$key, 60]);
    
    return $next($request);
}

数据权限控制：

基于部门的资产可见性控制

php复制class AssetPolicy
{
    public function view(User $user, Asset $asset)
    {
        return $user->department_id === $asset->department_id;
    }
}

8. 扩展功能实现

8.1 智能预警系统

实现原理：

定时任务扫描临界值
规则引擎评估条件
多渠道触发通知

核心代码：

php复制// 每天凌晨执行检查
$schedule->command('check:asset-alerts')
         ->dailyAt('00:05')
         ->runInBackground();

// 命令处理逻辑
$criticalAssets = Asset::whereColumn('current_value', '<=', 'alert_threshold')
    ->where('alert_enabled', true)
    ->get();

foreach ($criticalAssets as $asset) {
    AlertDispatcher::dispatch($asset);
}

8.2 二维码资产管理

实现方案：

使用endroid/qr-code生成库
每个资产生成唯一QR
扫码展示资产详情

php复制use Endroid\QrCode\QrCode;

$qrCode = new QrCode(route('assets.show', $asset));
$qrCode->setSize(300);
header('Content-Type: '.$qrCode->getContentType());
echo $qrCode->writeString();

前端扫码处理：

javascript复制uni.scanCode({
    success: (res) => {
        const assetId = this.parseUrl(res.result)
        uni.navigateTo({
            url: `/pages/asset/detail?id=${assetId}`
        })
    }
})