--- markup: occlusion title: 代码即文档 · 周末咖啡手账 description: >- 一份可读可跑的周末手账:菜单是表,计价写在段落里,结账读起来像日记。 --- 周六的咖啡馆手账——下面既是给人看的说明,也是可以 `marqdo run` 的程序。 **说明**性的加粗只是强调;真正算账的步骤也用粗体写在句子里,算完的值用斜体交回去。 --- ## 单价 | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | 价 | any | 必填 | 同一币种下单件商品的标价 | | 杯数 | any | 1 | 参与本次计价的杯数,未提供时使用正文默认值 | | 返回 | 类型 | 说明 | |---|---|---| | result | any | 逐行累加得到的订单总额 | 一杯标价为`价`的饮品,默认`杯数`=1。先把**总额 = 价 * 杯数**算清,再返回*总额*。 ## 会员折 | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | 原价 | any | 必填 | 应用折扣之前的原始金额 | | 折扣 | any | 0.85 | 价格乘数;0.85 表示支付原价的百分之八十五 | | 返回 | 类型 | 说明 | |---|---|---| | result | any | 下文显式返回的计算值或结构化结果;分支存在时遵循实际命中的分支。 | 会员单要原价`原价`;店里默认八五折,记作`折扣`=0.85。 先算**应付 = 原价 * 折扣**,再返回*应付*。 ## 结账摘要 | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | 品名 | any | 必填 | 收据或摘要中显示的商品名称 | | 价 | any | 必填 | 同一币种下单件商品的标价 | | 杯数 | any | 1 | 参与本次计价的杯数,未提供时使用正文默认值 | | 会员 | any | False | 是否采用本示例的会员折扣分支 | | 返回 | 类型 | 说明 | |---|---|---| | result | any | 包含商品、数量和实付金额的显示文案 | 客人点了`品名`,单价`价`,杯数`杯数`=1;是否`会员`=False。 按杯数问单价:**小计 = 单价 价=`价` 杯数=`杯数`**。 1. `会员` 我们先**实付 = [计算并保存 实付](会员折(原价=`小计`))**,供下一步使用。 我们先**标签 = "会员价"**,供下一步使用。 2. * 我们先**实付 = `小计`**,供下一步使用。 我们先**标签 = "原价"**,供下一步使用。 对账时拼成一句人话: 我们先**文案 = ((((((`品名` + " ×") + `杯数`) + " → ") + `标签`) + " ") + `实付`)**,供下一步使用。 完成上述步骤后,返回*文案*。 ## 印章加一 | 参数 | 类型 | 默认 | 说明 | |---|---|---|---| | 印 | any | 必填 | 积分卡当前已有的印章数量 | | 返回 | 类型 | 说明 | |---|---|---| | result | any | 下文显式返回的计算值或结构化结果;分支存在时遵循实际命中的分支。 | 积分卡上的`印`,每喝一杯就**印 = 印 + 1**,接着返回*印*。 # main | 返回 | 类型 | 说明 | |---|---|---| | result | any | 空值;按顺序执行本页的演示步骤,观察输出或已说明的副作用。 | 这份手账把定价规则放在真正的结账函数里,入口只组织今天的几笔订单。菜单横表是品名到单价的记录,外卖行表则是多条带有数量和会员标记的订单;两者的数据形态不同,因此先按名称取价,再逐行传给同一个摘要函数。 会员示例与原价对照使用同一套参数和默认值,避免正文与实现各维护一份优惠规则。金额在本例中使用普通运行时数值,会员折扣可能产生小数;这里没有宣称采用专门的货币舍入模型。需要真实计费精度时应另行规定最小单位与舍入步骤,不能把展示摘要的文本当成准确记账凭证。 打印的是已经计算出的摘要,后续业务若要复用它应直接传递该值,而不是解析输出文字。最后给积分卡加一只改变演示中的印章值,不写入用户文件,也不代表某个真实账户已经更新。 今日黑板价目——表格给人扫一眼,程序当字典用: `菜单` = | 美式 | 拿铁 | 燕麦拿铁 | |------|------|----------| | 18 | 28 | 32 | --- 上午来了位会员,点两杯拿铁。品名写进`名`,价钱从菜单里取: 我们先**名 = "拿铁"**,供下一步使用。 我们先**价 = [名](access(`菜单`, `名`))**,供下一步使用。 我们先**摘要 = [计算并保存 摘要](结账摘要(品名=`名`, 价=`价`, 杯数=2, 会员=True))**,供下一步使用。 **打印 内容=`摘要`** 旁桌只要一杯普通美式,对照一下原价: 我们先**对照 = [计算并保存 对照](结账摘要(品名="美式", 价=[美式](access(`菜单`, "美式"))))**,供下一步使用。 **打印 内容=`对照`** --- 下午把外卖单抄成行表,一行一行结: `今日订单` = | @ | 品名 | 单价 | 杯数 | 会员 | |---|------|------|------|------| | 1 | 燕麦拿铁 | 32 | 1 | True | | 2 | 美式 | 18 | 2 | False | - [行](遍历 今日订单 为 行) 我们先**一行 = [计算并保存 一行](结账摘要(品名=[品名](access(`行`, "品名")), 价=[单价](access(`行`, "单价")), 杯数=[杯数](access(`行`, "杯数")), 会员=[会员](access(`行`, "会员"))))**,供下一步使用。 **打印 内容=`一行`** 打烊前给积分卡盖一个章: 我们先**印 = 41**,供下一步使用。 我们先**印 = [计算并保存 印](印章加一(印=`印`))**,供下一步使用。 **打印 内容=`印`**