九霄担保交易系统源文件源码

- 项目定位：Biz Guard 是一个面向跨境与异地B2B项目（技术开发、设备采购、数字服务等）的在线担保交易平台，提供买卖双方仪
表板、客服工单与聊天中心、管理员控制台以及合约/财务/多币种配置等全栈能力。
- 产品痛点：解决远程交易中资金托管缺失、合同履约跟踪困难、人工对账复杂和客服协作低效的问题；系统通过分阶段交易流转、合
同文件托管、平台收款账号与付款凭证管理、多币种余额、审计日志、2FA与短信/邮件通知框架等机制构建更安全透明的交易闭环，
同时保留线下汇款与人工放款的灵活性。
- 行业背景：随着全球供应链去中心化和服务外包常态化，中小企业越来越依赖跨境数字化交易，但金融合规、反洗钱和GDPR 等要求
迫使平台建设可审计、可追踪、可扩展的风控与客服体系；项目选用 TypeScript、React、Express、PostgreSQL、Drizzle ORM、
WebSocket 等现代栈以支撑实时客服与高并发场景。
- 业务背景：平台面向提供担保支付与交易撮合服务的创业团队或金融科技运营商，设定买家、卖家、客服、管理员四类角色，通过后
台的费率、货币、通知、合约模板和用户管理能力支撑SaaS化运营，后续规划集成 Stripe/PayPal 等支付网关与多语言、品牌定制
功能，以扩展到更多地区和行业垂直领域。

- 用户身份与安全：提供基于 Passport 的会话登录、密码校验与会话并发上限控制，配合短信验证码与双因子认证，以及审计
日志记录敏感操作，以保障平台访问安全 server/auth.ts:1 server/routes.ts:1934 server/twoFactorService.ts:1 server/
auditLog.ts:1.
- 交易与合约管理：支持创建交易、获取列表与详情、上传合同、推进状态流转、终止或发起争议，涵盖买卖双方审批与平台介
入的全生命周期逻辑，数据模型覆盖金额、币种、违约金与账户信息 server/routes.ts:975 server/routes.ts:1150 server/
routes.ts:1652 server/routes.ts:3979 shared/schema.ts:93.
- 财务与支付配置：内置手续费/财务记录查询、平台收款账户与付款凭证录入、交易支付信息展示，并以货币配置表支撑多币种
运营，管理员页面可对财务凭证做增删改查 server/routes.ts:2474 server/routes.ts:3794 server/routes.ts:4205 shared/
schema.ts:773 shared/schema.ts:938 client/src/pages/AdminFinancialRecords.tsx:117.
- 文件与存储服务：通过 MinIO 进行合同、二维码和聊天图片的上传托管，后端路由负责校验、生成上传地址和回显下载链接，
为交易和客服场景提供受控文件流转 server/minioService.ts:1 server/routes.ts:787 server/routes.ts:1240 server/

1.本人全权负责这个项目
2. 技术栈与架构

- 后端：Node.js + Express + TypeScript，入口集中在 server/index.ts:1，经 server/routes.ts 注册 REST 与 WebSocket；认证
采用 Passport 会话登录并集成 2FA/SMS 校验 server/auth.ts:1 server/routes.ts:1934 server/twoFactorService.ts:1。
- 数据层：PostgreSQL + Drizzle ORM，shared/schema.ts:1 定义了交易、资金、消息等实体，并由 server/storage.ts:1 封装查询
更新逻辑，配合审计日志与会话存储增强合规性 server/auditLog.ts:1。
- 前端：Vite + React + TypeScript，买卖双方与管理员页面位于 client/src/pages；React Query 处理数据拉取（如仪表盘
client/src/pages/Dashboard.tsx:11），Tailwind 负责样式。
- 实时通讯：WebSocket 服务在 server/routes.ts:5015 建立，配合 client/src/pages/Chat.tsx:19 的自定义 hook 实现客服与用
户即时消息，同步管理未读计数和正在输入状态。
- 文件/存储：MinIO 客户端封装于 server/minioService.ts:1，路由 server/routes.ts:787、server/routes.ts:2737 等负责合同
与聊天附件的上传校验与持久化。
- 多币种与财务：动态货币配置记录在 shared/schema.ts:93