XingQue/Django
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 商家订单准确统计、客服备注与按客服筛选

Browse Source
This commit is contained in:
XingQue
2026-06-27 05:17:36 +08:00
parent 2445b39f3b
commit fdecf2fe3c
10 changed files with 304 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
merchant_ops/migrations/0002_merchantstaffmember_merchant_remark.py Normal file
View File

@@ -0,0 +1,16 @@
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('merchant_ops', '0001_initial'),
]
operations = [
migrations.AddField(
model_name='merchantstaffmember',
name='merchant_remark',
field=models.CharField(blank=True, default='', max_length=64, verbose_name='商家备注'),
),
]

1
merchant_ops/models.py
View File

@@ -79,6 +79,7 @@ class MerchantStaffMember(QModel):
role = models.ForeignKey(MerchantStaffRole, on_delete=models.PROTECT)
status = models.IntegerField(default=1, verbose_name='1正常0停用2已移除')
display_name = models.CharField(max_length=64, blank=True, default='')
merchant_remark = models.CharField(max_length=64, blank=True, default='', verbose_name='商家备注')
invited_by_code = models.ForeignKey(
MerchantStaffInvite, null=True, blank=True, on_delete=models.SET_NULL
)

17
merchant_ops/services/order_enrich.py
View File

@@ -23,6 +23,21 @@ def get_user_avatar_by_uid(uid):
return user_avatar_relative(u)
def staff_display_label(member):
"""商家侧展示名：商家备注 > 显示名 > 角色名 > UID"""
if not member:
return ''
remark = (getattr(member, 'merchant_remark', None) or '').strip()
if remark:
return remark
name = (member.display_name or '').strip()
if name:
return name
if member.role:
return member.role.role_name or member.staff_user_id
return member.staff_user_id
def get_dispatch_staff_payload(order_id):
"""订单派单归属；无记录则 None（商家老板派单可能无 dispatch 记录）。"""
if not order_id:
@@ -48,7 +63,7 @@ def get_dispatch_staff_payload(order_id):
return {
'dispatch_staff_type': ACTOR_STAFF,
'dispatch_staff_uid': m.staff_user_id,
'dispatch_staff_name': m.display_name or (m.role.role_name if m.role else m.staff_user_id),
'dispatch_staff_name': staff_display_label(m),
'dispatch_staff_avatar': user_avatar_relative(u),
'dispatch_role_code': m.role.role_code if m.role else '',
'dispatch_role_name': m.role.role_name if m.role else '',

6
merchant_ops/urls.py
View File

@@ -2,7 +2,7 @@ from django.urls import path
from merchant_ops.views_manage import (
StaffInviteCreateView, StaffInviteListView, StaffInviteRevokeView,
StaffMemberListView, StaffMemberUpdateRoleView, StaffMemberRemoveView,
StaffMemberListView, StaffMemberUpdateRoleView, StaffMemberRemarkUpdateView, StaffMemberRemoveView,
StaffMemberDisableView, StaffMemberUpdatePermsView,
StaffRoleListView, StaffRoleCreateView, StaffRoleSetPermsView,
StaffWalletAllocateView, StaffWalletRevokeView, StaffWalletLedgerView, StaffAuditListView,
@@ -10,7 +10,7 @@ from merchant_ops.views_manage import (
)
from merchant_ops.views_staff import StaffBindView, StaffMeView
from merchant_ops.views_orders import (
StaffOrderListView, StaffOrderDetailView, StaffDispatchView,
StaffOrderListView, StaffOrderDetailView, StaffOrderStatsView, StaffDispatchView,
StaffProductTypesView, StaffSettleView, StaffCancelView, StaffRefundView,
StaffPenaltyApplyView, StaffPenaltyManageView, StaffChangePlayerView,
)
@@ -28,6 +28,7 @@ urlpatterns = [
path('invite/list', StaffInviteListView.as_view()),
path('invite/revoke', StaffInviteRevokeView.as_view()),
path('member/list', StaffMemberListView.as_view()),
path('member/update-remark', StaffMemberRemarkUpdateView.as_view()),
path('member/update-role', StaffMemberUpdateRoleView.as_view()),
path('member/update-perms', StaffMemberUpdatePermsView.as_view()),
path('member/remove', StaffMemberRemoveView.as_view()),
@@ -42,6 +43,7 @@ urlpatterns = [
path('rank', StaffRankView.as_view()),
# 子客服订单（全新接口）
path('order/list', StaffOrderListView.as_view()),
path('order/stats', StaffOrderStatsView.as_view()),
path('order/detail', StaffOrderDetailView.as_view()),
path('order/dispatch', StaffDispatchView.as_view()),
path('order/product-types', StaffProductTypesView.as_view()),

34
merchant_ops/views_manage.py
View File

@@ -26,6 +26,7 @@ from merchant_ops.services.authz import (
is_merchant_owner, resolve_staff_context,
get_active_staff_member, member_has_perm as _member_has_perm,
)
from merchant_ops.services.order_enrich import staff_display_label, user_avatar_relative
from merchant_ops.services.audit import audit_owner
from merchant_ops.services.bootstrap import ensure_merchant_roles
from merchant_ops.services.wallet import allocate_quota, get_or_create_wallet, revoke_quota
@@ -173,7 +174,6 @@ class StaffMemberListView(APIView):
try:
from datetime import date
from users.business_models import User
from merchant_ops.services.order_enrich import user_avatar_relative
mid, _ = _resolve_manage_context(request, need_staff_manage=True)
today = date.today()
@@ -199,7 +199,9 @@ class StaffMemberListView(APIView):
result.append({
'id': m.id,
'uid': m.staff_user_id,
'nickname': m.display_name or m.staff_user_id,
'nickname': staff_display_label(m),
'merchant_remark': m.merchant_remark or '',
'display_name': m.display_name or '',
'avatar': user_avatar_relative(u),
'role_name': m.role.role_name if m.role else '',
'isChief': m.role.role_code == 'CHIEF' if m.role else False,
@@ -225,6 +227,34 @@ class StaffMemberListView(APIView):
return _err(e)
class StaffMemberRemarkUpdateView(APIView):
"""商家老板/总管：设置客服备注"""
permission_classes = [IsAuthenticated]
def post(self, request):
try:
mid, operator = _resolve_manage_context(request, need_staff_manage=True)
member_id = request.data.get('member_id')
remark = str(request.data.get('merchant_remark', '')).strip()[:64]
if not member_id:
return Response({'code': 400, 'msg': '缺少 member_id', 'data': None})
m = MerchantStaffMember.query.get(id=member_id, merchant_id=mid)
m.merchant_remark = remark
m.save(update_fields=['merchant_remark'])
audit_owner(mid, request.user.UserUID, 'MEMBER_UPDATE_REMARK', request,
resource_type='member', resource_id=member_id,
value_after={'merchant_remark': remark})
return Response({
'code': 0,
'msg': '备注已保存',
'data': {'member_id': m.id, 'merchant_remark': remark, 'nickname': staff_display_label(m)},
})
except MerchantStaffMember.DoesNotExist:
return Response({'code': 404, 'msg': '客服不存在', 'data': None})
except Exception as e:
return _err(e)
class StaffMemberUpdateRoleView(APIView):
permission_classes = [IsAuthenticated]

67
merchant_ops/views_orders.py
View File

@@ -19,6 +19,7 @@ from merchant_ops.services.order_query import (
from merchant_ops.services.audit import audit_staff
from merchant_ops.services.dispatch import staff_dispatch_order
from merchant_ops.services.stats import bump_cancel_count, bump_penalty_count
from merchant_ops.models import MerchantOrderDispatch
from orders.models import MerchantOrderExt
from orders.views import (
ShangjiaDingdanXiangqingView, ShangjiaJiesuanView, ShangjiaChexiaoView,
@@ -69,6 +70,17 @@ class StaffOrderListView(APIView):
pending_qs = staff_order_ext_qs(member, [8])
pending_count = pending_qs.count()
from orders.services.merchant_order_stats import build_merchant_order_stats
stats_qs = staff_order_ext_qs(member, None)
stats_qs = staff_apply_order_filters(stats_qs, data)
order_stats = build_merchant_order_stats(stats_qs)
can_finance = member_has_perm(member, 'finance_view')
if not can_finance:
for k in list(order_stats.keys()):
if k.endswith('_amount'):
order_stats[k] = '0.00'
total_count = base_qs.count()
start = (page - 1) * page_size
@@ -87,7 +99,10 @@ class StaffOrderListView(APIView):
'list': order_list,
'has_more': start + len(page_qs) < total_count,
'total': total_count,
'pending_count': pending_count,
'pending_count': order_stats['pending_count'],
'pending_amount': order_stats['pending_amount'] if can_finance else '0.00',
'order_stats': order_stats,
'can_view_finance': can_finance,
'view_scope': 'all' if staff_can_view_all_orders(member) else 'self',
},
})
@@ -95,6 +110,56 @@ class StaffOrderListView(APIView):
return _err(e)
class StaffOrderStatsView(APIView):
"""子客服/老板视角订单统计 POST /yonghu/merchant-staff/order/stats"""
permission_classes = [IsAuthenticated]
def post(self, request):
try:
member = _require_staff(request)
if not member_has_perm(member, 'order_view_all') and not member_has_perm(member, 'order_view_self'):
raise StaffAuthError(403, '无订单查看权限')
data = request.data or {}
from orders.services.merchant_order_stats import build_merchant_order_stats, filter_by_staff_member
from orders.models import MerchantOrderExt
filter_payload = dict(data)
filter_payload['_merchant_id_filter'] = member.merchant_id
qs = MerchantOrderExt.query.filter(
MerchantID=member.merchant_id,
).select_related('Order')
if not staff_can_view_all_orders(member):
own_ids = list(
MerchantOrderDispatch.query.filter(staff_member_id=member.id).values_list('order_id', flat=True)
)
qs = qs.filter(Order__OrderID__in=own_ids)
elif data.get('staff_member_id'):
qs = filter_by_staff_member(qs, member.merchant_id, data.get('staff_member_id'))
qs = staff_apply_order_filters(qs, filter_payload)
order_stats = build_merchant_order_stats(qs)
can_finance = member_has_perm(member, 'finance_view')
if not can_finance:
for k in list(order_stats.keys()):
if k.endswith('_amount'):
order_stats[k] = '0.00'
return Response({
'code': 0,
'msg': '成功',
'data': {
'order': order_stats,
'can_view_finance': can_finance,
},
})
except Exception as e:
return _err(e)
class StaffOrderDetailView(APIView):
permission_classes = [IsAuthenticated]