sudo /usr/local/bin/k3s certificate rotate

2. 重启k3s服务

sudo systemctl restart k3s

3. 将新的/etc/rancher/k3s/k3s.yaml文件下载下来使用

=IF(VLOOKUP(MOD(SUMPRODUCT(MID(A2,ROW($1:$17),1)*{7;9;10;5;8;4;2;1;6;3;7;9;10;5;8;4;2}),11),{0,1;1,0;2,"X";3,9;4,8;5,7;6,6;7,5;8,4;9,3;10,2},2,0)&""=RIGHT(A2,1),"合法","不合法")

身份证号中的生日

=--TEXT(MID(A2,7,8),"0-00-00")

身份证号中的年龄

=DATEDIF( --TEXT(MID(A2,7,8),"0-00-00"), TODAY(), "Y")

身份证号中的性别

=IF(MOD(MID(O2,17,1),2)=0,"女","男")

ss -at -o state established '( sport = :8090 )'|awk 'NR !=1 {print $4}'|column -s ':' -t|awk '{print $1}'|sort|uniq -c|sort -n

• -a：全部连接
• -t：仅tcp连接
• -o state established：过滤只保留活跃连接
• ( sport = :8090 )：仅保留服务端8090端口
• awk NR!=1 不要标题行
• {print $4} 只保留第四列（客户端ip和端口）
• column -s ':' -t 按冒号切割（ip:port）
• awk '{print $1}' 只保留第一列（只保留ip）
• sort：排序
• uniq -c：汇总每个ip的数量（需要先排序后汇总）
• sort -n 按count数排序

统计自己调用其他服务的

ss -at -o state established '( sport != :8090 )'|awk 'NR !=1 {print $4}'|sort|uniq -c|sort -n

apiVersion: apps/v1
kind: Deployment
metadata:
  name: acme-sh-deployment
  labels:
    app: acme-sh
spec:
  replicas: 1
  selector:
    matchLabels:
      app: acme-sh
  template:
    metadata:
      labels:
        app: acme-sh
    spec:
      volumes:
      - name: acme-sh # 将配置文件和生成的证书挂载到宿主机
        hostPath:
          path: /data/acme.sh
      containers:
      - name: acme-sh
        image: neilpang/acme.sh:latest
        args: ["daemon"] # 以deamon模式运行
        env:
        - name: "DP_Id" # 接入DNSPod API
          value: "****"
        - name: "DP_Key" # 接入DNSPod API
          value: "****"
        volumeMounts:
        - name: acme-sh
          mountPath: /acme.sh

配置账号

kubectl exec acme-sh-deployment-**********-***** -- acme.sh --register-account -m xxx@example.com

配置域名

kubectl exec acme-sh-deployment-**********-***** -- acme.sh --issue --dns dns_dp -d "example.com" -d "www.example.com" -d "*.example.com"

添加到k8s secret中

kubectl create secret tls dev-f-tls --cert=/data/acme.sh/example.com/example.com.cer --key=/data/acme.sh/example.com/example.com.key

cron自动更新

0 0 * * *  kubectl create secret tls dev-f-tls --cert=/data/acme.sh/example.com/example.com.cer --key=/data/acme.sh/example.com/example.com.key --dry-run=client --save-config=true  -o yaml| kubectl apply -f -  > /dev/null 2>&1 &

集群

集群模式下应修改vlumes，挂载网盘或其它存储

apiVersion: apps/v1
kind: Deployment
metadata:
  name: ghost-deployment
  labels:
    app: ghost
spec:
  replicas: 1
  selector:
    matchLabels:
      app: ghost
  template:
    metadata:
      labels:
        app: ghost
    spec:
      volumes:
        - name: tz
          hostPath:
            path: /etc/localtime
        - name: ghost-content
          hostPath:
            path: /data/ghost-content
        - name: ghost-db # 第一次创建时不挂载这个，需要启动后从./current/content/data里复制出来一份
          hostPath:
            path: /data/ghost-dev.db
      containers:
      - name: ghost
        image: ghost:latest
        volumeMounts:
          - name: tz
            mountPath: /etc/localtime
          - name: ghost-content
            mountPath: /var/lib/ghost/content
          - name: ghost-db  # 第一次创建时不挂载这个
            mountPath: /var/lib/ghost/current/content/data/ghost-dev.db
        ports:
        - containerPort: 2368
        env:
        - name: NODE_ENV
          value: "development"
        - name: url
          value: "http://www.dev-f.cn"

创建Service

apiVersion: v1
kind: Service
metadata:
  name: ghost-service
spec:
  selector:
    app: ghost
  ports:
    - protocol: TCP
      port: 80
      targetPort: 2368

创建Ingress

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ghost-ingress
  annotations:
    # kubernetes.io/ingress.class: traefik
    # traefik.ingress.kubernetes.io/router.middlewares: default-redirect@kubernetescrd
    nginx.ingress.kubernetes.io/rewrite-target: /
    nginx.ingress.kubernetes.io/ssl-redirect: "true"
spec:
  # tls: # https配置（需要添加secret）
  # - hosts:
  #   - "www.example.com"
  #   secretName: example-tls
  rules:
  - host: "www.example.com"
    http:
      paths:
      - path: "/"
        pathType: Prefix
        backend:
          service:
            name: ghost-service
            port:
              number: 80

环境变量中增加 MallocNanoZone=0 即可

kubectl logs <pod> -n <namespace> --previous=true

环境：Centos7 + Jenkins + go1.16

问题1: mission $GOPATH

我在Jenkins中使用go的插件（可以自动下载特定版本），但是不知道为什么使用1.16版本是报mission $GOPATH的错误，但是1.15不报，并且1.15也没有设置GOPATH。

经排查后发现这个服务器的jenkins用户环境变量中没有HOME这个环境变量。如果不配置GOPATH时，GOPATH默认为~/go。

估计是1.16以后用户HOME查找目录，1.15及以前用其它方式查找。

为了不重启服务器，在jenkins的Configure System中增加了这个环境变量。

问题2: unrecognized relocation (0x2a) in section `.text’

在网上查这个错误说是Centos或ld版本太低导致，但是我用的Centos7版本不算太老。

按照网上的方法sudo yum -y install binutils升级了ld后，问题解决

((list) => {
    let max = {
        total: 0,
        first: 0,
        last: 0,
    };
    let tmp = {
        total: 0,
        first: 0,
        last: 0,
    };
    let op = 0;//是否连续，0不连续，1递增连续，-1递减连续
    list.forEach((current, i) => {
        if (i === 0) {
            tmp.total = current;
            max.total = current;
            return;
        }
        const prev = list[i - 1];
        if (op === 0) {
            if (current > prev) {
                op = 1;
            } else if (current < prev) {
                op = -1;
            } else {
                op = 0;
            }
        }
        if (op !== 0 && current - prev === op) {
            tmp.total += current;
        } else {
            if (max.total < tmp.total) {
                max.total = tmp.total;
                max.first = tmp.first;
                max.last = tmp.last;
            }
            op = 0
            tmp.first = i;
            tmp.total = current;
        }
        tmp.last = i;
    });
    if (max.total < tmp.total) {
        max = tmp;
    }
    return [
        "和值：" + max.total,
        "值：" + list[max.first] + "～" + list[max.last],
        "索引：" + max.first + "～" + max.last
    ].join("\n");
})([1, 2, 3, 4, 3, 2, 5, 6, 7, 8]);

Result类

结构

{
  "code": 0,
  "msg": "ok",
  "data": null
}

• code：为错误编码，只能是int
• msg：为错误信息，只能是字符串
• data：为数据，可以是任何类型

code的定义

性别

• 字段名：gender

版本号

字符串格式

<major>.<minor>.<patch> 或 v<major>.<minor>.<patch>

三段必须都有，不能省略，如：v1.0.0，v1.2.3，2.5.7

• major为大版本，升级major时可不向下兼容
• minor为功能版本，升级minor时应尽可能向下兼容
• patch为补丁版本，升级patch时必须向下兼容，升级patch版本时不应提供新功能或新接口

数字格式

正整数，最后三位代表patch，中间三位代表minor，最前面的若干位代表major

如：1000000为v1.0.0，21001134代表v21.1.134

Mac中有个AppleScript，通过它可以实现弹窗或系统通知

弹窗

osascript -e 'display alert "告警！！" as critical'

• osascript -e 是执行一段apple script
• display alert是弹窗
• as critcal是用来控制图标，可以as三个值（informational，warning，critical，默认是informational）

发通知

osascript -e 'display notification "通知内容" with title "标题" subtitle "子标题" sound name "Glass"'

• display notification 是发通知的命令后面紧跟着通知内容
• with title 可以修改通知标题（默认是“脚本编辑器”）
• subtitle 可以添加一个子标题（默认没有）
• sound name 可以用来选择一种通知的声音，声音存放在/System/Library/Sounds中

结合PHP实战

<?php
ini_set('date.timezone','PRC');

$host = 'mysql.example.org';
$port = '3306';
$dbname = 'test';
$username = 'root';
$password = '123456';
$pdo = new PDO("mysql:host={$host};port={$port};dbname={$dbname};charset=UTF8", $username, $password);

$sql = <<<SQL
SELECT u.uid, p.privilege_id, u.updated_at 
FROM user_privilege AS p 
LEFT JOIN user AS u ON u.uid = p.uid
WHERE u.del = 1 and p.del = 0;
SQL;

$statement = $pdo->query($sql);
$result = $statement->fetchAll(PDO::FETCH_ASSOC);
$new = [];

$logDir = __DIR__ . '/log/';
if (!file_exists($logDir)) {
    mkdir($logDir, 0755, true);
}
foreach ($result as $item) {
    $fileName = $logDir . '/' . $item['uid'] . '.json';
    if (!file_exists($fileName)) {
        file_put_contents($fileName, json_encode($item, JSON_PRETTY_PRINT));
        $new[] = $item['uid'];
    }
}
if ($new) {
    $msg = sprintf('%s发现新异常数据%d条！(%s)', date('Y-m-d H:i:s'), count($new), implode(', ', $new));
    $cmd = <<<CMD
osascript -e 'tell application "System Events" to display alert "{$msg}" as critical'
CMD;
    exec($cmd);
}

这个脚本连接一个远程的数据库，检查是否出现用户被删除，但是权限没有被删除的情况，如果发现将它记录到日志并弹窗提示。这里增加了tell application "System Events" to这么个前缀，是指以“System Events”这个应用弹这个窗，这是因为好像有什么机制会阻止cron任务中直接弹窗，需要借用另一个应用的身份。也可以借用”Finder”，发弹窗时Finder会跳动一下，但是弹窗需要点Finder才能出来，而使用System Event可以直接弹出来。

接下来可以在执行crontab -e来增加个计划任务

MAILTO=""
*/1 * * * * php ~/check.php > /dev/null

• MAILTO=”” 是执行crontab不发执行结果的系统邮件
• */1是指每1分钟执行一次，剩下的*分别代表：每小时(0~23)/每天(1~31)/每月(1~12)/每周几(0~6)

$a = 1;
$b = 2;
list($a, $b) = array($b, $a);
[$a, $b] = [$b, $a];

前言

这是一道面试题也是对过去一段时间做优惠的总结。这里只是一个大概的设计，一些表结构，一些伪代码。有些字段的大小、字符集、索引、单词命名需要进一步细调，但不影响主体设计思路，这里就不细究了。

基础功能：建券发券用券

基础信息：coupon表

coupon表用来存储某一种券的基本信息，与用户无关。

CREATE TABLE `coupon` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '自增主键',
  `sn` varchar(32) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL COMMENT '优惠券唯一标示，对外的发放接口中应尽量用这个',
  `name` varchar(128) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL COMMENT '优惠券名称',
  `status` tinyint(4) NOT NULL DEFAULT '0' COMMENT '状态：可用1，停用2，作废3，等等',
  `issue_begin_time` datetime NOT NULL COMMENT '发放开始时间',
  `issue_end_time` datetime NOT NULL COMMENT '发放结束时间',
  `expiry_type` tinyint(1) NOT NULL DEFAULT '0' COMMENT '过期类型：1绝对过期时间，2相对过期时间',
  `absolute_begin_time` datetime DEFAULT NULL COMMENT '如果是绝对过期时间，券的有效期开始时间',
  `absolute_end_time` datetime DEFAULT NULL COMMENT '如果是绝对过期时间，券的有效期结束时间',
  `relative_begin_days` int(1) DEFAULT NULL COMMENT '如果是相对过期时间，领取后多少天后生效',
  `relative_end_days` int(1) DEFAULT NULL COMMENT '如果是相对过期时间，生效后多少天过期',
  `discount_type` tinyint(1) NOT NULL DEFAULT '0' COMMENT '优惠形式：1满减，2每满减，3折扣券，4阶梯券',
  `discount_value` decimal(10,2) NOT NULL COMMENT '优惠力度，满减券存多少元，折扣券存减百分之多少（0.00-1.00）',
  `threshold_price` decimal(10,2) DEFAULT NULL COMMENT '使用门槛（满多少元，根据公司规范可改成int，满多少分）',
  `ext_params` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL COMMENT '如果有阶梯券，可存其余阶梯门槛和力度，如果有折扣券可存最高减多少',
  `coupon_type` tinyint(1) NOT NULL COMMENT '优惠券类别：1普通券，2运费券',
  `created_at` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `total_num` int(11) NOT NULL COMMENT '优惠券总量',
  `issued_num` int(11) NOT NULL COMMENT '发放数量',
  `user_limit` int(11) NOT NULL DEFAULT '1' COMMENT '单用户最多领多少张',
  PRIMARY KEY (`id`),
  UNIQUE KEY `id` (`id`),
  UNIQUE KEY `ux_sn` (`sn`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

过期类型与过期时间

优惠券一般会分为绝对有效期和相对有效期。
比如搞一次大促活动，只允许11月11日至11月15日使用的就是绝对有效期。
而新用户注册送的新人券，注册成功后7天内有效就是相对有效期。

• 通过expiry_type字段来区分是哪种有效期
• 如果是绝对有效期使用absolute_begin_time,absolute_end_time两个字段来确定一个准券的时间段。
• 如果是相对有效期使用relative_begin_days,relative_end_days两个字段确定，领取后第几天生效以及生效后多少天过期（一般情况下是领取后立即生效，但也有些拉复购的券会要求过几天后才能使用）。

需要注意的是一般相对有效期的券都是以某一日23:59:59为结束时间，前台一般也不会显示过期的时分秒，所以如果是立即生效，领取当天一般不能算1天，算是送给用户的福利。

另外在优惠券系统中发放时间和使用时间是两个概念，即使是绝对有效期。因为大促之类的券是有可能提前发的。

优惠类型与优惠参数

优惠券可能会有多种优惠形式，比如满减、每满减、折扣券、阶梯券等等，因此我们通过discount_type,discount_value,threshold_price对优惠的力度与金额进行一次抽象，并用ext_params做一些差异化的参数存储。

• 通过discount_type来区分是哪种优惠形式
• discount_value用来表示减价的力度，比如满减和每满减用来表示多少元钱，折扣券用来表示减百分之多少（个人建议8.8折的时候存0.12而不是8.8，这样在计算订单金额的时候不会出现加减号不一致的问题），而阶梯券可以考虑存最高阶梯的减价金额（看上去效果好一些）。
• threshold_price用来表示最低多少元可用。
• 不同形式的优惠券有可能有自己特定的参数，这时可以用ext_params参数来存储，比如折扣券一般会有最高上限，比如96折最高减50元，而阶梯券有可能有满300减50满500减100这种多段规则，都可以以一个自定义的格式存到这个字段里。

总数量与发放数量

在发放优惠券时应先更新发放数量，并且在查询条件中加乐观锁。比如：UPDATE coupon SET issued_num = issued_num + 1 WHERE id = ? AND issued_num < total_num;，这样可以确保券不超发。

之所以使用issue_num+total_num而不是remain_num+total_num是因为当某一种券快要发完时，我们想去再增加点儿量的时候只需要改total_num这一个字段就可以，而不是要同时改remain和total两个字段。

如果担心发放数量会频繁更新，也可以考虑将这两个字段单独拆成一个计数器表，这样coupon表的内容就基本不会发生频繁变更了。

SN的作用：安全无小事

sn是个唯一键每种券的sn都不一样，SN是一串完全随机的字符串组成，千万不要用加密算法和摘要算法来生成。

我们提供给外部的接口应该让别人传sn进来而不是id。

使用SN不使用ID是因为ID是自增的，而SN是随机的，我们提供优惠券这种基础服务时可能无法掌控对接方如何使用，有可能有人搞个页面或请求/activity/getCoupon.php?couponId=456来让用户领取优惠券，如果被薅羊毛的发现这种页面，他们就可以从1一直遍历试到N把你所有能领的券都领了，有的券甚至是非公开的大额券或其它活动抽奖的券，这样就有可能会产生资损，而SN是完全随机即使有人写了个/activity/getCoupon.php?couponSN=aXdj91h也难以被遍历。

当然最好是能推进业务方连SN都不要暴露给前端，可以改造为/activity/getCoupon.php?activityId=12345之类的。

用户领到的券：user_coupon表

user_coupon表是用户领到的券，用户每领一张券，这个表中就会增加一条数据（同一种优惠券有可能领取两张，所以uid和coupon_id没有加唯一索引）

CREATE TABLE `user_coupon` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '自增ID',
  `uid` bigint(20) unsigned NOT NULL COMMENT '用户ID',
  `coupon_id` bigint(20) unsigned NOT NULL COMMENT '券ID',
  `issued_time` datetime NOT NULL COMMENT '发放时间/领取时间',
  `effective_time` datetime NOT NULL COMMENT '生效时间，无论是相对还是绝对有效期，都能在领取时确定生效时间',
  `expiry_time` datetime NOT NULL COMMENT '过期时间，无论是相对还是绝对有效期，都能在领取时确定过期时间',
  `status` tinyint(1) NOT NULL DEFAULT '0' COMMENT '状态：1未使用，2已使用，3已退款，4过期，5作废',
  `used_order_id` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL COMMENT '订单号，数据类型要参考订单系统',
  `used_time` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL COMMENT '使用时间（即下单时间）',
  `refund_from` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '如果发生退款且退券，记录本券是因为退那张券而生成的新券',
  `issue_channel_id` bigint(20) unsigned NOT NULL DEFAULT '0' COMMENT '发放渠道ID，核算部门成本的因素之一',
  PRIMARY KEY (`id`),
  UNIQUE KEY `id` (`id`),
  KEY `ix_coupon_id` (`coupon_id`) USING BTREE,
  KEY `ix_uid_status` (`uid`,`status`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

有效期

无论是绝对有效期还是相对有效期，在用户领券的时候都能确定下来当前用户的这张券有效期的开始时间effective_time和过期时间expiry_time，虽然通过coupon表的字段加上这个表的发放时间能动态的计算出来有效期，好像可以去掉这两个字段，但是将他们冗余下来，可以降低程序复杂读并加快后续的一些操作速度，而且根据以往的经验coupon表中的有效期是有小概率会发生调整的，这时我们原则是只能影响新领的券而不能影响已经到用户手上的券，所以多存两个字段还是利大于弊的。

退款退券问题：退原券还是发新券

当订单未支付取消支付了，或者支付成功去退款了，这时我们应当将券退还给用户，让用户可以继续使用这张券。这里会有两种退券方案：

• 直接将券的状态改为未使用
  • 优势：足够简单，而且不会产生多余数据
• 将券的状态改为已退，同时生成一张新券给用户
  • 优势：我们可以确保每张券（或者说每个id）只会被用在一个订单上，数据不会被覆盖，出现问题时有迹可循

这两种方案各有各的优势，可以看情况选择，可以都用第一种或都用第二种，也可以取消支付用第一种退款用第二种。

退款退券问题：部分退款

引申一个订单部分退款的问题：退款退券是一个相对复杂的问题，因为有可能有购物车或者业务形态的限制，会出现部分退款的问题。比如我买了5个2元的本，一共10元，用了一张满5元减1元的优惠券，最终支付的9元，当我退掉一个本的时候就会出现问题。

• 有人认为应该退1元钱，并且把券退给用户
• 有人认为应该退2元钱，但不退券给用户

这两种方式其实都有问题，一个容易造成纠纷，一个容易造成薅羊毛，而且在一些极端的大折扣券处理上有可能出现多次退款最后一次无钱可退的问题。

比较好的方式是按比例退，既我只退给用户1.8元，因为1个本原价2元，占总原价的20%，那么在退款时我也至退给用户支付金额的20%，既9*0.2=1.8元，而优惠券此时不退还给用户，除非本单使用了优惠券的所有商品都全额退款了，再退给用户优惠券。

再引申一个对账的问题：当发生部分退款时，此时在对账或财务系统中记录的优惠券方面的成本或支持也应等比减少。

垃圾数据清理

有一个不可否认的问题就是发的券比真正用的券要多，而且要多很多。当一段时间后user_coupon表就会出现大量过期优惠券，会相当占用表空间。这时我们可以考虑清理数据或分表。

• 清理数据：这里指的就是物理删除了，其实用户一般不会太关心很久以前就过期了的优惠券，因此我们可以定期将三个月前就过期的券物理删除掉。
• 分表：如果不想物理删除，还可以考虑分表。分表分为两种，一种是按uid来分表，这样可以减少每张表的大小，另一种可以根据状态来分，比如我们把未过期的放一张表里，已过期的放另一张表里甚至另一个库里，就像冷热数据一样。当然两种分表也可以结合使用。

接口定义

基础功能的接口没有太多可说的，主要就是后台的增删改查，和前台的查询及下单接口。

需要注意的是因为我们设计的优惠券系统允许使用多张优惠券且有多种费用项（商品金额、邮费），因此下单的逻辑会复杂一些，需要逐个费用项检查是否符合传进来的优惠券是否可用。虽然下单页中的优惠券列表是我们返回的，但并不意味着提交订单传进来的数据就一定是我们给的，请求有可能篡改也有可能产生并发，再次强调一遍：安全无小事！

另外因为我们在底层数据结构就已经将优惠类型和优惠力度进行了抽象，因此我们在写代码的时候也可以面向接口编程了。比如我们定一个了，Discount的interface，接口中定义了检查是否可用和计算优惠多少钱。那么我们分别将满减、每满减、折扣、阶梯作为四种不同的实现类去实现就可以了。这样的话当我们在写CouponService的时候就不需要考虑每一种类型该如何计算了，我们的Service也可以和具体的某一种玩法解藕了，当将来增加新玩法时，只要增加新的实现类并注册到工厂即可，无需修改Service。

/**
 * coupon表的模型，字段省略
 */
class Coupon
{
    public int $id;
    private DiscountFactory $discountFactory;
    private Discount $discount;
    public function getDiscount():Discount {
        if ($this->discount == null) {
            $this->discount = $this->discountFactory->createDiscount($this->discountType,$this->discountValue,$this->thresholdPrice, $this->extParams);
        }
        return $this->discount;
    }
}
/**
 * user_coupon表的模型，字段省略
 */
class UserCoupon
{
    public int $uid;
    /*...此处省略一大堆代码...*/
    public Coupon $coupon;
}

/**
 * 优惠力度对象工厂
 */
class DiscountFactory {
    private array $conf = [1=>PriceDiscount::class, 2=>PerPriceDiscount::class, 3=>RateDiscount::class, 4=>LadderDiscount::class];
    public function createDiscount($discountType, $discountValue, $thresholdPrice, $extParams=null) {
        if (array_key_exists($discountType, $this->conf)) {
            return new $this->conf[$discountType]($discountValue, $thresholdPrice, $extParams);
        }
        throw new RuntimeException("not implement");
    }
}

/**
 * 减价规则的抽象接口，每一种优惠形式都需要实现这个接口
 */
interface Discount {
    /**
     * 检查当前订单是否可用
     * @param OrderInfoDTO $orderInfo
     * @return bool
     */
    public function checkUsable(OrderInfoDTO $orderInfo): bool ;
    /**
     * 计算当前订单可键多少钱
     * @param OrderInfoDTO $orderInfo
     * @return float
     */
    public function calculate(OrderInfoDTO $orderInfo): float ;
}
class PriceDiscount implements Discount {/*TODO*/}
class PerPriceDiscount implements Discount {/*TODO*/}
class RateDiscount implements Discount {/*TODO*/}
class LadderDiscount implements Discount {/*TODO*/}

/**
 * 订单不是本文重点只是简单列几个字段，订单与补贴分摊又是一大篇文章了
 */
class OrderInfoDTO
{
    private string $orderId;
    private float $productFee;
    private float $postage;
}

/**
 * 优惠券服务
 */
class CouponService
{

    /**
     * 发放优惠券
     * @param int $uid
     * @param string $couponSN
     * @return UserCoupon|null
     */
    public function sendCoupon(int $uid, string $couponSN): ?UserCoupon;

    /**
     * 使用优惠券
     * 需要根据订单信息中的各种费用项来判断传入的userCouponIds是否都可使用
     * 要注意需要检查这些券是不是当前用户的，避免该请求使用别人优惠券的漏洞
     * @param int $uid
     * @param array $userCouponIds
     * @param OrderInfoDTO $orderInfo
     * @return bool
     */
    public function useCoupons(int $uid, array $userCouponIds, OrderInfoDTO $orderInfo): bool;

    /**
     * 我的优惠券列表
     * @param int $offset
     * @param int $limit
     * @param int $uid
     * @param int $status
     * @return array list:UserCoupon[], total:int
     */
    public function getCouponListByUid(int $offset, int $limit, int $uid, int $status): array ;

    /**
     * 根据下单页的订单信息返回可用优惠券列表
     * @param int $uid
     * @param OrderInfoDTO $orderInfoDTO
     * @return UserCoupon[]
     */
    public function getCouponListByBookingPage(int $uid, OrderInfoDTO $orderInfoDTO): array;

}

class CouponInternalService
{

    public function getUserCoupon(int $id): UserCoupon;
    public function getCouponById(int $id): Coupon;
    public function getCouponBySN(string $sn): Coupon;

    public function create();

    /**
     * 更新优惠券时需要注意优惠力度等关键信息一旦创建不允许修改，如果没有发给用户，可以作废重新创建
     * @return mixed
     */
    public function update();

    /*...此处省略优惠券日常操作的一系列增删该查接口...*/
}

进阶一：使用范围与发放范围

基础部分讲的都是一站通用的优惠券，只有使用金额的方面的限制，当业务规模扩大后会开始加各种范围的限制，比如部分品类可用、部分商品可用、女生专享、江浙沪专享。

总体上分为两大类：领取限制和使用限制，使用限制完全由优惠券系统来实现，而领取限制优惠券系统只能做一部分，更多的要靠对接业务方来做，比如搞个抽奖活动，用户是否能抽中这张券也算是领取限制，但把它放到优惠券系统明显不合适。

抽象使用范围表：coupon_use_range

CREATE TABLE `coupon_use_range` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '自增ID',
  `coupon_id` bigint(20) unsigned NOT NULL COMMENT '优惠券ID',
  `range_type` tinyint(1) DEFAULT NULL COMMENT '范围类型：1商品，2品类，3性别，4区域，5...',
  `value` varchar(128) NOT NULL COMMENT '范围值，如商品ID、品类ID、性别、区域ID',
  PRIMARY KEY (`id`),
  UNIQUE KEY `id` (`id`),
  KEY `ix_coupon_id` (`coupon_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

这是张一对多的表，一种优惠券可以有多种使用范围，每种使用范围也可以有多个使用范围的规则。

• range_type来决定这一行是什么类型的限制，比如是商品限制还是品类限制
• value字段需要根据range_type来看是什么含义，可以是商品ID，也可以是品类ID
• 相同的range_type在使用时是“或”的关系，比如range_type都是商品，value分别是123和456的两条记录代表123和456这两个商品都可以使用这个优惠券。
• 不同的range_type在使用中是“且”的关系，比如range_type分别是品类和区域，value是123和bj，那么就代表123这个商品只有在bj购买时才可以使用这张券。

这样设计的好处时，将来再增加各种奇奇怪怪的范围时不用频繁改。

发放范围和使用范围的表结构基本一致，只是一个在发放接口用，一个在下单接口用，就不再赘述了。

分表建议

初期可以不用考虑分表，如果量很大了，可以考虑按coupon_id进行分表，或者按range_type拆表后再按value分。有可能会同时出现多种分表方案，作用也不同，有一定的可玩性。

接口定义

同样因为我们在数据层就很好的抽象出了范围这个概念，因此我们也可以在代码中将范围抽象为接口，在Service中之间面向接口编程而不是面向实现编程

class Coupon
{
    public int $id;
    /**
     * @return UseRange[]
     */
    public function getUseRangeList(): array {
        /*todo*/
    }
}
interface UseRange {
    public function checkUsable(OrderInfoDTO $orderInfo);
}
class ProductUseRange implements UseRange {}
class CategoryUseRange implements UseRange {}
class GenderUseRange implements UseRange {}
class AreaUseRange implements UseRange {}

/**
 * 优惠券服务
 */
class CouponService
{
    /**
     * 使用优惠券
     * 需要根据订单信息中的各种费用项来判断传入的userCouponIds是否都可使用
     * 要注意需要检查这些券是不是当前用户的，避免该请求使用别人优惠券的漏洞
     * @param int $uid
     * @param array $userCouponIds
     * @param OrderInfoDTO $orderInfo
     * @return bool
     * @throws CheckException
     */
    public function useCoupons(int $uid, array $userCouponIds, OrderInfoDTO $orderInfo): bool {
        //$userCoupons = getUserCoupons($userCouponIds);
        foreach ($userCoupons as $userCoupon) {
            foreach ($userCoupon->getUseRangeList() as $useRange) {
                if (!$useRange->checkUsable($orderInfo)){
                    throw new CheckException("not usable");
                }
            }
        }
        // ...省略代码...
    }
}

进阶二：发放渠道

当业务再发展发展接入的业务方越来越多，这时我们有可能会限制某一种券可以在什么渠道发放，比如某个活动页，APP专享领券，在其它的渠道下即使拿到了sn也无法领取。

也有可能出现同一批券在不同的地方发放，但是会根据用户领取的渠道决定营销成本由哪各部门承担。

这时我们需要引入发放渠道的概念，它是实现以上两种需求的基础。（但不是全部，还需要业务方配合）。我们可以给不同的业务不同的场景预先申请不同的渠道ID，当各个业务调用优惠券的接口时需要将渠道ID传进来，这个渠道ID只能发放和搜索与他相关的券（有点像个小型权限系统），除了渠道ID，我们还可以给每个渠道分配一个密钥，更进一步保证系统的安全性，防止别人盗用自己的渠道ID。如果还想再进一步确保安全，还可以将密钥定义为私钥用它做签名，可以防止抓包盗密钥。不过一般来说做到密钥就可以了，私钥是为了解决网络请求不可信的问题（比如支付回调、开放平台），而局域网内内部服务间调用一般不会出这种问题。

渠道定义表：issue_channel

渠道表很简单除了id、名称、状态就剩一个secret_key如果不做密钥验证的话这个字段也可以去掉。

CREATE TABLE `issue_channel` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '发放渠道ID',
  `name` varchar(128) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '发放渠道名称',
  `secret_key` varchar(128) COLLATE utf8mb4_bin DEFAULT NULL COMMENT '发放密钥',
  `status` tinyint(11) DEFAULT NULL COMMENT '状态：1有效，2作废',
  PRIMARY KEY (`id`),
  UNIQUE KEY `id` (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;

中间表：coupon_issue_channel

issue_channel表和coupon表是多对多的关系，一种券可以在多个渠道发放，一个渠道也可以发放多种券，所以需要建立一张中间表来关联关系。

CREATE TABLE `coupon_issue_channel` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '自增ID',
  `coupon_id` bigint(20) unsigned NOT NULL COMMENT '优惠券ID',
  `channel_id` bigint(20) unsigned NOT NULL COMMENT '渠道ID',
  PRIMARY KEY (`id`),
  UNIQUE KEY `id` (`id`),
  UNIQUE KEY `ux_coupon_id_channel_id` (`coupon_id`,`channel_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

接口调整

接口方面没啥可讲，就是基础的增删改查，无非就是在原有的接口上增加一到两个验证渠道的参数，方法实现种再用这两个参数和优惠券信息校验是否一直。

/**
 * 优惠券服务
 */
class CouponService
{

    /**
     * 发放优惠券
     * @param int $uid
     * @param string $couponSN
     * @return UserCoupon|null
     */
    public function sendCoupon(int $uid, string $couponSN, int $channelId, string $channelSecretKey): ?UserCoupon;

}

进阶三：券包和券码线下发放

券包和和线下发放是两种高级一点的玩法，但都可以用券包的形式实现。

• 券包：一个券包中可以包含多种优惠券，一次性领取所有优惠券。
• 线下发放：线下发放给用户一个兑换码，用户在我的优惠券中或活动页中输入使用，有点像储值卡开卡，或者游戏中的口令礼包。
  • 可以一码一券，也可以一码多券。
  • 可以每人一码（比如礼品卡，每张卡上的码都不一样），也可以共用一码（比如活动口令，所有人输入的口令都一样）。

券包基础信息：coupon_package

由于分为线上和线下两种类型的券包，我们通过type来区分，线上发放的券包传sn即可发放。total_num决定这个券包可以发放多少次。

CREATE TABLE `coupon_package` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '自增ID',
  `sn` varchar(32) NOT NULL COMMENT '券标唯一标识，对外接口应使用这个字段',
  `type` tinyint(1) NOT NULL COMMENT '码的类型：1线上发放，2线下发放',
  `name` varchar(128) NOT NULL COMMENT '券包名称',
  `status` tinyint(1) NOT NULL COMMENT '状态：1可用，2作废',
  `issue_begin_time` datetime NOT NULL COMMENT '发放开始时间',
  `issue_end_time` datetime NOT NULL COMMENT '发放结束时间',
  `total_num` int(11) NOT NULL COMMENT '总数量，一次性兑换码应为1',
  `issued_num` int(11) NOT NULL COMMENT '已发放数量',
  PRIMARY KEY (`id`),
  UNIQUE KEY `id` (`id`),
  UNIQUE KEY `ux_sn` (`sn`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

优惠券关联表：coupon_package_item

这个表用来关联券包中包含哪些券，因为有可能同一种券在一个券包中出现多次，因此增加一个num字段，最小值应为1。

CREATE TABLE `coupon_package_item` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
  `coupon_package_id` bigint(20) unsigned NOT NULL COMMENT '券包ID',
  `coupon_id` bigint(20) unsigned NOT NULL COMMENT '券ID',
  `num` tinyint(11) unsigned NOT NULL DEFAULT '1' COMMENT '同一种券的发放数量',
  PRIMARY KEY (`id`),
  UNIQUE KEY `id` (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

线下发放的券码表：coupon_package_code

这张表存线下发放的兑换码，total_num决定这个码可以使用几次。code可手动指定也可随机生成，建议在8-12位间，并且随机生成时应尽量排除“1lIO0”这类在打印后有可能让人猜错的字符

CREATE TABLE `coupon_package_code` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '自增ID',
  `coupon_package_id` bigint(20) unsigned NOT NULL COMMENT '券包ID',
  `code` varchar(16) NOT NULL COMMENT '券码',
  `total_num` int(11) NOT NULL COMMENT '总数量，一次性兑换码应为1',
  `issued_num` int(11) NOT NULL COMMENT '已发放数量',
  PRIMARY KEY (`id`),
  UNIQUE KEY `id` (`id`),
  UNIQUE KEY `ux_code` (`code`),
  KEY `ix_coupon_package_id` (`coupon_package_id`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

接口定义

在实现接口的时候应注意，应先增加package中的issued_num，如果是下线码还应在去增加code表对应的issued_num两个通过乐观锁都修改成功后再逐次调用发放单张优惠券的接口。如果要发的优惠券较多，可以考虑更新完两个num后抛到队列中发放，并立即给用户发挥成功的信息。放到队列中会导致事务割裂，即数量加上去了，但券没发成功。出现这种情况我们可以通过日志告警自动修复等级制来保证最终一致性。额外说一句在做发放类的操作时，一定要先扣减数量，再发放。发放失败我们可以后期补偿，但如果发放成功扣减数量失败就会造成超发的问题，发到用户手上的东西再要回来就会比较麻烦了。

另外接口中区分了线上可线下两种，如果下线发放的填兑换码的入口可以收归到一处由优惠券系统来维护，那么下线券的兑换接口可以挪到CouponInternalService中作为一个内部接口。

/**
 * 优惠券服务
 */
class CouponService
{
    public function useOnlineCouponPackage(int $uid, string $couponPackageSN): bool ;
    public function useOfflineCouponPackage(int $uid, string $couponPackageCode, string $couponPackageSN = null): bool ;
}

延伸一：日志、监控、告警

因为优惠券涉及到钱的问题，因此在一些关键步骤应记录下日志，比如发券、用券，如果一些异常程序中无法自动降级要根据这种日志进行告警。

另外一些表中需要加上created_at，updated_at，以及最后操作人uid等等，这些都是为了排查问题时有迹可循。