kami_shop/CODEBUDDY.md at develop

Files

danial 1a75269a61 feat(payment):重构微信支付页面并优化支付流程

- 重新设计支付页面UI，采用毛玻璃效果和动态背景- 更新支付接口调用方式，从表单提交改为JSON请求
-优化支付签名验证逻辑，统一错误处理方式
- 修改京东支付接口参数和返回结构体
- 移除OpenTelemetry追踪相关代码
- 添加支付倒计时功能和本地存储支持
- 优化支付按钮加载状态和交互反馈
- 调整HTML结构和CSS样式，提升用户体验

2025-10-11 21:56:09 +08:00

2.8 KiB

Raw Permalink Blame History

kami_shop

Development commands

Build (Linux amd64): ./build.sh
Run (dev): go run main.go
Tests: go test ./...
Single test file: go test ./internal/service/scan_shop_test.go
Verbose tests: go test -v ./...
Docker build: docker build -t kami_shop . -f deploy/Dockerfile
Docker Compose up: export VERSION=latest && docker-compose -f deploy/docker-compose.yaml up -d

Project architecture overview

Runtime: Go 1.24, Beego v2
Entry: main.go initializes OpenTelemetry/logging and starts Beego
Config: conf/app.local.conf (dev), conf/app.conf (prod); MySQL, Redis, ports, gateway URLs, secrets
HTTP routing: internal/routers/router.go maps routes to controllers
Controllers: internal/controllers/ handle payment endpoints (HTML and JSON flows)
Services: internal/service/ business logic; payment orchestration and external calls
Models: internal/models/ data structures and DB ops
Views/static: views/ templates and static assets for payment pages
Trace/log: internal/traceRouter provides OTEL setup, context propagation, and zap logger
Deploy: deploy/Dockerfile, docker-compose*.yaml; .drone.yml for CI image build and remote compose deploy

Key flows

Web pay (GET/HTML): /pay.html → PayController.Pay validates params, decrypts sign, checks timeout/keys, builds exValue, calls ScanShopController.Shop, redirects to /order-confirm.html or /error.html
API pay (form): POST /pay → PayWithJson parses params, VerifyPaySign, service.Pay, JSON response
API pay v2 (JSON): POST /api/pay → PayV2 JSON body, VerifyPaySign, ScanShopController.Shop, returns redirectUrl for client navigation
JD native: POST /order/pay/original/jd → PayOriginalJD validates OriginalJdReq, VerifyPaySign, service.PayWithJd, returns wxPay

Configuration essentials

MySQL: dev juhe_pay, prod kami; credentials/hosts in conf/*.conf
Redis: dev localhost:6379, prod redis:6379
Gateways: gateway/partial endpoints in conf/*.conf
Secrets: [secret] key/iv used for encryption/sign; do not commit real secrets

Observability/logging

traceRouter.InitTracer sets OTLP exporters (traces noop by default), metrics/log exporters, zap logger bridged via otelzap
Middleware utilities for context propagation and CreateSpan helpers; Logger.WithContext to include trace_id

CI/CD

.drone.yml builds and pushes image to git.oceanpay.cc and runs remote docker compose with BRANCH/DRONE vars

Local tips

Windows binary main.exe present; prefer go run main.go during development
build.sh compiles static Linux binary for container use

Important repository rules from CLAUDE.md

Use provided dev commands for build/run/test
Respect architecture boundaries: controllers → services → models; keep validation in controllers, business in services, persistence in models
Prefer JSON API (/api/pay) for programmatic integrations; HTML endpoints for browser flows

2.8 KiB Raw Permalink Blame History

2.8 KiB

Raw Permalink Blame History