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

feat: 会员/履约金页文案按俱乐部可配置

Browse Source 
新增 club_recharge_page_copy 表与小程序/后台读写接口，kefu 菜单挂「充值页文案」。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
XingQue
2026-07-24 00:04:23 +08:00
parent dcb191ac3a
commit 4b5130c824
7 changed files with 402 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
jituan/migrations/0015_club_recharge_page_copy.py Normal file
View File

@@ -0,0 +1,31 @@
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('jituan', '0014_club_mini_pay_channel_and_ledger'),
]
operations = [
migrations.CreateModel(
name='ClubRechargePageCopy',
fields=[
('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('club_id', models.CharField(db_index=True, max_length=16, verbose_name='俱乐部ID')),
('page_key', models.CharField(db_index=True, max_length=16, verbose_name='huiyuan|yajin')),
('region_key', models.CharField(db_index=True, max_length=32, verbose_name='rules|benefits|advantages')),
('title', models.CharField(blank=True, default='', max_length=64, verbose_name='区域标题')),
('items_json', models.JSONField(blank=True, default=list, verbose_name='条目列表JSON')),
('enabled', models.BooleanField(default=True, verbose_name='是否启用该区域')),
('sort_order', models.IntegerField(default=0)),
('CreateTime', models.DateTimeField(auto_now_add=True)),
('UpdateTime', models.DateTimeField(auto_now=True)),
],
options={
'verbose_name': '充值页文案配置',
'db_table': 'club_recharge_page_copy',
'unique_together': {('club_id', 'page_key', 'region_key')},
},
),
]

18
jituan/models.py
View File

@@ -410,6 +410,24 @@ class ClubDashouExamPass(QModel):
unique_together = [['club_id', 'yonghuid']]
class ClubRechargePageCopy(QModel):
"""会员充值页 / 履约金页按俱乐部可配置的文案与图标。"""
club_id = models.CharField(max_length=16, db_index=True, verbose_name='俱乐部ID')
page_key = models.CharField(max_length=16, db_index=True, verbose_name='huiyuan|yajin')
region_key = models.CharField(max_length=32, db_index=True, verbose_name='rules|benefits|advantages')
title = models.CharField(max_length=64, blank=True, default='', verbose_name='区域标题')
items_json = models.JSONField(default=list, blank=True, verbose_name='条目列表JSON')
enabled = models.BooleanField(default=True, verbose_name='是否启用该区域')
sort_order = models.IntegerField(default=0)
CreateTime = models.DateTimeField(auto_now_add=True)
UpdateTime = models.DateTimeField(auto_now=True)
class Meta:
db_table = 'club_recharge_page_copy'
unique_together = [['club_id', 'page_key', 'region_key']]
verbose_name = '充值页文案配置'
class KefuMenuPage(QModel):
"""客服后台左侧菜单页（固定 page_id，与前端路由对应）。"""
page_id = models.CharField(max_length=64, primary_key=True, verbose_name='页面ID')

2
jituan/services/kefu_menu.py
View File

@@ -92,7 +92,7 @@ def _load_menu_pages():
pages = []
need_seed = not pages or not any(
p.page_id in ('miniapp.assets', 'product.fake-orders') for p in pages
p.page_id in ('miniapp.assets', 'product.fake-orders', 'miniapp.recharge-copy') for p in pages
)
if need_seed:
try:

2
jituan/services/kefu_menu_definitions.py
View File

@@ -97,6 +97,8 @@ KEFU_MENU_ROW_DEFS = [
'perm_codes': ['dsks666', '8080a']},
{'page_id': 'miniapp.rank-reward', 'name': '排行榜奖励', 'path': '/miniapp/rank-reward', 'parent_id': 'miniapp', 'sort_order': 118,
'perm_codes': ['phbj666', '8080a']},
{'page_id': 'miniapp.recharge-copy', 'name': '充值页文案', 'path': '/miniapp/recharge-copy', 'parent_id': 'miniapp', 'sort_order': 119,
'perm_codes': ['8080a']},
{'page_id': 'shop', 'name': '店铺管理', 'path': '', 'parent_id': '', 'sort_order': 120},
{'page_id': 'shop.list', 'name': '店铺列表', 'path': '/shop/list', 'parent_id': 'shop', 'sort_order': 121,
'perm_codes': ['999a', '999b', '999c', '999d', '999e']},

204
jituan/services/recharge_page_copy.py Normal file
View File

@@ -0,0 +1,204 @@
"""会员/履约金充值页文案按俱乐部读写。"""
import json
from jituan.models import ClubRechargePageCopy
from jituan.services.club_context import resolve_club_id_from_request, resolve_effective_club_id
PAGE_HUIYUAN = 'huiyuan'
PAGE_YAJIN = 'yajin'
PAGE_KEYS = {PAGE_HUIYUAN, PAGE_YAJIN}
REGIONS_BY_PAGE = {
PAGE_HUIYUAN: ('rules', 'benefits', 'advantages'),
PAGE_YAJIN: ('rules', 'benefits'),
}
REGION_SORT = {
'rules': 10,
'benefits': 20,
'advantages': 30,
}
def normalize_page_key(page_key):
key = (page_key or '').strip().lower()
return key if key in PAGE_KEYS else ''
def normalize_region_key(page_key, region_key):
key = (region_key or '').strip().lower()
allowed = REGIONS_BY_PAGE.get(page_key) or ()
return key if key in allowed else ''
def _as_items_list(raw):
if raw is None:
return []
if isinstance(raw, str):
try:
raw = json.loads(raw)
except (TypeError, ValueError):
return []
if not isinstance(raw, list):
return []
out = []
for item in raw:
if isinstance(item, dict):
out.append(item)
elif isinstance(item, str) and item.strip():
out.append({'text': item.strip()})
return out
def _normalize_items_for_region(region_key, items):
"""按区域清洗条目字段，去掉空条目。"""
cleaned = []
for item in _as_items_list(items):
if region_key == 'rules':
text = (item.get('text') or '').strip()
if text:
cleaned.append({'text': text})
elif region_key == 'benefits':
# 会员权益：title/desc；履约金权益：label
title = (item.get('title') or '').strip()
label = (item.get('label') or '').strip()
desc = (item.get('desc') or '').strip()
icon_url = (item.get('icon_url') or '').strip()
accent = (item.get('accent_color') or '').strip()
row = {}
if title:
row['title'] = title
if label:
row['label'] = label
if desc:
row['desc'] = desc
if icon_url:
row['icon_url'] = icon_url
if accent:
row['accent_color'] = accent
if row.get('title') or row.get('label') or row.get('desc'):
cleaned.append(row)
elif region_key == 'advantages':
title = (item.get('title') or '').strip()
desc = (item.get('desc') or '').strip()
icon_url = (item.get('icon_url') or '').strip()
if not (title or desc):
continue
row = {}
if title:
row['title'] = title
if desc:
row['desc'] = desc
if icon_url:
row['icon_url'] = icon_url
cleaned.append(row)
return cleaned
def _row_to_region_payload(row, for_admin=False):
items = _as_items_list(row.items_json)
payload = {
'title': (row.title or '').strip(),
'items': items,
'enabled': bool(row.enabled),
'sort_order': int(row.sort_order or 0),
}
if for_admin:
payload['region_key'] = row.region_key
payload['page_key'] = row.page_key
return payload
def get_public_regions(club_id, page_key):
"""小程序只读：仅返回 enabled 且 items 非空的区域。"""
page_key = normalize_page_key(page_key)
if not page_key or not club_id:
return {}
rows = (
ClubRechargePageCopy.query
.filter(club_id=club_id, page_key=page_key, enabled=True)
.order_by('sort_order', 'id')
)
regions = {}
for row in rows:
items = _as_items_list(row.items_json)
if not items:
continue
regions[row.region_key] = {
'title': (row.title or '').strip(),
'items': items,
}
return regions
def get_admin_regions(club_id, page_key):
"""后台：返回该页全部区域（含未启用/空），缺省区域补空壳。"""
page_key = normalize_page_key(page_key)
if not page_key or not club_id:
return {}
allowed = REGIONS_BY_PAGE[page_key]
existing = {
row.region_key: row
for row in ClubRechargePageCopy.query.filter(club_id=club_id, page_key=page_key)
}
regions = {}
for rk in allowed:
row = existing.get(rk)
if row:
regions[rk] = _row_to_region_payload(row, for_admin=True)
else:
regions[rk] = {
'region_key': rk,
'page_key': page_key,
'title': '',
'items': [],
'enabled': False,
'sort_order': REGION_SORT.get(rk, 0),
}
return regions
def save_region(club_id, page_key, region_key, *, title='', items=None, enabled=True, sort_order=None):
page_key = normalize_page_key(page_key)
region_key = normalize_region_key(page_key, region_key)
if not club_id or not page_key or not region_key:
return None, 'page_key 或 region_key 无效'
items_clean = _normalize_items_for_region(region_key, items)
title = (title or '').strip()[:64]
enabled = bool(enabled)
if sort_order is None:
sort_order = REGION_SORT.get(region_key, 0)
try:
sort_order = int(sort_order)
except (TypeError, ValueError):
sort_order = REGION_SORT.get(region_key, 0)
row = ClubRechargePageCopy.query.filter(
club_id=club_id, page_key=page_key, region_key=region_key,
).first()
if row:
row.title = title
row.items_json = items_clean
row.enabled = enabled
row.sort_order = sort_order
row.save(update_fields=['title', 'items_json', 'enabled', 'sort_order', 'UpdateTime'])
else:
row = ClubRechargePageCopy.query.create(
club_id=club_id,
page_key=page_key,
region_key=region_key,
title=title,
items_json=items_clean,
enabled=enabled,
sort_order=sort_order,
)
return _row_to_region_payload(row, for_admin=True), None
def club_id_for_mini(request):
return resolve_club_id_from_request(request)
def club_id_for_admin(request, user):
return resolve_effective_club_id(request, user)

8
jituan/urls.py
View File

@@ -95,6 +95,11 @@ from jituan.views_identity_tag import (
IdentityTagManageView,
IdentityTagMyTagsView,
)
from jituan.views_recharge_page_copy import (
RechargePageCopyAdminGetView,
RechargePageCopyAdminSaveView,
RechargePageCopyView,
)
urlpatterns = [
path('auth/wechat-login', ClubWechatLoginView.as_view(), name='jituan_wechat_login'),
@@ -129,6 +134,9 @@ urlpatterns = [
path('houtai/lunbo-list', ClubLunboListView.as_view(), name='jituan_lunbo_list'),
path('houtai/lunbo-manage', ClubLunboManageView.as_view(), name='jituan_lunbo_manage'),
path('houtai/gonggao', ClubGonggaoView.as_view(), name='jituan_gonggao'),
path('recharge-page-copy', RechargePageCopyView.as_view(), name='jituan_recharge_page_copy'),
path('houtai/recharge-page-copy/get', RechargePageCopyAdminGetView.as_view(), name='jituan_recharge_page_copy_get'),
path('houtai/recharge-page-copy/save', RechargePageCopyAdminSaveView.as_view(), name='jituan_recharge_page_copy_save'),
path('identity-tag/my-tags', IdentityTagMyTagsView.as_view(), name='jituan_identity_my_tags'),
path('houtai/identity-tag/list', IdentityTagListView.as_view(), name='jituan_identity_tag_list'),
path('houtai/identity-tag/manage', IdentityTagManageView.as_view(), name='jituan_identity_tag_manage'),

138
jituan/views_recharge_page_copy.py Normal file
View File

@@ -0,0 +1,138 @@
"""会员/履约金页文案：小程序只读 + 客服后台读写。"""
from rest_framework.parsers import JSONParser
from rest_framework.permissions import IsAuthenticated
from rest_framework.response import Response
from rest_framework.views import APIView
from backend.utils import verify_kefu_permission
from jituan.services.display_config import forbid_display_write_in_all_scope, list_response_meta
from jituan.services.recharge_page_copy import (
PAGE_KEYS,
club_id_for_admin,
club_id_for_mini,
get_admin_regions,
get_public_regions,
normalize_page_key,
save_region,
)
POPUP_PERM = '8080a'
def _page_key_from_request(request):
if hasattr(request, 'query_params'):
q = request.query_params.get('page_key')
if q:
return q
data = getattr(request, 'data', None) or {}
return data.get('page_key') or ''
class RechargePageCopyView(APIView):
"""小程序只读 GET/POST /jituan/recharge-page-copy?page_key=huiyuan|yajin"""
permission_classes = [IsAuthenticated]
parser_classes = [JSONParser]
def get(self, request):
return self._handle(request)
def post(self, request):
return self._handle(request)
def _handle(self, request):
page_key = normalize_page_key(_page_key_from_request(request))
if not page_key:
return Response({'code': 400, 'msg': f'page_key 须为 {", ".join(sorted(PAGE_KEYS))}'})
club_id = club_id_for_mini(request)
regions = get_public_regions(club_id, page_key)
return Response({
'code': 0,
'data': {
'page_key': page_key,
'club_id': club_id,
'regions': regions,
},
})
class RechargePageCopyAdminGetView(APIView):
"""后台拉全量区域 POST /jituan/houtai/recharge-page-copy/get"""
permission_classes = [IsAuthenticated]
parser_classes = [JSONParser]
def post(self, request):
phone = (request.data.get('phone') or request.data.get('username') or '').strip()
if not phone:
return Response({'code': 401, 'msg': '缺少客服账号'})
kefu, permissions = verify_kefu_permission(request, phone)
if kefu is None:
return permissions
if POPUP_PERM not in permissions:
return Response({'code': 403, 'msg': '无权限管理充值页文案'})
page_key = normalize_page_key(request.data.get('page_key'))
if not page_key:
return Response({'code': 400, 'msg': f'page_key 须为 {", ".join(sorted(PAGE_KEYS))}'})
club_id = club_id_for_admin(request, request.user)
regions = get_admin_regions(club_id, page_key)
return Response({
'code': 0,
'data': {
'page_key': page_key,
'club_id': club_id,
'regions': regions,
**list_response_meta(request),
},
})
class RechargePageCopyAdminSaveView(APIView):
"""后台保存某一区域 POST /jituan/houtai/recharge-page-copy/save"""
permission_classes = [IsAuthenticated]
parser_classes = [JSONParser]
def post(self, request):
phone = (request.data.get('phone') or request.data.get('username') or '').strip()
if not phone:
return Response({'code': 401, 'msg': '缺少客服账号'})
kefu, permissions = verify_kefu_permission(request, phone)
if kefu is None:
return permissions
if POPUP_PERM not in permissions:
return Response({'code': 403, 'msg': '无权限管理充值页文案'})
deny = forbid_display_write_in_all_scope(request)
if deny:
return deny
page_key = request.data.get('page_key')
region_key = request.data.get('region_key')
title = request.data.get('title') or ''
items = request.data.get('items')
if items is None:
items = request.data.get('items_json')
enabled = request.data.get('enabled', True)
sort_order = request.data.get('sort_order')
club_id = club_id_for_admin(request, request.user)
data, err = save_region(
club_id,
page_key,
region_key,
title=title,
items=items,
enabled=enabled,
sort_order=sort_order,
)
if err:
return Response({'code': 400, 'msg': err})
return Response({
'code': 0,
'msg': '保存成功',
'data': {
'page_key': normalize_page_key(page_key),
'club_id': club_id,
'region': data,
},
})