同城二手 · 交易与私信

1. 能力概览

• C 端：二手首页、搜索、详情、卖家主页、订单列表/详情；详情页底部「聊一聊」「立即购买」。
• 交易：买家下单 → 微信支付 → 卖家标记可自提 → 买家确认收货；支持评价（需评价表补丁）。
• 私信：详情页「聊一聊」进入会话页，买家与卖家站内私信（复用交友消息表，无需交友认证）。
• 后台：二手分类、二手信息管理、与普通同城帖共用审核流。

2. 数据库补丁（按顺序执行一次）

在商城使用的 MySQL 库中执行项目内 SQL 文件（路径相对代码根目录 core/sql/）：

文件	作用
patch_tc_secondhand.sql	帖子表增加 sale_price、trade_status；创建订单表 yjd_tc_post_trade_order
patch_tc_secondhand_review.sql	交易评价表 yjd_tc_post_trade_review（订单完成后互评）
patch_tc_secondhand_settle.sql	订单表增加 is_settle、settle_time（卖家货款入账标记）
patch_makefriends_message.sql	私信消息表 yjd_makefriends_message（未建表时聊天发送会提示「私信功能未开通」）

若历史二手帖已发布但详情无「立即购买」，可在库中核对：

• post_type = 7（二手）
• status = 2（已发布）、sale_price > 0
• trade_status = 1（在售；0 会被系统视为未初始化，保存或访问详情时会自动纠正为在售）

3. 小程序页面路径

分包根目录 tongcheng/（以实际编译的小程序工程为准，如 xiaochengxu）：

• 首页：tongcheng/secondhand/index/index
• 详情：tongcheng/secondhand/detail/detail
• 确认下单：tongcheng/secondhand/confirm/confirm?post_id=帖子ID
• 聊一聊：tongcheng/chat/conversation/conversation?to_user_id=卖家用户ID&post_id=帖子ID
• 订单列表：tongcheng/secondhand/orderlist/orderlist
• 订单详情：tongcheng/secondhand/orderdetail/orderdetail?id=订单ID

4. 聊一聊（私信）说明

4.1 开通条件

• 执行 patch_makefriends_message.sql 创建 yjd_makefriends_message 表。
• 用户须登录小程序后再发消息。
• 同城二手场景传参 scene=tongcheng，不要求用户完成「交友资料认证」。

4.2 接口（供对接参考）

• 会话信息：makefriends/chat/info
• 历史消息：makefriends/chat/messages
• 发送消息：makefriends/chat/send（POST，to_user_id、message、scene=tongcheng）

4.3 后台监控

平台后台 → 交友 → 聊天监控（mch/makefriends/chat/index），可查看站内私信记录；命中平台敏感词的消息会标记违规。

5. 立即购买与订单

1. 买家在详情页点击「立即购买」（须登录，且售价 > 0、商品在售、非本人发布）。
2. 进入确认订单页，核对商品、自提地点与合计金额后点击「提交订单」。
3. 系统创建 yjd_tc_post_trade_order 订单并调起微信支付。
4. 支付成功后卖家在详情/订单页「标记可自提」。
5. 买家「确认收货」或超时自动确认后交易完成，帖子 trade_status 变为已售。
6. 交易完成后，货款打入卖家个人余额（yjd_user.money），卖家可在小程序个人余额页提现。

5.1 货款入账与自动确认

• 入账时机：买家确认收货时入账；不是支付成功立即入账。
• 自动确认：卖家标记可自提后，若买家在 N 小时内未确认，系统自动完成交易并入账（默认 N=24）。
• 配置项：在 yjd_option 中设置 name=secondhand_auto_confirm_hours、group=tongcheng、对应 store_id（单位：小时）。
• 兜底扫描：用户打开二手订单列表/详情时会触发超时订单的自动确认与历史补入账。

接口前缀：tongcheng/secondhand/trade/（preview、submit、pay-data、mark-ready、confirm、order-list、order-detail、review）。

5.2 微信支付配置（必看）

• 平台后台配置小程序 AppID、商户号、API 密钥（yjd_wechat_app，与当前小程序 _acid 对应）。
• 用户须用同一小程序登录，系统使用 wechat_open_id 发起 JSAPI 支付。
• 支付回调地址：/web/post-notify.php（由 pay_notify_url() 拼接域名）。
• 本地 localhost 无法真实支付：微信要求回调 URL 公网可访问；在本地开发会提示「请使用公网域名测试」。请部署到测试域名或使用内网穿透后再测支付。
• 若报 XML 解析错误或「发起支付失败」，优先检查：商户号/密钥是否正确、openid 是否为空、回调域名是否备案且可外网访问。

6. 平台后台入口

• 二手分类：mch/forum/secondhand-category/index
• 二手信息管理：mch/forum/secondhand-post/index
• 编辑页须填写售价（sale_price），保存后 C 端才显示购买按钮。

7. 常见问题

• 聊天提示「私信功能未开通」 → 执行 patch_makefriends_message.sql。
• 没有「立即购买」 → 检查售价是否 > 0、是否本人帖子、是否已有进行中订单、trade_status 是否为 1（在售）。
• 下单提示价格无效 → 后台编辑二手帖填写售价并保存。
• 卖家收不到钱 → 确认是否已执行 patch_tc_secondhand_settle.sql；订单须为「已完成」且 is_settle=1；查看卖家个人余额流水（yjd_user_account_log，order_type=21）。
• 小程序报页面找不到 → 确认 app.json 已注册二手分包页并重新上传小程序代码。