# CLAUDE.md

本文件为 Claude Code (claude.ai/code) 在此仓库中工作时提供指导。

## 项目概述

**pay-bridge** 是一个前后端分离的全栈应用，monorepo 结构。

- **前端**: React，位于 `frontend/`
- **后端**: Go (Go 1.24)，位于 `backend/`

## 目录结构

```
pay-bridge/
├── backend/           # Go 后端
│   ├── cmd/server/    # 程序入口
│   ├── internal/      # 业务代码（api/service/repository/model/channel）
│   ├── pkg/           # 公共库（config/crypto/logger/sequence）
│   ├── configs/       # 配置文件和数据库迁移脚本
│   ├── go.mod
│   └── go.sum
├── frontend/          # React 前端
├── docs/              # 设计文档
└── CLAUDE.md
```

## 构建与运行命令

### 后端（在 `backend/` 目录下执行）

```bash
# 运行
go run ./cmd/server

# 构建
go build -o pay-bridge ./cmd/server

# 测试
go test ./...

# 运行单个测试
go test -run TestName ./path/to/package

# 代码检查
go vet ./...
```

### 前端（在 `frontend/` 目录下执行）

```bash
# 安装依赖
npm install

# 开发服务器
npm run dev

# 构建
npm run build
```

## 架构

- **后端**: Go 模块 (`module pay-bridge`)，4 层架构：API Handler → Service → Repository → DB/Redis，渠道适配器插件化注册。
- **前端**: React 应用，调用后端 REST API。