三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

Python+Vue3民营加油站管理系统开发实践

发布时间：2026/8/4 16:22:09 三亩地 编程学习日记
Python+Vue3民营加油站管理系统开发实践

1. 项目背景与需求分析

民营加油站作为成品油零售终端的重要组成部分，面临着日益激烈的市场竞争和精细化管理需求。传统的手工记账或单机版管理软件已无法满足现代加油站对实时数据、会员营销和库存预警的需求。这正是我们开发这套基于Python+Vue3的小型民营加油站管理系统的初衷。

这个系统主要解决以下几个痛点：

  • 油品进销存管理混乱，手工记录易出错
  • 会员体系不完善，缺乏精准营销手段
  • 财务报表生成效率低，无法实时掌握经营状况
  • 多班次交接时数据同步困难

2. 技术选型与架构设计

2.1 后端技术栈选择

选择Python作为后端主要基于以下考虑：

  1. Django框架的ORM能快速构建数据模型
  2. Pandas库强大的数据分析能力适合财务报表生成
  3. 丰富的第三方库支持各种业务场景扩展
  4. 开发效率高，适合中小型项目快速迭代

核心后端组件：

# requirements.txt示例 Django==4.2 djangorestframework==3.14 pandas==2.0 openpyxl==3.1 django-cors-headers==3.14

2.2 前端技术栈选择

Vue3相比Vue2的优势在这个项目中体现明显：

  • Composition API更适合复杂业务逻辑组织
  • 更好的TypeScript支持
  • 更小的打包体积
  • 性能提升明显

前端主要技术组合：

# 创建项目时使用的命令 npm init vue@latest gas-station-management --template vue-ts

3. 核心功能模块实现

3.1 油品库存管理模块

这个模块需要处理以下关键业务：

  • 油罐液位实时监控
  • 进油登记与库存预警
  • 不同油品之间的换算

数据库设计示例：

class OilTank(models.Model): TANK_TYPES = ( ('92', '92#汽油'), ('95', '95#汽油'), ('0', '0#柴油') ) tank_number = models.CharField(max_length=20) oil_type = models.CharField(max_length=2, choices=TANK_TYPES) capacity = models.DecimalField(max_digits=8, decimal_places=2) # 单位：升 current_volume = models.DecimalField(max_digits=8, decimal_places=2) warning_threshold = models.DecimalField(max_digits=8, decimal_places=2)

3.2 交易收银模块

交易流程需要考虑：

  1. 油枪选择与单价自动匹配
  2. 会员折扣计算
  3. 多种支付方式支持
  4. 小票打印功能

前端交易界面关键代码：

<template> <div class="transaction-panel"> <OilGunSelector @select="handleGunSelect"/> <MemberCardScanner v-if="enableMember" @scan="handleMemberScan"/> <PaymentMethod :amount="total" @pay="handlePayment"/> </div> </template>

4. 系统特色功能实现

4.1 智能预警系统

通过实时监控实现：

  • 库存不足预警
  • 设备异常预警
  • 交易异常预警

预警服务核心逻辑：

def check_inventory_warning(): tanks = OilTank.objects.all() for tank in tanks: if tank.current_volume < tank.warning_threshold: send_warning_notification( f"油罐{tank.tank_number}库存不足！当前剩余：{tank.current_volume}L" )

4.2 会员营销系统

包含以下功能点：

  • 会员积分体系
  • 消费习惯分析
  • 精准优惠券发放

会员数据分析示例：

def analyze_member_consumption(member_id): transactions = Transaction.objects.filter( member_id=member_id ).order_by('-create_time')[:100] df = pd.DataFrame.from_records( transactions.values('oil_type', 'volume', 'amount') ) return df.groupby('oil_type').agg({ 'volume': 'sum', 'amount': 'sum' })

5. 系统部署与运维

5.1 本地开发环境搭建

后端开发环境配置：

# 创建虚拟环境 python -m venv venv source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows # 安装依赖 pip install -r requirements.txt # 数据库迁移 python manage.py makemigrations python manage.py migrate # 启动开发服务器 python manage.py runserver

5.2 生产环境部署方案

推荐部署架构：

前端：Nginx + Vue3静态资源 后端：Gunicorn + Django 数据库：MySQL/PostgreSQL 缓存：Redis

使用Docker部署示例：

# backend/Dockerfile FROM python:3.10 WORKDIR /app COPY requirements.txt . RUN pip install -r requirements.txt COPY . . CMD ["gunicorn", "config.wsgi", "--bind", "0.0.0.0:8000"]

6. 常见问题与解决方案

6.1 油品密度换算问题

不同温度下油品体积换算：

def volume_correction(base_volume, base_temp, current_temp): """ 根据温度进行油品体积修正 base_volume: 标准体积 base_temp: 标准温度(℃) current_temp: 当前温度(℃) """ # 简化版计算公式，实际应根据油品类型使用专业系数 correction_factor = 1 + 0.0008 * (current_temp - base_temp) return base_volume * correction_factor

6.2 交易数据同步延迟

解决方案：

  1. 前端使用WebSocket实时获取交易状态
  2. 后端采用Celery异步处理耗时操作
  3. 数据库读写分离配置

WebSocket配置示例：

# consumers.py class TransactionConsumer(WebsocketConsumer): def connect(self): self.accept() def receive(self, text_data): data = json.loads(text_data) # 处理交易逻辑 self.send(text_data=json.dumps({ 'status': 'success', 'data': data }))

7. 系统安全注意事项

7.1 交易安全防护措施

必须实现的防护：

  1. 交易数据HTTPS加密传输
  2. 敏感数据脱敏存储
  3. 操作日志完整记录
  4. 定期数据备份机制

敏感数据处理示例：

from django.db import models from django.core.exceptions import ValidationError class PaymentCard(models.Model): card_number = models.CharField(max_length=20) def clean(self): if not luhn_algorithm_check(self.card_number): raise ValidationError("无效的卡号") def save(self, *args, **kwargs): self.card_number = encrypt_data(self.card_number) super().save(*args, **kwargs) def get_masked_number(self): return f"**** **** **** {self.card_number[-4:]}"

7.2 权限控制系统设计

基于角色的权限控制模型：

# models.py class Role(models.Model): name = models.CharField(max_length=50) permissions = models.ManyToManyField('Permission') class Staff(models.Model): user = models.OneToOneField(User, on_delete=models.CASCADE) role = models.ForeignKey(Role, on_delete=models.PROTECT) station = models.ForeignKey('GasStation', on_delete=models.CASCADE) # decorators.py def role_required(permission_codename): def decorator(view_func): @wraps(view_func) def _wrapped_view(request, *args, **kwargs): if not request.user.staff.role.permissions.filter( codename=permission_codename ).exists(): raise PermissionDenied return view_func(request, *args, **kwargs) return _wrapped_view return decorator

8. 性能优化实践

8.1 数据库查询优化

常用优化手段：

  1. 添加适当的索引
  2. 使用select_related/prefetch_related
  3. 批量操作代替循环操作

优化示例：

# 不推荐的写法 for transaction in Transaction.objects.all(): print(transaction.member.name) # 优化后的写法 transactions = Transaction.objects.select_related('member').all() for transaction in transactions: print(transaction.member.name)

8.2 前端性能优化

Vue3特有的优化技巧：

  1. 合理使用v-memo
  2. 组件懒加载
  3. 静态资源CDN加速

懒加载示例：

<script setup> import { defineAsyncComponent } from 'vue' const ReportChart = defineAsyncComponent(() => import('./components/ReportChart.vue') ) </script>

9. 扩展功能展望

9.1 移动端适配方案

可以考虑：

  1. 开发微信小程序版本
  2. 使用PWA技术实现渐进式Web应用
  3. 响应式设计适配手机浏览器

响应式设计示例：

<template> <div :class="['container', { 'mobile-view': isMobile }]"> <!-- 内容 --> </div> </template> <script setup> import { useWindowSize } from '@vueuse/core' const { width } = useWindowSize() const isMobile = computed(() => width.value < 768) </script>

9.2 数据可视化大屏

使用ECharts实现经营数据可视化：

<template> <div ref="chartEl" style="width: 100%; height: 400px;"></div> </template> <script setup> import * as echarts from 'echarts' import { onMounted, ref } from 'vue' const chartEl = ref(null) onMounted(() => { const chart = echarts.init(chartEl.value) chart.setOption({ // 配置项 }) }) </script>

10. 项目开发经验分享

10.1 前后端协作技巧

实践中总结的有效方法：

  1. 使用Swagger/YAPI维护API文档
  2. 制定统一的数据格式规范
  3. 定期进行接口联调

接口响应格式示例：

# utils/response.py from rest_framework.response import Response def success_response(data=None, message="操作成功"): return Response({ "success": True, "code": 200, "message": message, "data": data }) def error_response(message="操作失败", code=400): return Response({ "success": False, "code": code, "message": message, "data": None })

10.2 版本控制策略

Git工作流建议：

  1. 主分支：main/production
  2. 开发分支：develop
  3. 功能分支：feature/xxx
  4. 修复分支：hotfix/xxx

常用Git命令：

# 开发新功能 git checkout -b feature/inventory-management develop # 合并到开发分支 git checkout develop git merge --no-ff feature/inventory-management git branch -d feature/inventory-management # 发布版本 git checkout main git merge --no-ff develop git tag -a v1.0.0 -m "Release version 1.0.0"
编程学习 学习日记 实战经验
← 返回列表