20260507213409

2026-05-07 21:34:09 +08:00
1 parent 3070eac71b
commit 4c7f516a03
@@ -0,0 +1,129 @@
+# Project Context
+
+## Workspace
+
+- Root: `D:\workspace\code\app`
+- Git repository root: `D:\workspace`
+- Projects:
+  - `app-go`: Go backend.
+  - `app-rn`: Expo / React Native frontend.
+- Database connection memo:
+  - `D:\workspace\code\app\db.local.yml`
+  - This file is intentionally placed under `app` root and is currently Git-trackable.
+
+## Backend: app-go
+
+- Tech stack: Go, Fiber v3, pgx PostgreSQL client, JWT, Viper, Zap, S3/RustFS, QQ/WeChat login.
+- Main entry: `app-go/cmd/app/main.go`
+- Bootstrap: `app-go/internal/bootstrap/app.go`
+- Routes: `app-go/internal/router/router.go`
+- API base path from config: `/app`
+
+Important endpoints:
+
+- `POST /app/auth/login/qq`
+- `POST /app/auth/login/wechat`
+- `POST /app/bind/qq`
+- `POST /app/bind/wechat`
+- `POST /app/data/loadData`
+- `POST /app/data/loadDataBySql`
+- `POST /app/data/saveData`
+- `POST /app/data/getUniqueId`
+- `POST /app/s3/upload`
+- `POST /app/s3/delete`
+
+Architecture notes:
+
+- Backend exposes generic data APIs that accept table/view names, conditions, raw SQL, and save payloads.
+- This matches the frontend's generic `loadDataApi`, `loadDataBySqlApi`, and `saveDataApi`.
+- There are no explicit database foreign keys; relationships are enforced by code and naming conventions.
+- `go test ./...` currently fails in `pkg/uniqueid/IdGeneratorException.go` because `fmt.Println(message)` should likely be `fmt.Println(message...)`.
+
+Security notes:
+
+- Existing config files include live credentials.
+- User explicitly said they do not plan to modify the backend.
+- Database access was allowed with full permissions via the connection in `db.local.yml`.
+
+## Frontend: app-rn
+
+- Tech stack: Expo 55, React Native 0.83, React 19, expo-router, Zustand, Alova/Axios, HeroUI Native, Uniwind.
+- Main package file: `app-rn/package.json`
+- Root layout: `app-rn/src/app/_layout.tsx`
+- API wrapper: `app-rn/src/request/index.ts`
+- API methods: `app-rn/src/request/api.ts`
+- User store: `app-rn/src/store/user.ts`
+- Family store: `app-rn/src/store/family.ts`
+- Finance store: `app-rn/src/store/finance.ts`
+
+Frontend/backend contract:
+
+- Frontend reads `EXPO_PUBLIC_API_URL`.
+- Requests use Alova with Axios adapter.
+- Auth token is sent in custom `Token` header.
+- Backend response shape is `{ code, message, data, track_id }`.
+- Success code is `1000`.
+- Unauthorized code is `1001`.
+- Business error code is `2000`.
+- System error code is `3000`.
+
+Known frontend type-check issues:
+
+- `pnpm exec tsc --noEmit` fails.
+- `tsconfig.json` includes `**/*.ts` and `**/*.tsx`, which pulls in `example`.
+- `tsconfig.json` has a suspicious extra include entry: `src/app/auth/login_2`.
+- Generated iconfont components have `react-native-svg` prop type incompatibilities.
+- `src/app/finance/(tabs)/analysis/index.tsx` has `Surface variant="2"` type mismatch.
+
+## Database: allapp
+
+- PostgreSQL version observed: 18.1.
+- Database: `allapp`.
+- User used for inspection: `postgres`.
+- Schema: `public`.
+- Tables: 7.
+- Views: 1.
+- Explicit foreign keys: none.
+
+Tables and row counts at inspection time:
+
+- `b_user`: 1 row.
+- `b_user_oauth`: 2 rows.
+- `b_family`: 1 row.
+- `b_family_member`: 1 row.
+- `b_finance`: 0 rows.
+- `b_finance_category`: 20 rows.
+- `b_finance_category_default`: 20 rows.
+
+Main entities:
+
+- `b_user`: user profile, including nickname, avatar, last login time, name, phone, birth date.
+- `b_user_oauth`: third-party login bindings. Fields include `user_id`, `type`, `openid`.
+- `b_family`: family/space. Fields include `name`, `invite_code`, `owner_id`.
+- `b_family_member`: family membership. Fields include `family_id`, `user_id`, `role`, `nickname`.
+- `b_finance`: finance records. Fields include `category_id`, `family_id`, `amount`, `remark`, `record_time`.
+- `b_finance_category_default`: default finance category template.
+- `b_finance_category`: actual finance categories for a family.
+- `v_family_member`: view joining `b_family_member` with `b_user`.
+
+View definition summary:
+
+- `v_family_member` selects member fields from `b_family_member` and user profile fields from `b_user`.
+- Join condition: `b_user.id = b_family_member.user_id`.
+
+Finance category convention:
+
+- `type = 0`: expense.
+- `type = 1`: income.
+- Category icons match frontend iconfont names, for example:
+  - `finance_jiaotong`
+  - `finance_canyin`
+  - `finance_shicai`
+  - `finance_gouwu`
+  - `finance_gongzi`
+  - `finance_jianzhi`
+  - `finance_shouru`
+
+## Useful Mental Model
+
+This is a small full-stack personal/family app. The backend is intentionally generic and thin, while most product behavior lives in the React Native frontend and database table conventions. The database is part of the project context and should be considered when understanding features.
@@ -0,0 +1,37 @@
+*.o
+*.a
+*.so
+_obj
+_test
+*.[568vq]
+[568vq].out
+*.cgo1.go
+*.cgo2.c
+_cgo_defun.c
+_cgo_gotypes.go
+_cgo_export.*
+_testmain.go
+*.exe
+*.exe~
+*.test
+*.prof
+*.rar
+*.zip
+*.gz
+*.psd
+*.bmd
+*.cfg
+*.pptx
+*.log
+*nohup.out
+*settings.pyc
+*.sublime-project
+*.sublime-workspace
+!.gitkeep
+.DS_Store
+/.idea
+/.vscode
+/output
+*.local.yml
+dumped_hertz_remote_config.json
+		  
@@ -0,0 +1,18 @@
+package main
+
+import (
+	"allapp-go/internal/bootstrap"
+)
+
+func main() {
+	app, err := bootstrap.NewApp()
+	if err != nil {
+		panic(err)
+	}
+
+	defer app.Close()
+
+	if err := bootstrap.RunServer(app.Config); err != nil {
+		panic(err)
+	}
+}
@@ -0,0 +1,19 @@
+app:
+  port: 8087
+postgres:
+  host: 117.72.182.135
+  port: 5432
+  user: postgres
+  password: zhang520..
+  dbname: allapp
+  timezone: Asia/Shanghai
+  max_open_conns: 10
+  max_idle_conns: 5
+  conn_max_lifetime: 30m
+  sll_mode: false
+aws_s3:
+  region: us-east-1
+  access_key: 2c0sZEpPQyCVhoLGNzHS
+  secret_key: fRbcQPEhU8B0C3On4qIoJ19w5vXxTFD26LlAiae7
+  endpoint: http://118.89.70.199:9000
+  bucket: test
@@ -0,0 +1,7 @@
+app:
+  name: allapp
+  port: 8080
+  base_url: /app
+wechat:
+  app_id: wxdab3e21a1f7e392f
+  app_secret: 0895443c6fedfc21cb92c9cd60de2a26
@@ -0,0 +1,71 @@
+module allapp-go
+
+go 1.25.0
+
+require (
+	github.com/go-playground/validator/v10 v10.30.2
+	github.com/gofiber/fiber/v3 v3.1.0
+	github.com/golang-jwt/jwt/v5 v5.3.1
+	github.com/jackc/pgx/v5 v5.9.1
+	github.com/pkg/errors v0.9.1
+	github.com/spf13/viper v1.21.0
+	go.uber.org/zap v1.27.1
+	gopkg.in/natefinch/lumberjack.v2 v2.2.1
+)
+
+require (
+	github.com/andybalholm/brotli v1.2.0 // indirect
+	github.com/aws/aws-sdk-go-v2 v1.41.5 // indirect
+	github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.8 // indirect
+	github.com/aws/aws-sdk-go-v2/config v1.32.15 // indirect
+	github.com/aws/aws-sdk-go-v2/credentials v1.19.14 // indirect
+	github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.21 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/configsources v1.4.21 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.21 // indirect
+	github.com/aws/aws-sdk-go-v2/internal/v4a v1.4.22 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.7 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.9.13 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.21 // indirect
+	github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.19.21 // indirect
+	github.com/aws/aws-sdk-go-v2/service/s3 v1.99.0 // indirect
+	github.com/aws/aws-sdk-go-v2/service/signin v1.0.9 // indirect
+	github.com/aws/aws-sdk-go-v2/service/sso v1.30.15 // indirect
+	github.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.19 // indirect
+	github.com/aws/aws-sdk-go-v2/service/sts v1.41.10 // indirect
+	github.com/aws/smithy-go v1.24.2 // indirect
+	github.com/fsnotify/fsnotify v1.9.0 // indirect
+	github.com/fxamacker/cbor/v2 v2.9.0 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.13 // indirect
+	github.com/go-playground/locales v0.14.1 // indirect
+	github.com/go-playground/universal-translator v0.18.1 // indirect
+	github.com/go-viper/mapstructure/v2 v2.4.0 // indirect
+	github.com/gofiber/schema v1.7.0 // indirect
+	github.com/gofiber/utils/v2 v2.0.2 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/jackc/pgpassfile v1.0.0 // indirect
+	github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
+	github.com/jackc/puddle/v2 v2.2.2 // indirect
+	github.com/klauspost/compress v1.18.4 // indirect
+	github.com/leodido/go-urn v1.4.0 // indirect
+	github.com/mattn/go-colorable v0.1.14 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/pelletier/go-toml/v2 v2.2.4 // indirect
+	github.com/philhofer/fwd v1.2.0 // indirect
+	github.com/sagikazarmark/locafero v0.11.0 // indirect
+	github.com/sourcegraph/conc v0.3.1-0.20240121214520-5f936abd7ae8 // indirect
+	github.com/spf13/afero v1.15.0 // indirect
+	github.com/spf13/cast v1.10.0 // indirect
+	github.com/spf13/pflag v1.0.10 // indirect
+	github.com/subosito/gotenv v1.6.0 // indirect
+	github.com/tinylib/msgp v1.6.3 // indirect
+	github.com/valyala/bytebufferpool v1.0.0 // indirect
+	github.com/valyala/fasthttp v1.69.0 // indirect
+	github.com/x448/float16 v0.8.4 // indirect
+	go.uber.org/multierr v1.10.0 // indirect
+	go.yaml.in/yaml/v3 v3.0.4 // indirect
+	golang.org/x/crypto v0.49.0 // indirect
+	golang.org/x/net v0.51.0 // indirect
+	golang.org/x/sync v0.20.0 // indirect
+	golang.org/x/sys v0.42.0 // indirect
+	golang.org/x/text v0.35.0 // indirect
+)
@@ -0,0 +1,159 @@
+github.com/andybalholm/brotli v1.2.0 h1:ukwgCxwYrmACq68yiUqwIWnGY0cTPox/M94sVwToPjQ=
+github.com/andybalholm/brotli v1.2.0/go.mod h1:rzTDkvFWvIrjDXZHkuS16NPggd91W3kUSvPlQ1pLaKY=
+github.com/aws/aws-sdk-go-v2 v1.41.5 h1:dj5kopbwUsVUVFgO4Fi5BIT3t4WyqIDjGKCangnV/yY=
+github.com/aws/aws-sdk-go-v2 v1.41.5/go.mod h1:mwsPRE8ceUUpiTgF7QmQIJ7lgsKUPQOUl3o72QBrE1o=
+github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.8 h1:eBMB84YGghSocM7PsjmmPffTa+1FBUeNvGvFou6V/4o=
+github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.8/go.mod h1:lyw7GFp3qENLh7kwzf7iMzAxDn+NzjXEAGjKS2UOKqI=
+github.com/aws/aws-sdk-go-v2/config v1.32.15 h1:i7rHbaySnBXGvCkDndaBU8f3EAlRVgViwNfkwFUrXgE=
+github.com/aws/aws-sdk-go-v2/config v1.32.15/go.mod h1:yLJzL0IkI9+4BwjPSOueyHzppJj3t0dhK5tbmmcFk5Q=
+github.com/aws/aws-sdk-go-v2/credentials v1.19.14 h1:n+UcGWAIZHkXzYt87uMFBv/l8THYELoX6gVcUvgl6fI=
+github.com/aws/aws-sdk-go-v2/credentials v1.19.14/go.mod h1:cJKuyWB59Mqi0jM3nFYQRmnHVQIcgoxjEMAbLkpr62w=
+github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.21 h1:NUS3K4BTDArQqNu2ih7yeDLaS3bmHD0YndtA6UP884g=
+github.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.21/go.mod h1:YWNWJQNjKigKY1RHVJCuupeWDrrHjRqHm0N9rdrWzYI=
+github.com/aws/aws-sdk-go-v2/internal/configsources v1.4.21 h1:Rgg6wvjjtX8bNHcvi9OnXWwcE0a2vGpbwmtICOsvcf4=
+github.com/aws/aws-sdk-go-v2/internal/configsources v1.4.21/go.mod h1:A/kJFst/nm//cyqonihbdpQZwiUhhzpqTsdbhDdRF9c=
+github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.21 h1:PEgGVtPoB6NTpPrBgqSE5hE/o47Ij9qk/SEZFbUOe9A=
+github.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.21/go.mod h1:p+hz+PRAYlY3zcpJhPwXlLC4C+kqn70WIHwnzAfs6ps=
+github.com/aws/aws-sdk-go-v2/internal/v4a v1.4.22 h1:rWyie/PxDRIdhNf4DzRk0lvjVOqFJuNnO8WwaIRVxzQ=
+github.com/aws/aws-sdk-go-v2/internal/v4a v1.4.22/go.mod h1:zd/JsJ4P7oGfUhXn1VyLqaRZwPmZwg44Jf2dS84Dm3Y=
+github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.7 h1:5EniKhLZe4xzL7a+fU3C2tfUN4nWIqlLesfrjkuPFTY=
+github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.7/go.mod h1:x0nZssQ3qZSnIcePWLvcoFisRXJzcTVvYpAAdYX8+GI=
+github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.9.13 h1:JRaIgADQS/U6uXDqlPiefP32yXTda7Kqfx+LgspooZM=
+github.com/aws/aws-sdk-go-v2/service/internal/checksum v1.9.13/go.mod h1:CEuVn5WqOMilYl+tbccq8+N2ieCy0gVn3OtRb0vBNNM=
+github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.21 h1:c31//R3xgIJMSC8S6hEVq+38DcvUlgFY0FM6mSI5oto=
+github.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.21/go.mod h1:r6+pf23ouCB718FUxaqzZdbpYFyDtehyZcmP5KL9FkA=
+github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.19.21 h1:ZlvrNcHSFFWURB8avufQq9gFsheUgjVD9536obIknfM=
+github.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.19.21/go.mod h1:cv3TNhVrssKR0O/xxLJVRfd2oazSnZnkUeTf6ctUwfQ=
+github.com/aws/aws-sdk-go-v2/service/s3 v1.99.0 h1:hlSuz394kV0vhv9drL5lhuEFbEOEP1VyQpy15qWh1Pk=
+github.com/aws/aws-sdk-go-v2/service/s3 v1.99.0/go.mod h1:uoA43SdFwacedBfSgfFSjjCvYe8aYBS7EnU5GZ/YKMM=
+github.com/aws/aws-sdk-go-v2/service/signin v1.0.9 h1:QKZH0S178gCmFEgst8hN0mCX1KxLgHBKKY/CLqwP8lg=
+github.com/aws/aws-sdk-go-v2/service/signin v1.0.9/go.mod h1:7yuQJoT+OoH8aqIxw9vwF+8KpvLZ8AWmvmUWHsGQZvI=
+github.com/aws/aws-sdk-go-v2/service/sso v1.30.15 h1:lFd1+ZSEYJZYvv9d6kXzhkZu07si3f+GQ1AaYwa2LUM=
+github.com/aws/aws-sdk-go-v2/service/sso v1.30.15/go.mod h1:WSvS1NLr7JaPunCXqpJnWk1Bjo7IxzZXrZi1QQCkuqM=
+github.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.19 h1:dzztQ1YmfPrxdrOiuZRMF6fuOwWlWpD2StNLTceKpys=
+github.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.19/go.mod h1:YO8TrYtFdl5w/4vmjL8zaBSsiNp3w0L1FfKVKenZT7w=
+github.com/aws/aws-sdk-go-v2/service/sts v1.41.10 h1:p8ogvvLugcR/zLBXTXrTkj0RYBUdErbMnAFFp12Lm/U=
+github.com/aws/aws-sdk-go-v2/service/sts v1.41.10/go.mod h1:60dv0eZJfeVXfbT1tFJinbHrDfSJ2GZl4Q//OSSNAVw=
+github.com/aws/smithy-go v1.24.2 h1:FzA3bu/nt/vDvmnkg+R8Xl46gmzEDam6mZ1hzmwXFng=
+github.com/aws/smithy-go v1.24.2/go.mod h1:YE2RhdIuDbA5E5bTdciG9KrW3+TiEONeUWCqxX9i1Fc=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/frankban/quicktest v1.14.6 h1:7Xjx+VpznH+oBnejlPUj8oUpdxnVs4f8XU8WnHkI4W8=
+github.com/frankban/quicktest v1.14.6/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0=
+github.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S9k=
+github.com/fsnotify/fsnotify v1.9.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0=
+github.com/fxamacker/cbor/v2 v2.9.0 h1:NpKPmjDBgUfBms6tr6JZkTHtfFGcMKsw3eGcmD/sapM=
+github.com/fxamacker/cbor/v2 v2.9.0/go.mod h1:vM4b+DJCtHn+zz7h3FFp/hDAI9WNWCsZj23V5ytsSxQ=
+github.com/gabriel-vasile/mimetype v1.4.13 h1:46nXokslUBsAJE/wMsp5gtO500a4F3Nkz9Ufpk2AcUM=
+github.com/gabriel-vasile/mimetype v1.4.13/go.mod h1:d+9Oxyo1wTzWdyVUPMmXFvp4F9tea18J8ufA774AB3s=
+github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
+github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
+github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
+github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
+github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
+github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
+github.com/go-playground/validator/v10 v10.30.2 h1:JiFIMtSSHb2/XBUbWM4i/MpeQm9ZK2xqPNk8vgvu5JQ=
+github.com/go-playground/validator/v10 v10.30.2/go.mod h1:mAf2pIOVXjTEBrwUMGKkCWKKPs9NheYGabeB04txQSc=
+github.com/go-viper/mapstructure/v2 v2.4.0 h1:EBsztssimR/CONLSZZ04E8qAkxNYq4Qp9LvH92wZUgs=
+github.com/go-viper/mapstructure/v2 v2.4.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
+github.com/gofiber/fiber/v3 v3.1.0 h1:1p4I820pIa+FGxfwWuQZ5rAyX0WlGZbGT6Hnuxt6hKY=
+github.com/gofiber/fiber/v3 v3.1.0/go.mod h1:n2nYQovvL9z3Too/FGOfgtERjW3GQcAUqgfoezGBZdU=
+github.com/gofiber/schema v1.7.0 h1:yNM+FNRZjyYEli9Ey0AXRBrAY9jTnb+kmGs3lJGPvKg=
+github.com/gofiber/schema v1.7.0/go.mod h1:A/X5Ffyru4p9eBdp99qu+nzviHzQiZ7odLT+TwxWhbk=
+github.com/gofiber/utils/v2 v2.0.2 h1:ShRRssz0F3AhTlAQcuEj54OEDtWF7+HJDwEi/aa6QLI=
+github.com/gofiber/utils/v2 v2.0.2/go.mod h1:+9Ub4NqQ+IaJoTliq5LfdmOJAA/Hzwf4pXOxOa3RrJ0=
+github.com/golang-jwt/jwt/v5 v5.3.1 h1:kYf81DTWFe7t+1VvL7eS+jKFVWaUnK9cB1qbwn63YCY=
+github.com/golang-jwt/jwt/v5 v5.3.1/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=
+github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
+github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
+github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
+github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo=
+github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
+github.com/jackc/pgx/v5 v5.9.1 h1:uwrxJXBnx76nyISkhr33kQLlUqjv7et7b9FjCen/tdc=
+github.com/jackc/pgx/v5 v5.9.1/go.mod h1:mal1tBGAFfLHvZzaYh77YS/eC6IX9OWbRV1QIIM0Jn4=
+github.com/jackc/puddle/v2 v2.2.2 h1:PR8nw+E/1w0GLuRFSmiioY6UooMp6KJv0/61nB7icHo=
+github.com/jackc/puddle/v2 v2.2.2/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
+github.com/klauspost/compress v1.18.4 h1:RPhnKRAQ4Fh8zU2FY/6ZFDwTVTxgJ/EMydqSTzE9a2c=
+github.com/klauspost/compress v1.18.4/go.mod h1:R0h/fSBs8DE4ENlcrlib3PsXS61voFxhIs2DeRhCvJ4=
+github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
+github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
+github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
+github.com/mattn/go-colorable v0.1.14 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHPsaIE=
+github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/pelletier/go-toml/v2 v2.2.4 h1:mye9XuhQ6gvn5h28+VilKrrPoQVanw5PMw/TB0t5Ec4=
+github.com/pelletier/go-toml/v2 v2.2.4/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY=
+github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM=
+github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM=
+github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
+github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rogpeppe/go-internal v1.9.0 h1:73kH8U+JUqXU8lRuOHeVHaa/SZPifC7BkcraZVejAe8=
+github.com/rogpeppe/go-internal v1.9.0/go.mod h1:WtVeX8xhTBvf0smdhujwtBcq4Qrzq/fJaraNFVN+nFs=
+github.com/sagikazarmark/locafero v0.11.0 h1:1iurJgmM9G3PA/I+wWYIOw/5SyBtxapeHDcg+AAIFXc=
+github.com/sagikazarmark/locafero v0.11.0/go.mod h1:nVIGvgyzw595SUSUE6tvCp3YYTeHs15MvlmU87WwIik=
+github.com/shamaton/msgpack/v3 v3.1.0 h1:jsk0vEAqVvvS9+fTZ5/EcQ9tz860c9pWxJ4Iwecz8gU=
+github.com/shamaton/msgpack/v3 v3.1.0/go.mod h1:DcQG8jrdrQCIxr3HlMYkiXdMhK+KfN2CitkyzsQV4uc=
+github.com/sourcegraph/conc v0.3.1-0.20240121214520-5f936abd7ae8 h1:+jumHNA0Wrelhe64i8F6HNlS8pkoyMv5sreGx2Ry5Rw=
+github.com/sourcegraph/conc v0.3.1-0.20240121214520-5f936abd7ae8/go.mod h1:3n1Cwaq1E1/1lhQhtRK2ts/ZwZEhjcQeJQ1RuC6Q/8U=
+github.com/spf13/afero v1.15.0 h1:b/YBCLWAJdFWJTN9cLhiXXcD7mzKn9Dm86dNnfyQw1I=
+github.com/spf13/afero v1.15.0/go.mod h1:NC2ByUVxtQs4b3sIUphxK0NioZnmxgyCrfzeuq8lxMg=
+github.com/spf13/cast v1.10.0 h1:h2x0u2shc1QuLHfxi+cTJvs30+ZAHOGRic8uyGTDWxY=
+github.com/spf13/cast v1.10.0/go.mod h1:jNfB8QC9IA6ZuY2ZjDp0KtFO2LZZlg4S/7bzP6qqeHo=
+github.com/spf13/pflag v1.0.10 h1:4EBh2KAYBwaONj6b2Ye1GiHfwjqyROoF4RwYO+vPwFk=
+github.com/spf13/pflag v1.0.10/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+github.com/spf13/viper v1.21.0 h1:x5S+0EU27Lbphp4UKm1C+1oQO+rKx36vfCoaVebLFSU=
+github.com/spf13/viper v1.21.0/go.mod h1:P0lhsswPGWD/1lZJ9ny3fYnVqxiegrlNrEmgLjbTCAY=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
+github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+github.com/subosito/gotenv v1.6.0 h1:9NlTDc1FTs4qu0DDq7AEtTPNw6SVm7uBMsUCUjABIf8=
+github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU=
+github.com/tinylib/msgp v1.6.3 h1:bCSxiTz386UTgyT1i0MSCvdbWjVW+8sG3PjkGsZQt4s=
+github.com/tinylib/msgp v1.6.3/go.mod h1:RSp0LW9oSxFut3KzESt5Voq4GVWyS+PSulT77roAqEA=
+github.com/valyala/bytebufferpool v1.0.0 h1:GqA5TC/0021Y/b9FG4Oi9Mr3q7XYx6KllzawFIhcdPw=
+github.com/valyala/bytebufferpool v1.0.0/go.mod h1:6bBcMArwyJ5K/AmCkWv1jt77kVWyCJ6HpOuEn7z0Csc=
+github.com/valyala/fasthttp v1.69.0 h1:fNLLESD2SooWeh2cidsuFtOcrEi4uB4m1mPrkJMZyVI=
+github.com/valyala/fasthttp v1.69.0/go.mod h1:4wA4PfAraPlAsJ5jMSqCE2ug5tqUPwKXxVj8oNECGcw=
+github.com/x448/float16 v0.8.4 h1:qLwI1I70+NjRFUR3zs1JPUCgaCXSh3SW62uAKT1mSBM=
+github.com/x448/float16 v0.8.4/go.mod h1:14CWIYCyZA/cWjXOioeEpHeN/83MdbZDRQHoFcYsOfg=
+github.com/xyproto/randomstring v1.0.5 h1:YtlWPoRdgMu3NZtP45drfy1GKoojuR7hmRcnhZqKjWU=
+github.com/xyproto/randomstring v1.0.5/go.mod h1:rgmS5DeNXLivK7YprL0pY+lTuhNQW3iGxZ18UQApw/E=
+go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=
+go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=
+go.uber.org/multierr v1.10.0 h1:S0h4aNzvfcFsC3dRF1jLoaov7oRaKqRGC/pUEJ2yvPQ=
+go.uber.org/multierr v1.10.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
+go.uber.org/zap v1.27.1 h1:08RqriUEv8+ArZRYSTXy1LeBScaMpVSTBhCeaZYfMYc=
+go.uber.org/zap v1.27.1/go.mod h1:GB2qFLM7cTU87MWRP2mPIjqfIDnGu+VIO4V/SdhGo2E=
+go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
+golang.org/x/crypto v0.49.0 h1:+Ng2ULVvLHnJ/ZFEq4KdcDd/cfjrrjjNSXNzxg0Y4U4=
+golang.org/x/crypto v0.49.0/go.mod h1:ErX4dUh2UM+CFYiXZRTcMpEcN8b/1gxEuv3nODoYtCA=
+golang.org/x/net v0.51.0 h1:94R/GTO7mt3/4wIKpcR5gkGmRLOuE/2hNGeWq/GBIFo=
+golang.org/x/net v0.51.0/go.mod h1:aamm+2QF5ogm02fjy5Bb7CQ0WMt1/WVM7FtyaTLlA9Y=
+golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4=
+golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.42.0 h1:omrd2nAlyT5ESRdCLYdm3+fMfNFE/+Rf4bDIQImRJeo=
+golang.org/x/sys v0.42.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.35.0 h1:JOVx6vVDFokkpaq1AEptVzLTpDe9KGpj5tR4/X+ybL8=
+golang.org/x/text v0.35.0/go.mod h1:khi/HExzZJ2pGnjenulevKNX1W67CUy0AsXcNubPGCA=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
+gopkg.in/natefinch/lumberjack.v2 v2.2.1 h1:bBRl1b0OH9s/DuPhuXpNl+VtCaJXFZ5/uEFST95x9zc=
+gopkg.in/natefinch/lumberjack.v2 v2.2.1/go.mod h1:YD8tP3GAjkrDg1eZH7EGmyESg/lsYskCTPBJVb9jqSc=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
@@ -0,0 +1,64 @@
+package bootstrap
+
+import (
+	"allapp-go/internal/bootstrap/boots"
+	"allapp-go/internal/config"
+	"allapp-go/pkg/db"
+	"allapp-go/pkg/logger"
+	"allapp-go/pkg/s3store"
+	"allapp-go/pkg/wechat"
+
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+type App struct {
+	Config *config.Config
+	PgSql  *pgxpool.Pool
+}
+
+// ======================
+// 初始化
+// ======================
+
+func NewApp() (*App, error) {
+	cfg, err := config.Load()
+	if err != nil {
+		return nil, err
+	}
+
+	// 日志
+	boots.InitLogger(cfg)
+
+	// S3
+	s3store.NewS3Client(cfg)
+
+	// 数据库
+	pgsql, err := boots.InitPgsql(cfg)
+	if err != nil {
+		return nil, err
+	}
+
+	db.Init(pgsql)
+
+	// 其他组件
+	boots.InitUniqueId(cfg)
+	boots.InitJwt(cfg)
+	wechat.Init(cfg.Wechat.AppId, cfg.Wechat.AppSecret)
+
+	return &App{
+		Config: cfg,
+		PgSql:  pgsql,
+	}, nil
+}
+
+// ======================
+// 释放资源
+// ======================
+
+func (a *App) Close() {
+	if a.PgSql != nil {
+		a.PgSql.Close()
+	}
+
+	logger.Sync()
+}
@@ -0,0 +1,18 @@
+package boots
+
+import (
+	"allapp-go/internal/config"
+	"allapp-go/pkg/logger"
+)
+
+func InitLogger(cfg *config.Config) {
+	logger.Init(logger.Config{
+		Dir:        "logs",
+		Level:      "info",
+		MaxSize:    100, // MB
+		MaxBackups: 10,
+		MaxAge:     7, // 天
+		Compress:   true,
+	})
+	defer logger.Sync()
+}
@@ -0,0 +1,11 @@
+package boots
+
+import (
+	"allapp-go/internal/config"
+	"allapp-go/pkg/jwtx"
+)
+
+// InitJwt 初始化Jwt
+func InitJwt(cfg *config.Config) {
+	jwtx.Init(cfg.JWT.Secret, cfg.JWT.AccessExpiry)
+}
@@ -0,0 +1,100 @@
+package boots
+
+import (
+	"allapp-go/internal/config"
+	"context"
+	"fmt"
+	"net/url"
+	"time"
+
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+func InitPgsql(cfg *config.Config) (*pgxpool.Pool, error) {
+	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+	defer cancel()
+
+	pg := cfg.Postgres
+
+	// ssl
+	sslMode := "disable"
+	if pg.SslMode {
+		sslMode = "require"
+	}
+
+	// 密码转义
+	password := url.QueryEscape(pg.Password)
+
+	// DSN
+	dsn := fmt.Sprintf(
+		"postgres://%s:%s@%s:%d/%s?sslmode=%s",
+		pg.User,
+		password,
+		pg.Host,
+		pg.Port,
+		pg.Dbname,
+		sslMode,
+	)
+
+	// 解析配置
+	conf, err := pgxpool.ParseConfig(dsn)
+	if err != nil {
+		return nil, err
+	}
+
+	// ======================
+	// 连接池配置（带默认值）
+	// ======================
+
+	// 默认最大连接数
+	maxConns := int32(20)
+	if pg.MaxOpenConns > 0 {
+		maxConns = int32(pg.MaxOpenConns)
+	}
+
+	// 默认最小连接数
+	minConns := int32(2)
+	if pg.MaxIdleConns > 0 {
+		minConns = int32(pg.MaxIdleConns)
+	}
+
+	// 防止配置错误：min > max
+	if minConns > maxConns {
+		minConns = maxConns
+	}
+
+	// 应用配置
+	conf.MaxConns = maxConns
+	conf.MinConns = minConns
+
+	// 默认连接最大生命周期
+	if pg.ConnMaxLifetime > 0 {
+		conf.MaxConnLifetime = pg.ConnMaxLifetime
+	} else {
+		conf.MaxConnLifetime = time.Hour
+	}
+
+	// （推荐补充）空闲连接最大存活时间
+	conf.MaxConnIdleTime = 30 * time.Minute
+
+	// ======================
+	// 时区设置（正确方式 ⭐）
+	// ======================
+	if pg.TimeZone != "" {
+		conf.ConnConfig.RuntimeParams["TimeZone"] = pg.TimeZone
+	}
+
+	// 创建连接池
+	db, err := pgxpool.NewWithConfig(ctx, conf)
+	if err != nil {
+		return nil, err
+	}
+
+	// 测试连接
+	if err := db.Ping(ctx); err != nil {
+		db.Close()
+		return nil, err
+	}
+
+	return db, nil
+}
@@ -0,0 +1,12 @@
+package boots
+
+import (
+	"allapp-go/internal/config"
+	"allapp-go/pkg/uniqueid"
+)
+
+// InitUniqueId 初始化雪花id
+func InitUniqueId(cfg *config.Config) {
+	options := uniqueid.NewIdGeneratorOptions(cfg.UniqueID.WorkerID)
+	uniqueid.SetIdGenerator(options)
+}
@@ -0,0 +1,35 @@
+package bootstrap
+
+import (
+	"allapp-go/internal/config"
+	"allapp-go/internal/errors"
+	"allapp-go/internal/middleware"
+	"allapp-go/internal/router"
+	"allapp-go/pkg/logger"
+	"fmt"
+
+	"github.com/gofiber/fiber/v3"
+	"github.com/gofiber/fiber/v3/middleware/recover"
+	"github.com/gofiber/fiber/v3/middleware/requestid"
+)
+
+func RunServer(cfg *config.Config) error {
+	app := fiber.New(fiber.Config{
+		ErrorHandler: errors.ErrorHandler(),
+		BodyLimit:    20 * 1024 * 1024, // 20MB
+	})
+
+	// ===== middleware =====
+	app.Use(recover.New())
+	app.Use(requestid.New())
+	app.Use(middleware.Logger())
+
+	// ===== router =====
+	router.SetupRouter(app, cfg)
+
+	addr := fmt.Sprintf(":%d", cfg.App.Port)
+
+	logger.Log.Info("服务启动")
+
+	return app.Listen(addr)
+}
@@ -0,0 +1,54 @@
+package config
+
+import "time"
+
+type Config struct {
+	App      AppConfig      `mapstructure:"app"`
+	JWT      JwtConfig      `mapstructure:"jwt"`
+	UniqueID UniqueIDConfig `mapstructure:"unique_id"`
+	Postgres PostgresConfig `mapstructure:"postgres"`
+	Wechat   WechatConfig   `mapstructure:"wechat"`
+	AwsS3    AwsS3Config    `mapstructure:"aws_s3"`
+}
+
+type AppConfig struct {
+	Name    string `mapstructure:"name"`
+	Port    int    `mapstructure:"port"`
+	BaseUrl string `mapstructure:"base_url"`
+}
+
+type PostgresConfig struct {
+	Host            string        `mapstructure:"host"`
+	Port            int           `mapstructure:"port"`
+	User            string        `mapstructure:"user"`
+	Password        string        `mapstructure:"password"`
+	Dbname          string        `mapstructure:"dbname"`
+	SslMode         bool          `mapstructure:"ssl_mode"`
+	TimeZone        string        `mapstructure:"timezone"`
+	MaxOpenConns    int32         `mapstructure:"max_open_conns"`
+	MaxIdleConns    int32         `mapstructure:"max_idle_conns"`
+	ConnMaxLifetime time.Duration `mapstructure:"conn_max_lifetime"`
+}
+
+type JwtConfig struct {
+	Secret       string        `mapstructure:"secret"`
+	AccessExpiry time.Duration `mapstructure:"access_expiry"`
+}
+
+type UniqueIDConfig struct {
+	DataCenterID uint16 `mapstructure:"datacenter_id"`
+	WorkerID     uint16 `mapstructure:"worker_id"`
+}
+
+type WechatConfig struct {
+	AppId     string `mapstructure:"app_id"`
+	AppSecret string `mapstructure:"app_secret"`
+}
+
+type AwsS3Config struct {
+	Region    string `mapstructure:"region"`
+	AccessKey string `mapstructure:"access_key"`
+	SecretKey string `mapstructure:"secret_key"`
+	Bucket    string `mapstructure:"bucket"`
+	Endpoint  string `mapstructure:"endpoint"`
+}
@@ -0,0 +1,68 @@
+package config
+
+import (
+	"fmt"
+	"os"
+	"strings"
+
+	"github.com/spf13/viper"
+)
+
+func Load() (*Config, error) {
+	env := getEnv("APP_ENV", "dev")
+
+	v := viper.New()
+	v.SetConfigType("yaml")
+
+	// ✅ 默认值
+	setDefaults(v)
+
+	// ✅ 支持环境变量（如 APP_PORT → app.port）
+	v.AutomaticEnv()
+	v.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))
+
+	// 基础配置
+	v.AddConfigPath("configs")
+	v.SetConfigName("config")
+
+	if err := v.ReadInConfig(); err != nil {
+		return nil, fmt.Errorf("读取基础配置失败: %w", err)
+	}
+
+	// 环境配置（覆盖）
+	envConfigName := fmt.Sprintf("config.%s", env)
+	v.SetConfigName(envConfigName)
+
+	if err := v.MergeInConfig(); err != nil {
+		// dev 可以没有，prod 必须有
+		if env == "prod" {
+			return nil, fmt.Errorf("读取环境配置失败(%s): %w", env, err)
+		}
+	}
+
+	var cfg Config
+	if err := v.Unmarshal(&cfg); err != nil {
+		return nil, fmt.Errorf("解析配置失败: %w", err)
+	}
+
+	return &cfg, nil
+}
+
+// ✅ 默认值统一在这里管理
+func setDefaults(v *viper.Viper) {
+	v.SetDefault("app.name", "allapp-go")
+	v.SetDefault("app.port", 8080)
+	v.SetDefault("app.base_url", "app")
+
+	// 可以继续扩展
+	v.SetDefault("unique_id.datacenter_id", 1)
+	v.SetDefault("unique_id.worker_id", 1)
+}
+
+func getEnv(key, defaultVal string) string {
+	val := os.Getenv(key)
+	if val == "" {
+		return defaultVal
+	}
+	return strings.ToLower(val)
+}
@@ -0,0 +1,10 @@
+package errors
+
+import "github.com/pkg/errors"
+
+func WithStack(err error) error {
+	if err == nil {
+		return nil
+	}
+	return errors.WithStack(err)
+}
@@ -0,0 +1,31 @@
+package errors
+
+import (
+	"allapp-go/internal/httpx"
+	"allapp-go/pkg/logger"
+	"errors"
+	"fmt"
+
+	"github.com/gofiber/fiber/v3"
+	"go.uber.org/zap"
+)
+
+func ErrorHandler() fiber.ErrorHandler {
+	return func(c fiber.Ctx, err error) error {
+		code := fiber.StatusInternalServerError
+		msg := "系统异常，请稍后再试！"
+
+		var e *fiber.Error
+		if errors.As(err, &e) {
+			code = e.Code
+			msg = e.Message
+		}
+
+		logger.FromCtx(c.Context()).Error("HTTP 请求异常",
+			zap.Int("status", code),
+			zap.String("error", fmt.Sprintf("%+v", err)),
+		)
+
+		return httpx.SystemError(c, msg)
+	}
+}
@@ -0,0 +1,445 @@
+package handle
+
+import (
+	"allapp-go/internal/errors"
+	"allapp-go/internal/httpx"
+	"allapp-go/internal/middleware"
+	"allapp-go/internal/types"
+	"allapp-go/pkg/db"
+	"allapp-go/pkg/jwtx"
+	"allapp-go/pkg/requestx"
+	"allapp-go/pkg/s3store"
+	"allapp-go/pkg/uniqueid"
+	"allapp-go/pkg/wechat"
+	"bytes"
+	"fmt"
+	"io"
+	"net/url"
+	"path/filepath"
+	"time"
+
+	"github.com/gofiber/fiber/v3"
+	"github.com/gofiber/fiber/v3/log"
+	"github.com/google/uuid"
+)
+
+// LoginQq ======================== QQ 登录 ========================
+func LoginQq(c fiber.Ctx) error {
+	var req types.LoginQqReq
+	vo := new(types.LoginResp)
+
+	if err := httpx.BindAndValidate(c, &req); err != nil {
+		return errors.WithStack(err)
+	}
+
+	return handleThirdLogin(c, req.Openid, req.Nickname, req.Avatar, 1, vo)
+}
+
+// LoginWechat ======================== 微信登录 ========================
+func LoginWechat(c fiber.Ctx) error {
+	var req types.LoginWechatReq
+	vo := new(types.LoginResp)
+
+	if err := httpx.BindAndValidate(c, &req); err != nil {
+		return errors.WithStack(err)
+	}
+
+	openid, token, err := wechat.GetWechatAccess(req.Code)
+	if err != nil {
+		log.Errorw("微信获取Token失败", "code", req.Code, "error", err)
+		return httpx.Fail(c, "微信登录失败，请重试")
+	}
+
+	nickname, avatar, err := wechat.GetWechatUserInfo(token, openid)
+	if err != nil {
+		log.Errorw("微信获取用户信息系失败", "openid", openid, "error", err)
+		return httpx.Fail(c, "微信登录失败，请重试")
+	}
+
+	return handleThirdLogin(c, openid, nickname, avatar, 0, vo)
+}
+
+// ======================== 第三方登录主流程 ========================
+func handleThirdLogin(
+	c fiber.Ctx,
+	openid string,
+	nickname string,
+	avatar string,
+	loginType int16,
+	vo *types.LoginResp,
+) error {
+	dbClient := db.New()
+
+	user, err := getUserByOpenID(dbClient, c, openid, loginType)
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	// 不存在 -> 注册
+	if user == nil {
+		return registerUser(dbClient, c, openid, nickname, avatar, loginType, vo)
+	}
+
+	// ========= 校验状态 =========
+	id := toInt64(user["id"])
+
+	// ========= 更新登录时间 =========
+	if err := dbClient.Update(
+		c.Context(),
+		"b_user",
+		"id",
+		map[string]any{
+			"id":              id,
+			"last_login_time": "NOW()",
+		},
+	); err != nil {
+		return errors.WithStack(err)
+	}
+
+	// ========= token =========
+	token, err := jwtx.CreateToken(c.Context(), jwtx.TokenData{
+		UserID: id,
+	})
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	familyMembers, err := dbClient.LoadData(
+		c.Context(),
+		"b_family_member",
+		"user_id = ?",
+		"",
+		[]string{"family_id"},
+		[]any{id},
+	)
+
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	if len(familyMembers) == 0 {
+		vo.FamilyId = 0
+	} else {
+		familyMember := familyMembers[0]
+
+		familyId := toInt64(familyMember["family_id"])
+
+		vo.FamilyId = familyId
+	}
+
+	// ========= 返回 =========
+	vo.Token = token
+	vo.UserId = id
+	vo.Nickname, _ = user["nickname"].(string)
+	vo.Avatar, _ = user["avatar"].(string)
+
+	return httpx.OK(c, vo)
+}
+
+// ======================== 注册 ========================
+func registerUser(
+	dbClient *db.Client,
+	c fiber.Ctx,
+	openid, nickname, avatar string,
+	loginType int16,
+	vo *types.LoginResp,
+) error {
+	userId := uniqueid.NextId()
+
+	defaultAvatar := "https://default-avatar-url.com/default.png"
+
+	if nickname == "" {
+		nickname = fmt.Sprintf("用户_%d", userId)
+	}
+
+	if avatar == "" {
+		avatar = defaultAvatar
+	} else {
+		// 下载头像（流式）
+		stream, size, contentType, err := requestx.GetFileStream(c.Context(), avatar)
+		if err != nil {
+			avatar = defaultAvatar
+		} else {
+			defer func() {
+				_ = stream.Close()
+			}()
+
+			// ✅ 只在这里转成可 seek
+			data, err := io.ReadAll(stream)
+			if err != nil {
+				return err
+			}
+
+			reader := bytes.NewReader(data)
+
+			// ✅ 从 avatar URL 获取扩展名（简化版）
+			u, _ := url.Parse(avatar)
+			ext := filepath.Ext(u.Path)
+			if ext == "" {
+				ext = ".jpg" // 兜底
+			}
+
+			// 年月日 + uuid
+			now := time.Now()
+			key := fmt.Sprintf("%d/%02d/%02d/%s%s",
+				now.Year(),
+				now.Month(),
+				now.Day(),
+				uuid.NewString(),
+				ext,
+			)
+
+			// 上传到 S3
+			if err := s3store.UploadToRustFS(
+				c.Context(),
+				reader,
+				key,
+				size,
+				contentType,
+			); err != nil {
+				return errors.WithStack(err)
+			} else {
+				avatar = key
+			}
+		}
+	}
+
+	err := dbClient.WithTx(c.Context(), func(tx *db.Client) error {
+
+		if err := tx.Insert(c.Context(), "b_user", "id", map[string]any{
+			"id":              userId,
+			"nickname":        nickname,
+			"avatar":          avatar,
+			"create_time":     "NOW()",
+			"update_time":     "NOW()",
+			"last_login_time": "NOW()",
+		}); err != nil {
+			return err
+		}
+
+		if err := tx.Insert(c.Context(), "b_user_oauth", "id", map[string]any{
+			"id":          uniqueid.NextId(),
+			"user_id":     userId,
+			"type":        loginType,
+			"openid":      openid,
+			"create_time": "NOW()",
+			"update_time": "NOW()",
+		}); err != nil {
+			return err
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	token, err := jwtx.CreateToken(c.Context(), jwtx.TokenData{
+		UserID: userId,
+	})
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	vo.Token = token
+	vo.UserId = userId
+	vo.Nickname = nickname
+	vo.Avatar = avatar
+	vo.FamilyId = 0
+
+	return httpx.OK(c, vo)
+}
+
+// BindQq 绑定QQ
+func BindQq(c fiber.Ctx) error {
+	var req types.LoginQqReq
+
+	if err := httpx.BindAndValidate(c, &req); err != nil {
+		return errors.WithStack(err)
+	}
+
+	dbClient := db.New()
+
+	// 检查 QQ 是否已经被其他账号绑定
+	var exist []map[string]any
+	_, err := dbClient.LoadDataBySQL(
+		c.Context(),
+		"SELECT id FROM b_user_oauth WHERE openid = ? AND type = 1",
+		[]any{req.Openid},
+	)
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	if len(exist) > 0 {
+		return httpx.Fail(c, "该 QQ 已被其他账号绑定")
+	}
+
+	userID, ok := middleware.GetUserID(c.Context())
+	if !ok {
+		return httpx.Unauthorized(c, "账号异常")
+	}
+
+	var userBind []map[string]any
+	_, err = dbClient.LoadDataBySQL(
+		c.Context(),
+		"SELECT id FROM b_user_oauth WHERE user_id = ? AND type = 1",
+		[]any{userID},
+	)
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	if len(userBind) > 0 {
+		return httpx.Fail(c, "该账号已绑定 QQ")
+	}
+
+	err = dbClient.WithTx(c.Context(), func(tx *db.Client) error {
+		err2 := tx.Insert(
+			c.Context(),
+			"b_user_oauth",
+			"id",
+			map[string]any{
+				"id":          uniqueid.NextId(),
+				"user_id":     userID,
+				"type":        1, // QQ
+				"openid":      req.Openid,
+				"create_time": time.Now(),
+				"update_time": time.Now(),
+			},
+		)
+
+		if err2 != nil {
+			return err2
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	return httpx.OK(c, "绑定成功")
+}
+
+// BindWechat 绑定微信
+func BindWechat(c fiber.Ctx) error {
+	var req types.LoginWechatReq
+
+	if err := httpx.BindAndValidate(c, &req); err != nil {
+		return errors.WithStack(err)
+	}
+
+	dbClient := db.New()
+
+	// 2️⃣ 检查 微信 是否已经被其他账号绑定
+	var exist []map[string]any
+	_, err := dbClient.LoadDataBySQL(
+		c.Context(),
+		"SELECT id FROM b_user_oauth WHERE openid = ? AND type = 0",
+		[]any{req.Code},
+	)
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	if len(exist) > 0 {
+		return httpx.Fail(c, "该 微信 已被其他账号绑定")
+	}
+
+	userID, ok := middleware.GetUserID(c.Context())
+	if !ok {
+		return httpx.Unauthorized(c, "账号异常")
+	}
+
+	var userBind []map[string]any
+	_, err = dbClient.LoadDataBySQL(
+		c.Context(),
+		"SELECT id FROM b_user_oauth WHERE user_id = ? AND type = 0",
+		[]any{userID},
+	)
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	if len(userBind) > 0 {
+		return httpx.Fail(c, "该账号已绑定 微信")
+	}
+
+	openid, _, err := wechat.GetWechatAccess(req.Code)
+	if err != nil {
+		log.Errorw("微信获取Token失败", "code", req.Code, "error", err)
+		return httpx.Fail(c, "微信登录失败，请重试")
+	}
+
+	err = dbClient.WithTx(c.Context(), func(tx *db.Client) error {
+		err2 := tx.Insert(
+			c.Context(),
+			"b_user_oauth",
+			"id",
+			map[string]any{
+				"id":          uniqueid.NextId(),
+				"user_id":     userID,
+				"type":        0, // 微信
+				"openid":      openid,
+				"create_time": time.Now(),
+				"update_time": time.Now(),
+			},
+		)
+
+		if err2 != nil {
+			return err2
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	return httpx.OK(c, "绑定成功")
+}
+
+// ======================== DB 查询封装（去重复 SQL） ========================
+func getUserByOpenID(dbClient *db.Client, c fiber.Ctx, openid string, loginType int16) (map[string]any, error) {
+	users, err := dbClient.LoadDataBySQL(
+		c.Context(),
+		`SELECT u.* 
+			 FROM b_user_oauth o 
+			 JOIN b_user u ON u.id = o.user_id 
+			 WHERE o.openid = $1 AND o.type = $2`,
+		[]any{openid, loginType},
+	)
+
+	if err != nil {
+		return nil, err
+	}
+
+	if len(users) == 0 {
+		return nil, nil
+	}
+
+	return users[0], nil
+}
+
+// ======================== 类型工具（极简版） ========================
+func toInt64(v any) int64 {
+	switch val := v.(type) {
+	case int64:
+		return val
+	case int32:
+		return int64(val)
+	case int16:
+		return int64(val)
+	case int:
+		return int64(val)
+	case float64:
+		return int64(val)
+	default:
+		fmt.Printf("unknown type: %T, value=%v\n", v, v)
+		return 0
+	}
+}
@@ -0,0 +1,70 @@
+package handle
+
+import (
+	"allapp-go/internal/errors"
+	"allapp-go/internal/httpx"
+	"allapp-go/internal/types"
+	"allapp-go/pkg/db"
+	"allapp-go/pkg/uniqueid"
+
+	"github.com/gofiber/fiber/v3"
+)
+
+func LoadData(c fiber.Ctx) error {
+	var req types.LoadDataReq
+
+	err := httpx.BindAndValidate(c, &req)
+
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	dbClient := db.New()
+	// 查询
+	data, err := dbClient.LoadData(c.Context(), req.ViewName, req.SearchCondition, req.OrderBy, req.SearchColumns, req.Args)
+
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	return httpx.OK(c, data)
+}
+
+func LoadDataBySql(c fiber.Ctx) error {
+	var req types.LoadDataBySqlReq
+
+	err := httpx.BindAndValidate(c, &req)
+
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	dbClient := db.New()
+
+	data, err := dbClient.LoadDataBySQL(c.Context(), req.Sql, req.Args)
+
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	return httpx.OK(c, data)
+}
+
+func GetUniqueId(c fiber.Ctx) error {
+	var req types.GetUniqueIdReq
+
+	if err := httpx.BindAndValidate(c, &req); err != nil {
+		return errors.WithStack(err)
+	}
+
+	count := req.Count
+
+	// 预分配，避免扩容
+	ids := make([]int64, 0, count)
+
+	for i := 0; i < count; i++ {
+		ids = append(ids, uniqueid.NextId())
+	}
+
+	return httpx.OK(c, ids)
+}
@@ -0,0 +1,58 @@
+package handle
+
+import (
+	"allapp-go/internal/errors"
+	"allapp-go/internal/httpx"
+	"allapp-go/internal/types"
+	"allapp-go/pkg/db"
+
+	"github.com/gofiber/fiber/v3"
+)
+
+func SaveData(c fiber.Ctx) error {
+	var req []types.SaveDataReq
+
+	if err := httpx.BindAndValidate(c, &req); err != nil {
+		return errors.WithStack(err)
+	}
+
+	if len(req) == 0 {
+		return httpx.OK(c, nil)
+	}
+
+	ctx := c.Context()
+
+	dbClient := db.New()
+
+	err := dbClient.WithTx(ctx, func(tx *db.Client) error {
+		for _, dataReq := range req {
+			tableName := dataReq.TableName
+			keyField := dataReq.KeyField
+
+			for _, insert := range dataReq.Inserts {
+				if err := tx.Insert(ctx, tableName, keyField, insert); err != nil {
+					return err
+				}
+			}
+
+			for _, update := range dataReq.Updates {
+				if err := tx.Update(ctx, tableName, keyField, update); err != nil {
+					return err
+				}
+			}
+
+			for _, del := range dataReq.Deletes {
+				if err := tx.Delete(ctx, tableName, keyField, del); err != nil {
+					return err
+				}
+			}
+		}
+		return nil
+	})
+
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	return httpx.OK(c, nil)
+}
@@ -0,0 +1,89 @@
+package handle
+
+import (
+	"allapp-go/internal/errors"
+	"allapp-go/internal/httpx"
+	"allapp-go/internal/types"
+	"allapp-go/pkg/logger"
+	"allapp-go/pkg/s3store"
+	"fmt"
+	"path/filepath"
+	"time"
+
+	"github.com/gofiber/fiber/v3"
+	"github.com/google/uuid"
+	"go.uber.org/zap"
+)
+
+func S3UploadFile(c fiber.Ctx) error {
+	form, err := c.MultipartForm()
+	if err != nil {
+		return errors.WithStack(err)
+	}
+
+	files := form.File["files"]
+
+	if len(files) == 0 {
+		return httpx.OK(c, nil)
+	}
+
+	now := time.Now()
+	folderPath := fmt.Sprintf("%d/%02d/%02d",
+		now.Year(),
+		now.Month(),
+		now.Day(),
+	)
+
+	var result []string
+
+	for _, fileHeader := range files {
+		file, err := fileHeader.Open()
+		if err != nil {
+			return errors.WithStack(err)
+		}
+
+		ext := filepath.Ext(fileHeader.Filename)
+		newName := fmt.Sprintf("%s%s", uuid.NewString(), ext)
+		key := fmt.Sprintf("%s/%s", folderPath, newName)
+
+		contentType := fileHeader.Header.Get("Content-Type")
+
+		err = s3store.UploadToRustFS(
+			c.Context(),
+			file,
+			key,
+			fileHeader.Size,
+			contentType,
+		)
+
+		_ = file.Close()
+
+		if err != nil {
+			return errors.WithStack(err)
+		}
+
+		result = append(result, key)
+	}
+
+	return httpx.OK(c, result)
+}
+
+func S3DeleteFile(c fiber.Ctx) error {
+	var req types.S3DeleteReq
+
+	if err := httpx.BindAndValidate(c, &req); err != nil {
+		return errors.WithStack(err)
+	}
+
+	log := logger.FromCtx(c.Context())
+
+	if err := s3store.DeleteBatch(c.Context(), req.Keys); err != nil {
+		log.Warn("S3 批量删除失败",
+			zap.Int("count", len(req.Keys)),
+			zap.Error(err),
+		)
+		// ❗仍然返回成功（符合你的要求）
+	}
+
+	return httpx.OK(c, nil)
+}
@@ -0,0 +1,35 @@
+package httpx
+
+import (
+	"reflect"
+
+	"github.com/go-playground/validator/v10"
+	"github.com/gofiber/fiber/v3"
+)
+
+var validate = validator.New()
+
+func BindAndValidate(c fiber.Ctx, v any) error {
+	// 1️⃣ 绑定 JSON
+	if err := c.Bind().Body(v); err != nil {
+		return err
+	}
+
+	// 2️⃣ 只允许 struct 校验（先不支持 slice）
+	rv := reflect.ValueOf(v)
+	if rv.Kind() == reflect.Ptr {
+		rv = rv.Elem()
+	}
+
+	// 如果是 slice，直接跳过校验
+	if rv.Kind() == reflect.Slice {
+		return nil
+	}
+
+	// 3️⃣ struct 校验
+	if err := validate.Struct(v); err != nil {
+		return err
+	}
+
+	return nil
+}
@@ -0,0 +1,63 @@
+package httpx
+
+import "github.com/gofiber/fiber/v3"
+
+type Result struct {
+	Code    int         `json:"code"`
+	Message string      `json:"message"`
+	Data    interface{} `json:"data"`
+	TrackId string      `json:"track_id,omitempty"`
+}
+
+var BizCode = struct {
+	Success       int // 成功
+	Unauthorized  int // 未授权/Token失效
+	BusinessError int // 业务异常，例如参数错误、操作不允许
+	SystemError   int // 系统异常，例如数据库崩溃、未知错误
+}{
+	Success:       1000,
+	Unauthorized:  1001,
+	BusinessError: 2000,
+	SystemError:   3000,
+}
+
+// ------------------- 统一响应方法 -------------------
+
+// Respond 返回通用响应，code和msg必填，data可选
+func Respond(c fiber.Ctx, code int, msg string, data interface{}) error {
+	trackId := ""
+	if v := c.Context().Value("request_id"); v != nil {
+		if s, ok := v.(string); ok {
+			trackId = s
+		}
+	}
+
+	return c.JSON(Result{
+		Code:    code,
+		Message: msg,
+		Data:    data,
+		TrackId: trackId,
+	})
+}
+
+// ------------------- 便捷封装 -------------------
+
+// OK 成功响应
+func OK(c fiber.Ctx, data interface{}) error {
+	return Respond(c, BizCode.Success, "success", data)
+}
+
+// Fail 业务异常
+func Fail(c fiber.Ctx, msg string) error {
+	return Respond(c, BizCode.BusinessError, msg, nil)
+}
+
+// SystemError 系统异常
+func SystemError(c fiber.Ctx, msg string) error {
+	return Respond(c, BizCode.SystemError, msg, nil)
+}
+
+// Unauthorized 授权失败
+func Unauthorized(c fiber.Ctx, msg string) error {
+	return Respond(c, BizCode.Unauthorized, msg, nil)
+}
@@ -0,0 +1,44 @@
+package middleware
+
+import (
+	"allapp-go/internal/httpx"
+	"allapp-go/pkg/jwtx"
+	"context"
+	"strings"
+
+	"github.com/gofiber/fiber/v3"
+)
+
+const CtxUserIDKey = "user_id"
+
+// Auth 登录校验中间件
+func Auth() fiber.Handler {
+	return func(c fiber.Ctx) error {
+		token := strings.TrimSpace(c.Get("Token"))
+
+		if token == "" {
+			return httpx.Unauthorized(c, "未登录")
+		}
+
+		verifyToken, ok := jwtx.VerifyToken(c.Context(), token)
+		if !ok {
+			return httpx.Unauthorized(c, "登录已过期")
+		}
+
+		ctx := context.WithValue(c.Context(), CtxUserIDKey, verifyToken.Data.UserID)
+
+		//ctx := context.WithValue(c.Context(), CtxUserIDKey, int64(796541901389893))
+
+		c.SetContext(ctx)
+
+		return c.Next()
+	}
+}
+
+func GetUserID(ctx context.Context) (int64, bool) {
+	v := ctx.Value(CtxUserIDKey)
+
+	id, ok := v.(int64)
+
+	return id, ok
+}
@@ -0,0 +1,35 @@
+package middleware
+
+import (
+	"allapp-go/pkg/logger"
+	"time"
+
+	"github.com/gofiber/fiber/v3"
+	"go.uber.org/zap"
+)
+
+func Logger() fiber.Handler {
+	return func(c fiber.Ctx) error {
+		traceID := c.RequestID()
+
+		logger.SetTraceID(c, traceID)
+
+		start := time.Now()
+
+		err := c.Next()
+
+		// ✅ 计算耗时
+		cost := time.Since(start)
+
+		log := logger.FromCtx(c.Context())
+		log.Info("HTTP 请求",
+			zap.String("method", c.Method()),
+			zap.String("path", c.Path()),
+			zap.Int("status", c.Response().StatusCode()),
+			zap.String("ip", c.IP()),
+			zap.String("duration", cost.String()),
+		)
+
+		return err
+	}
+}
@@ -0,0 +1,33 @@
+package router
+
+import (
+	"allapp-go/internal/config"
+	"allapp-go/internal/handle"
+	"allapp-go/internal/middleware"
+
+	"github.com/gofiber/fiber/v3"
+)
+
+func SetupRouter(app *fiber.App, cfg *config.Config) {
+	api := app.Group(cfg.App.BaseUrl)
+
+	// ==================== data ====================
+	data := api.Group("/data", middleware.Auth())
+
+	data.Post("/loadData", handle.LoadData)
+	data.Post("/loadDataBySql", handle.LoadDataBySql)
+	data.Post("/saveData", handle.SaveData)
+	data.Post("/getUniqueId", handle.GetUniqueId)
+
+	s3 := api.Group("/s3", middleware.Auth())
+	s3.Post("/upload", handle.S3UploadFile)
+	s3.Post("/delete", handle.S3DeleteFile)
+
+	// ==================== auth ====================
+	api.Post("/auth/login/qq", handle.LoginQq)
+	api.Post("/auth/login/wechat", handle.LoginWechat)
+
+	bind := api.Group("/bind", middleware.Auth())
+	bind.Post("/qq", handle.BindQq)
+	bind.Post("/wechat", handle.BindWechat)
+}
@@ -0,0 +1,19 @@
+package types
+
+type LoginQqReq struct {
+	Openid   string `json:"openid" validate:"required"`
+	Nickname string `json:"nickname"`
+	Avatar   string `json:"avatar"`
+}
+
+type LoginWechatReq struct {
+	Code string `json:"code" validate:"required"`
+}
+
+type LoginResp struct {
+	Token    string `json:"token"`
+	UserId   int64  `json:"userId"`
+	Nickname string `json:"nickname"`
+	Avatar   string `json:"avatar"`
+	FamilyId int64  `json:"family_id"`
+}
@@ -0,0 +1,18 @@
+package types
+
+type LoadDataReq struct {
+	ViewName        string   `json:"view_name" validate:"required"`
+	SearchCondition string   `json:"search_condition"`
+	OrderBy         string   `json:"order_by"`
+	SearchColumns   []string `json:"search_columns"`
+	Args            []any    `json:"args"`
+}
+
+type LoadDataBySqlReq struct {
+	Sql  string `json:"sql" validate:"required"`
+	Args []any  `json:"args"`
+}
+
+type GetUniqueIdReq struct {
+	Count int `json:"count" binding:"required,min=1,max=100"`
+}
@@ -0,0 +1,9 @@
+package types
+
+type SaveDataReq struct {
+	TableName string           `json:"table_name"`
+	KeyField  string           `json:"key_field"`
+	Inserts   []map[string]any `json:"inserts"`
+	Updates   []map[string]any `json:"updates"`
+	Deletes   []map[string]any `json:"deletes"`
+}
@@ -0,0 +1,5 @@
+package types
+
+type S3DeleteReq struct {
+	Keys []string `json:"keys" validate:"required"`
+}
@@ -0,0 +1,45 @@
+package common
+
+import (
+	"crypto/rand"
+	"encoding/json"
+	"math/big"
+)
+
+// JSONStringToStruct 将 JSON 字符串反序列化到指定结构体类型
+func JSONStringToStruct[T any](jsonStr string) (*T, error) {
+	var result T
+	if err := json.Unmarshal([]byte(jsonStr), &result); err != nil {
+		return nil, err
+	}
+	return &result, nil
+}
+
+func JSONStringToMap(jsonStr string) (map[string]interface{}, error) {
+	var result map[string]interface{}
+	if err := json.Unmarshal([]byte(jsonStr), &result); err != nil {
+		return nil, err
+	}
+	return result, nil
+}
+
+// GenerateCode 生成指定长度的随机邀请码（大写字母+数字）
+// 不会返回错误，如果随机失败，会自动重试
+func GenerateCode(length int) string {
+	const charset = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
+	code := make([]byte, length)
+
+	for i := 0; i < length; i++ {
+		for {
+			num, err := rand.Int(rand.Reader, big.NewInt(int64(len(charset))))
+			if err != nil {
+				// 随机失败，重试
+				continue
+			}
+			code[i] = charset[num.Int64()]
+			break
+		}
+	}
+
+	return string(code)
+}
@@ -0,0 +1,50 @@
+package db
+
+import (
+	"context"
+
+	"github.com/jackc/pgx/v5"
+	"github.com/jackc/pgx/v5/pgconn"
+	"github.com/jackc/pgx/v5/pgxpool"
+)
+
+var defaultClient *Client
+
+type Client struct {
+	pool *pgxpool.Pool
+	tx   pgx.Tx
+}
+
+// Init 初始化（只调用一次）
+func Init(pool *pgxpool.Pool) {
+	defaultClient = &Client{pool: pool}
+}
+
+// New 获取全局 client
+func New() *Client {
+	if defaultClient == nil {
+		panic("db not initialized, call db.Init(pool) first")
+	}
+	return defaultClient
+}
+
+func (c *Client) Exec(ctx context.Context, sql string, args ...any) (pgconn.CommandTag, error) {
+	if c.tx != nil {
+		return c.tx.Exec(ctx, sql, args...)
+	}
+	return c.pool.Exec(ctx, sql, args...)
+}
+
+func (c *Client) Query(ctx context.Context, sql string, args ...any) (pgx.Rows, error) {
+	if c.tx != nil {
+		return c.tx.Query(ctx, sql, args...)
+	}
+	return c.pool.Query(ctx, sql, args...)
+}
+
+func (c *Client) QueryRow(ctx context.Context, sql string, args ...any) pgx.Row {
+	if c.tx != nil {
+		return c.tx.QueryRow(ctx, sql, args...)
+	}
+	return c.pool.QueryRow(ctx, sql, args...)
+}
@@ -0,0 +1,59 @@
+package db
+
+import (
+	"context"
+	"fmt"
+	"strings"
+)
+
+func (c *Client) Delete(ctx context.Context, table, keyField string, data map[string]any) error {
+
+	keyVal, err := validateData(table, keyField, data)
+	if err != nil {
+		return err
+	}
+
+	sql := fmt.Sprintf(
+		"DELETE FROM %s WHERE %s = $1",
+		quoteTable(table),
+		quoteCol(keyField),
+	)
+
+	_, err = c.pool.Exec(ctx, sql, keyVal) // ⭐修复 exec
+	return err
+}
+
+func (c *Client) BatchDelete(ctx context.Context, table, keyField string, list []map[string]any) error {
+
+	if len(list) == 0 {
+		return fmt.Errorf("empty data")
+	}
+
+	var (
+		args []any
+		in   []string
+		i    = 1
+	)
+
+	for _, row := range list {
+
+		v, err := validateData(table, keyField, row)
+		if err != nil {
+			return err
+		}
+
+		in = append(in, fmt.Sprintf("$%d", i))
+		args = append(args, v)
+		i++
+	}
+
+	sql := fmt.Sprintf(
+		"DELETE FROM %s WHERE %s IN (%s)",
+		quoteTable(table),
+		quoteCol(keyField),
+		strings.Join(in, ", "),
+	)
+
+	_, err := c.pool.Exec(ctx, sql, args...) // ⭐修复 exec
+	return err
+}
@@ -0,0 +1,109 @@
+package db
+
+import (
+	"context"
+	"fmt"
+	"sort"
+	"strings"
+)
+
+func buildInsertSQL(table string, data map[string]any) (string, []any) {
+	var (
+		cols []string
+		vals []string
+		args []any
+		i    = 1
+	)
+
+	for k, v := range data {
+		cols = append(cols, quoteCol(k))
+		vals = append(vals, fmt.Sprintf("$%d", i))
+		args = append(args, v)
+		i++
+	}
+
+	return fmt.Sprintf(
+		"INSERT INTO %s (%s) VALUES (%s)",
+		quoteTable(table),
+		strings.Join(cols, ", "),
+		strings.Join(vals, ", "),
+	), args
+}
+
+func (c *Client) Insert(ctx context.Context, table, keyField string, data map[string]any) error {
+	if _, err := validateInsertData(table, keyField, data); err != nil {
+		return err
+	}
+
+	ensureID(data, keyField)
+
+	data = applyMetaFields(ctx, table, data, true)
+
+	sql, args := buildInsertSQL(table, data)
+
+	_, err := c.pool.Exec(ctx, sql, args...)
+	return err
+}
+
+func (c *Client) BatchInsert(ctx context.Context, table, keyField string, list []map[string]any) error {
+
+	if len(list) == 0 {
+		return fmt.Errorf("empty data")
+	}
+
+	first := list[0]
+	if _, err := validateInsertData(table, keyField, first); err != nil {
+		return err
+	}
+
+	tableSQL := quoteTable(table)
+
+	// 固定字段顺序（稳定性关键）
+	var cols []string
+	for k := range first {
+		cols = append(cols, k)
+	}
+	sort.Strings(cols)
+
+	var (
+		args     []any
+		values   []string
+		argIndex = 1
+	)
+
+	for _, row := range list {
+		ensureID(row, keyField)
+
+		row = applyMetaFields(ctx, table, row, true)
+
+		var place []string
+
+		for _, col := range cols {
+			v, ok := row[col]
+			if !ok {
+				return fmt.Errorf("missing field: %s", col)
+			}
+
+			place = append(place, fmt.Sprintf("$%d", argIndex))
+			args = append(args, v)
+			argIndex++
+		}
+
+		values = append(values, fmt.Sprintf("(%s)", strings.Join(place, ",")))
+	}
+
+	var quotedCols []string
+	for _, col := range cols {
+		quotedCols = append(quotedCols, quoteCol(col))
+	}
+
+	sql := fmt.Sprintf(
+		"INSERT INTO %s (%s) VALUES %s",
+		tableSQL,
+		strings.Join(quotedCols, ", "),
+		strings.Join(values, ", "),
+	)
+
+	_, err := c.pool.Exec(ctx, sql, args...) // ⭐关键修复
+	return err
+}
@@ -0,0 +1,42 @@
+package db
+
+import (
+	"allapp-go/internal/middleware"
+	"context"
+	"time"
+)
+
+var auditExcludeTables = map[string]bool{
+	"b_user":       true,
+	"b_user_oauth": true,
+}
+
+// 返回新 map（避免修改入参）
+func applyMetaFields(ctx context.Context, table string, data map[string]any, isInsert bool) map[string]any {
+	if auditExcludeTables[table] {
+		return data
+	}
+
+	now := time.Now()
+	newData := make(map[string]any, len(data)+2)
+
+	for k, v := range data {
+		newData[k] = v
+	}
+
+	if isInsert {
+		newData["create_time"] = now
+		newData["update_time"] = now
+	} else {
+		newData["update_time"] = now
+	}
+
+	if userID, ok := middleware.GetUserID(ctx); ok {
+		if isInsert {
+			newData["create_by"] = userID
+		}
+		newData["update_by"] = userID
+	}
+
+	return newData
+}
@@ -0,0 +1,122 @@
+package db
+
+import (
+	"allapp-go/pkg/logger"
+	"context"
+	"fmt"
+	"strconv"
+	"strings"
+
+	"go.uber.org/zap"
+)
+
+func (c *Client) LoadData(
+	ctx context.Context,
+	viewName string,
+	searchCondition string,
+	orderBy string,
+	searchColumns []string,
+	args []any,
+) ([]map[string]any, error) {
+
+	selectCols := "*"
+	if len(searchColumns) > 0 {
+		selectCols = strings.Join(searchColumns, ", ")
+	}
+
+	where := ""
+	if searchCondition != "" {
+		where = " WHERE " + searchCondition
+	}
+
+	order := ""
+	if orderBy != "" {
+		order = " ORDER BY " + orderBy
+	}
+
+	sql := fmt.Sprintf(
+		"SELECT %s FROM %s%s%s",
+		selectCols,
+		viewName,
+		where,
+		order,
+	)
+
+	logger.FromCtx(ctx).Info("LoadData",
+		zap.String("sql", sql),
+		zap.Any("args", args),
+	)
+
+	return c.query(ctx, sql, args...)
+}
+
+func (c *Client) LoadDataBySQL(
+	ctx context.Context,
+	sql string,
+	args []any,
+) ([]map[string]any, error) {
+
+	logger.FromCtx(ctx).Info("LoadDataBySQL",
+		zap.String("sql", sql),
+		zap.Any("args", args),
+	)
+
+	return c.query(ctx, sql, args...)
+}
+
+func (c *Client) query(ctx context.Context, sql string, args ...any) ([]map[string]any, error) {
+
+	sql = convertPlaceholder(sql)
+
+	rows, err := c.pool.Query(ctx, sql, args...)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+
+	fields := rows.FieldDescriptions()
+
+	result := make([]map[string]any, 0, 16)
+
+	for rows.Next() {
+		values, err := rows.Values()
+		if err != nil {
+			return nil, err
+		}
+
+		row := make(map[string]any, len(values))
+
+		for i := range fields {
+			if i < len(values) {
+				row[string(fields[i].Name)] = values[i]
+			}
+		}
+
+		result = append(result, row)
+	}
+
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+
+	return result, nil
+}
+
+func convertPlaceholder(sql string) string {
+	var sb strings.Builder
+	sb.Grow(len(sql))
+
+	argIndex := 1
+
+	for i := 0; i < len(sql); i++ {
+		if sql[i] == '?' {
+			sb.WriteByte('$')
+			sb.WriteString(strconv.Itoa(argIndex))
+			argIndex++
+		} else {
+			sb.WriteByte(sql[i])
+		}
+	}
+
+	return sb.String()
+}
@@ -0,0 +1,38 @@
+package db
+
+import (
+	"context"
+)
+
+func (c *Client) WithTx(ctx context.Context, fn func(tx *Client) error) error {
+
+	tx, err := c.pool.Begin(ctx)
+	if err != nil {
+		return err
+	}
+
+	// 创建事务 client
+	txClient := &Client{
+		pool: c.pool,
+		tx:   tx,
+	}
+
+	// rollback 兜底（防 panic / 提前 return）
+	defer func() {
+		_ = tx.Rollback(ctx)
+	}()
+
+	// 执行业务
+	if err := fn(txClient); err != nil {
+		_ = tx.Rollback(ctx)
+		return err
+	}
+
+	// commit
+	if err := tx.Commit(ctx); err != nil {
+		_ = tx.Rollback(ctx)
+		return err
+	}
+
+	return nil
+}
@@ -0,0 +1,122 @@
+package db
+
+import (
+	"context"
+	"fmt"
+	"sort"
+	"strings"
+)
+
+func (c *Client) Update(ctx context.Context, table, keyField string, data map[string]any) error {
+
+	keyVal, err := validateData(table, keyField, data)
+	if err != nil {
+		return err
+	}
+
+	data = applyMetaFields(ctx, table, data, false)
+
+	var (
+		set  []string
+		args []any
+		i    = 1
+	)
+
+	for k, v := range data {
+		if k == keyField {
+			continue
+		}
+
+		set = append(set, fmt.Sprintf("%s=$%d", quoteCol(k), i))
+		args = append(args, v)
+		i++
+	}
+
+	args = append(args, keyVal)
+
+	sql := fmt.Sprintf(
+		"UPDATE %s SET %s WHERE %s=$%d",
+		quoteTable(table),
+		strings.Join(set, ", "),
+		quoteCol(keyField),
+		i,
+	)
+
+	_, err = c.pool.Exec(ctx, sql, args...)
+	return err
+}
+
+func (c *Client) BatchUpdate(ctx context.Context, table, keyField string, list []map[string]any) error {
+
+	if len(list) == 0 {
+		return fmt.Errorf("empty data")
+	}
+
+	first := list[0]
+	if _, err := validateData(table, keyField, first); err != nil {
+		return err
+	}
+
+	tableSQL := quoteTable(table)
+	keySQL := quoteCol(keyField)
+
+	var cols []string
+	for k := range first {
+		if k != keyField {
+			cols = append(cols, k)
+		}
+	}
+	sort.Strings(cols)
+
+	var (
+		args     []any
+		argIndex = 1
+		sets     []string
+	)
+
+	// CASE 构建
+	for _, col := range cols {
+		colSQL := quoteCol(col)
+
+		var caseSQL strings.Builder
+		caseSQL.WriteString(fmt.Sprintf("%s = CASE %s ", colSQL, keySQL))
+
+		for _, row := range list {
+			row = applyMetaFields(ctx, table, row, false)
+
+			keyVal := row[keyField]
+			val := row[col]
+
+			caseSQL.WriteString(fmt.Sprintf(
+				"WHEN $%d THEN $%d ",
+				argIndex,
+				argIndex+1,
+			))
+
+			args = append(args, keyVal, val)
+			argIndex += 2
+		}
+
+		caseSQL.WriteString("END")
+		sets = append(sets, caseSQL.String())
+	}
+
+	// ⭐修复 IN 写法（关键）
+	var inPlaceholders []string
+	for _, row := range list {
+		inPlaceholders = append(inPlaceholders, fmt.Sprintf("$%d", argIndex))
+		args = append(args, row[keyField])
+		argIndex++
+	}
+
+	sql := fmt.Sprintf(
+		"UPDATE %s SET %s WHERE %s IN (%s)",
+		tableSQL,
+		strings.Join(sets, ", "),
+		keySQL,
+		strings.Join(inPlaceholders, ", "),
+	)
+
+	_, err := c.pool.Exec(ctx, sql, args...) // ⭐修复点
+	return err
+}
@@ -0,0 +1,88 @@
+package db
+
+import (
+	"allapp-go/pkg/uniqueid"
+	"fmt"
+	"regexp"
+	"strings"
+)
+
+var identRe = regexp.MustCompile(`^[a-zA-Z0-9_]+$`)
+
+// 安全标识符校验
+func safeIdent(name string) bool {
+	return identRe.MatchString(name)
+}
+
+// 表名引用（支持 schema）
+func quoteTable(table string) string {
+	parts := strings.Split(table, ".")
+	for i, p := range parts {
+		if !safeIdent(p) {
+			panic(fmt.Sprintf("invalid table: %s", p))
+		}
+		parts[i] = `"` + p + `"`
+	}
+	return strings.Join(parts, ".")
+}
+
+// 字段引用
+func quoteCol(col string) string {
+	if !safeIdent(col) {
+		panic(fmt.Sprintf("invalid column: %s", col))
+	}
+	return `"` + col + `"`
+}
+
+// 校验数据
+func validateData(table string, keyField string, data map[string]any) (any, error) {
+	if table == "" {
+		return nil, fmt.Errorf("表名不能为空")
+	}
+
+	if len(data) == 0 {
+		return nil, fmt.Errorf("数据不能为空")
+	}
+
+	if keyField == "" {
+		return nil, fmt.Errorf("主键字段不能为空")
+	}
+
+	val, ok := data[keyField]
+	if !ok {
+		return nil, fmt.Errorf("缺少主键字段: %s", keyField)
+	}
+
+	if val == nil {
+		return nil, fmt.Errorf("主键字段值不能为空")
+	}
+
+	return val, nil
+}
+
+// 校验数据
+func validateInsertData(table string, keyField string, data map[string]any) (any, error) {
+	if table == "" {
+		return nil, fmt.Errorf("表名不能为空")
+	}
+
+	if len(data) == 0 {
+		return nil, fmt.Errorf("数据不能为空")
+	}
+
+	if keyField == "" {
+		return nil, fmt.Errorf("主键字段不能为空")
+	}
+
+	val, _ := data[keyField]
+
+	return val, nil
+}
+
+func ensureID(data map[string]any, keyField string) {
+	v, ok := data[keyField]
+
+	if !ok || v == nil || v == "" {
+		data[keyField] = uniqueid.NextId()
+	}
+}
@@ -0,0 +1,115 @@
+package jwtx
+
+import (
+	"context"
+	"sync"
+	"time"
+
+	"github.com/golang-jwt/jwt/v5"
+)
+
+// ==================
+// 内部管理器
+// ==================
+
+type jwtManager struct {
+	secret      string
+	tokenExpiry time.Duration
+}
+
+var (
+	manager *jwtManager
+	once    sync.Once
+)
+
+// ==================
+// 初始化
+// ==================
+
+// Init 初始化（只执行一次）
+// expiry = -1 表示不过期
+func Init(secret string, expiry time.Duration) {
+	once.Do(func() {
+		manager = &jwtManager{
+			secret:      secret,
+			tokenExpiry: expiry,
+		}
+	})
+}
+
+func getManager() *jwtManager {
+	if manager == nil {
+		panic("jwt未初始化，请先调用Init")
+	}
+	return manager
+}
+
+// ==================
+// Claims（通用结构）
+// ==================
+
+type TokenData struct {
+	UserID int64 `json:"user_id"`
+}
+
+type CustomClaims struct {
+	Data TokenData `json:"data"`
+	jwt.RegisteredClaims
+}
+
+// ==================
+// 对外方法
+// ==================
+
+// CreateToken 生成 JWT
+func CreateToken(ctx context.Context, data TokenData) (string, error) {
+	m := getManager()
+	return m.createToken(data)
+}
+
+// VerifyToken 校验 token 并返回 claims
+func VerifyToken(ctx context.Context, tokenString string) (*CustomClaims, bool) {
+	if tokenString == "" {
+		return nil, false
+	}
+
+	m := getManager()
+
+	token, err := jwt.ParseWithClaims(tokenString, &CustomClaims{}, func(token *jwt.Token) (interface{}, error) {
+		return []byte(m.secret), nil
+	})
+
+	if err != nil || !token.Valid {
+		return nil, false
+	}
+
+	claims, ok := token.Claims.(*CustomClaims)
+
+	if !ok {
+		return nil, false
+	}
+
+	return claims, true
+}
+
+// ==================
+// 内部实现
+// ==================
+
+func (j *jwtManager) createToken(data TokenData) (string, error) {
+	now := time.Now()
+
+	claims := &CustomClaims{
+		Data: data,
+		RegisteredClaims: jwt.RegisteredClaims{
+			IssuedAt: jwt.NewNumericDate(now),
+		},
+	}
+
+	if j.tokenExpiry > 0 {
+		claims.ExpiresAt = jwt.NewNumericDate(now.Add(j.tokenExpiry))
+	}
+
+	token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
+	return token.SignedString([]byte(j.secret))
+}
@@ -0,0 +1,233 @@
+package logger
+
+import (
+	"context"
+	"os"
+	"path/filepath"
+	"strings"
+	"time"
+
+	"github.com/gofiber/fiber/v3"
+	"go.uber.org/zap"
+	"go.uber.org/zap/zapcore"
+	"gopkg.in/natefinch/lumberjack.v2"
+)
+
+var Log *zap.Logger
+
+const TraceIDKey = "request_id"
+
+// ======================
+// 配置结构
+// ======================
+
+type Config struct {
+	Dir        string // 日志目录
+	Level      string // debug info warn error
+	MaxSize    int    // MB
+	MaxBackups int
+	MaxAge     int  // 天
+	Compress   bool // 是否压缩
+}
+
+// ======================
+// 初始化
+// ======================
+
+func Init(cfg Config) {
+	if cfg.Dir == "" {
+		cfg.Dir = "logs"
+	}
+
+	if cfg.Level == "" {
+		cfg.Level = "info"
+	}
+
+	level := parseLevel(cfg.Level)
+
+	// ======================
+	// encoder 配置
+	// ======================
+
+	encoderConfig := zapcore.EncoderConfig{
+		TimeKey:      "time",
+		LevelKey:     "level",
+		MessageKey:   "msg",
+		CallerKey:    "caller",
+		EncodeCaller: zapcore.ShortCallerEncoder,
+	}
+
+	// 👉 文件 JSON encoder
+	jsonEncoder := zapcore.NewJSONEncoder(func() zapcore.EncoderConfig {
+		cfg := encoderConfig
+		cfg.EncodeLevel = zapcore.CapitalLevelEncoder
+		cfg.EncodeTime = zapcore.TimeEncoderOfLayout("2006-01-02 15:04:05")
+		return cfg
+	}())
+
+	// 👉 控制台 encoder（可读）
+	consoleEncoder := zapcore.NewConsoleEncoder(func() zapcore.EncoderConfig {
+		cfg := encoderConfig
+		cfg.EncodeLevel = zapcore.CapitalColorLevelEncoder
+		cfg.EncodeTime = zapcore.TimeEncoderOfLayout("2006-01-02 15:04:05")
+		return cfg
+	}())
+
+	// ======================
+	// writer
+	// ======================
+
+	consoleWriter := zapcore.AddSync(os.Stdout)
+	infoWriter := getWriter(cfg, "info")
+	errorWriter := getWriter(cfg, "error")
+
+	// ======================
+	// core
+	// ======================
+
+	// 控制台（所有级别）
+	consoleCore := zapcore.NewCore(
+		consoleEncoder,
+		consoleWriter,
+		level,
+	)
+
+	// info 文件
+	infoCore := zapcore.NewCore(
+		jsonEncoder,
+		infoWriter,
+		zap.LevelEnablerFunc(func(lvl zapcore.Level) bool {
+			return lvl < zapcore.ErrorLevel && lvl >= level
+		}),
+	)
+
+	// error 文件
+	errorCore := zapcore.NewCore(
+		jsonEncoder,
+		errorWriter,
+		zap.LevelEnablerFunc(func(lvl zapcore.Level) bool {
+			return lvl >= zapcore.ErrorLevel
+		}),
+	)
+
+	core := zapcore.NewTee(
+		consoleCore,
+		infoCore,
+		errorCore,
+	)
+
+	Log = zap.New(
+		core,
+		zap.AddCaller(),      // 打印调用位置
+		zap.AddCallerSkip(1), // 跳过封装层
+	)
+}
+
+// ======================
+// Daily Writer（按天切割）
+// ======================
+
+type DailyWriter struct {
+	cfg   Config
+	level string
+	log   *lumberjack.Logger
+	date  string
+}
+
+func newDailyWriter(cfg Config, level string) *DailyWriter {
+	return &DailyWriter{
+		cfg:   cfg,
+		level: level,
+	}
+}
+
+func (w *DailyWriter) Write(p []byte) (n int, err error) {
+	today := time.Now().Format("2006-01-02")
+
+	if w.log == nil || w.date != today {
+		dir := filepath.Join(w.cfg.Dir, w.level)
+		_ = os.MkdirAll(dir, os.ModePerm)
+
+		filename := filepath.Join(dir, today+".log")
+
+		w.log = &lumberjack.Logger{
+			Filename:   filename,
+			MaxSize:    w.cfg.MaxSize,
+			MaxBackups: w.cfg.MaxBackups,
+			MaxAge:     w.cfg.MaxAge,
+			Compress:   w.cfg.Compress,
+		}
+
+		w.date = today
+	}
+
+	return w.log.Write(p)
+}
+
+func (w *DailyWriter) Sync() error {
+	if w.log != nil {
+		return w.log.Close()
+	}
+	return nil
+}
+
+// ======================
+// writer 封装
+// ======================
+
+func getWriter(cfg Config, level string) zapcore.WriteSyncer {
+	return zapcore.AddSync(newDailyWriter(cfg, level))
+}
+
+// ======================
+// level 解析
+// ======================
+
+func parseLevel(lvl string) zapcore.Level {
+	switch strings.ToLower(lvl) {
+	case "debug":
+		return zap.DebugLevel
+	case "warn":
+		return zap.WarnLevel
+	case "error":
+		return zap.ErrorLevel
+	default:
+		return zap.InfoLevel
+	}
+}
+
+// ======================
+// trace 支持
+// ======================
+
+func SetTraceID(c fiber.Ctx, traceID string) {
+	if c == nil {
+		return
+	}
+
+	ctx := context.WithValue(c.Context(), TraceIDKey, traceID)
+	c.SetContext(ctx)
+}
+
+func FromCtx(ctx context.Context) *zap.Logger {
+	if ctx == nil {
+		return Log
+	}
+
+	traceID, _ := ctx.Value(TraceIDKey).(string)
+	if traceID == "" {
+		return Log
+	}
+
+	return Log.With(zap.String("trace_id", traceID))
+}
+
+// ======================
+// 优雅退出
+// ======================
+
+func Sync() {
+	if Log != nil {
+		_ = Log.Sync()
+	}
+}
@@ -0,0 +1,130 @@
+package requestx
+
+import (
+	"context"
+	"fmt"
+	"io"
+	"net/http"
+	"time"
+
+	"github.com/gofiber/fiber/v3/client"
+)
+
+// 全局 Fiber Client
+var cc = client.New()
+
+func init() {
+	cc.SetTimeout(10 * time.Second)
+}
+
+// mergeConfig 合并默认配置和用户配置
+func mergeConfig(defaultCfg, userCfg client.Config) client.Config {
+	if userCfg.Ctx != nil {
+		defaultCfg.Ctx = userCfg.Ctx
+	}
+	if userCfg.Body != nil {
+		defaultCfg.Body = userCfg.Body
+	}
+	if userCfg.Header != nil {
+		if defaultCfg.Header == nil {
+			defaultCfg.Header = map[string]string{}
+		}
+		for k, v := range userCfg.Header {
+			defaultCfg.Header[k] = v
+		}
+	}
+	if userCfg.Param != nil {
+		defaultCfg.Param = userCfg.Param
+	}
+	if userCfg.PathParam != nil {
+		defaultCfg.PathParam = userCfg.PathParam
+	}
+	if userCfg.FormData != nil {
+		defaultCfg.FormData = userCfg.FormData
+	}
+	if userCfg.Timeout != 0 {
+		defaultCfg.Timeout = userCfg.Timeout
+	}
+	if userCfg.UserAgent != "" {
+		defaultCfg.UserAgent = userCfg.UserAgent
+	}
+	if userCfg.Referer != "" {
+		defaultCfg.Referer = userCfg.Referer
+	}
+	defaultCfg.DisablePathNormalizing = userCfg.DisablePathNormalizing
+	defaultCfg.MaxRedirects = userCfg.MaxRedirects
+
+	return defaultCfg
+}
+
+func Get(url string, cfg client.Config) (string, int, error) {
+	defaultCfg := client.Config{
+		Ctx: context.Background(),
+	}
+	finalCfg := mergeConfig(defaultCfg, cfg)
+
+	resp, err := cc.Get(url, finalCfg)
+	if err != nil {
+		return "", 0, err
+	}
+
+	return string(resp.Body()), resp.StatusCode(), nil
+}
+
+func PostJSON(url string, data any, cfg client.Config) (string, int, error) {
+	defaultCfg := client.Config{
+		Ctx:    context.Background(),
+		Body:   data,
+		Header: map[string]string{"Content-Type": "application/json"},
+	}
+	finalCfg := mergeConfig(defaultCfg, cfg)
+
+	resp, err := cc.Post(url, finalCfg)
+	if err != nil {
+		return "", 0, err
+	}
+	return string(resp.Body()), resp.StatusCode(), nil
+}
+
+func PostForm(url string, formData map[string]string, cfg client.Config) (string, int, error) {
+	defaultCfg := client.Config{
+		Ctx:      context.Background(),
+		FormData: formData,
+		Header:   map[string]string{"Content-Type": "application/x-www-form-urlencoded"},
+	}
+	finalCfg := mergeConfig(defaultCfg, cfg)
+
+	resp, err := cc.Post(url, finalCfg)
+	if err != nil {
+		return "", 0, err
+	}
+	return string(resp.Body()), resp.StatusCode(), nil
+}
+
+func GetFileStream(ctx context.Context, url string) (io.ReadCloser, int64, string, error) {
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
+	if err != nil {
+		return nil, 0, "", err
+	}
+
+	req.Header.Set("User-Agent", "Mozilla/5.0")
+
+	httpClient := &http.Client{
+		Timeout: 10 * time.Second,
+	}
+
+	resp, err := httpClient.Do(req)
+	if err != nil {
+		return nil, 0, "", err
+	}
+
+	if resp.StatusCode < 200 || resp.StatusCode >= 300 {
+		err := resp.Body.Close()
+		if err != nil {
+			return nil, 0, "", err
+		}
+		return nil, 0, "", fmt.Errorf("request failed: %d", resp.StatusCode)
+	}
+
+	return resp.Body, resp.ContentLength, resp.Header.Get("Content-Type"), nil
+}
@@ -0,0 +1,95 @@
+package s3store
+
+import (
+	"allapp-go/internal/config"
+	"context"
+	"fmt"
+	"io"
+
+	"github.com/aws/aws-sdk-go-v2/aws"
+	"github.com/aws/aws-sdk-go-v2/credentials"
+	"github.com/aws/aws-sdk-go-v2/service/s3"
+	"github.com/aws/aws-sdk-go-v2/service/s3/types"
+)
+
+var S3Client *s3.Client
+var presignClient *s3.PresignClient
+var bucket string
+
+func NewS3Client(cfg *config.Config) {
+	credProvider := credentials.NewStaticCredentialsProvider(
+		cfg.AwsS3.AccessKey,
+		cfg.AwsS3.SecretKey,
+		"",
+	)
+
+	awsCfg := aws.Config{
+		Region:      cfg.AwsS3.Region,
+		Credentials: credProvider,
+	}
+
+	S3Client = s3.NewFromConfig(awsCfg, func(o *s3.Options) {
+		o.BaseEndpoint = aws.String(cfg.AwsS3.Endpoint)
+		o.UsePathStyle = true
+	})
+
+	presignClient = s3.NewPresignClient(S3Client)
+
+	bucket = cfg.AwsS3.Bucket
+
+	fmt.Println("S3 client and Presign client initialized successfully!")
+}
+
+// UploadToRustFS 上传
+func UploadToRustFS(ctx context.Context, file io.Reader, key string, size int64, contentType string) error {
+	_, err := S3Client.PutObject(ctx, &s3.PutObjectInput{
+		Bucket:        aws.String(bucket),
+		Key:           aws.String(key),
+		Body:          file,
+		ContentLength: aws.Int64(size),
+		ContentType:   aws.String(contentType),
+	})
+	return err
+}
+
+// DeleteFromRustFS 删除
+func DeleteFromRustFS(ctx context.Context, key string) error {
+	_, err := S3Client.DeleteObject(ctx, &s3.DeleteObjectInput{
+		Bucket: aws.String(bucket),
+		Key:    aws.String(key),
+	})
+
+	return err
+}
+
+func DeleteBatch(ctx context.Context, keys []string) error {
+	const maxBatch = 1000
+
+	for i := 0; i < len(keys); i += maxBatch {
+		end := i + maxBatch
+		if end > len(keys) {
+			end = len(keys)
+		}
+
+		var objects []types.ObjectIdentifier
+		for _, k := range keys[i:end] {
+			objects = append(objects, types.ObjectIdentifier{
+				Key: aws.String(k),
+			})
+		}
+
+		_, err := S3Client.DeleteObjects(ctx, &s3.DeleteObjectsInput{
+			Bucket: aws.String(bucket),
+			Delete: &types.Delete{
+				Objects: objects,
+				Quiet:   aws.Bool(false), // 返回删除结果（建议保留）
+			},
+		})
+
+		if err != nil {
+			return err // 整批失败才返回
+		}
+	}
+
+	return nil
+}
@@ -0,0 +1,83 @@
+package uniqueid
+
+import (
+	"strconv"
+	"time"
+)
+
+type DefaultIdGenerator struct {
+	Options              *IdGeneratorOptions
+	SnowWorker           ISnowWorker
+	IdGeneratorException IdGeneratorException
+}
+
+func NewDefaultIdGenerator(options *IdGeneratorOptions) *DefaultIdGenerator {
+	if options == nil {
+		panic("dig.Options error.")
+	}
+
+	// 1.BaseTime
+	minTime := int64(631123200000) // time.Now().AddDate(-30, 0, 0).UnixNano() / 1e6
+	if options.BaseTime < minTime || options.BaseTime > time.Now().UnixNano()/1e6 {
+		panic("BaseTime error.")
+	}
+
+	// 2.WorkerIdBitLength
+	if options.WorkerIdBitLength <= 0 {
+		panic("WorkerIdBitLength error.(range:[1, 21])")
+	}
+	if options.WorkerIdBitLength+options.SeqBitLength > 22 {
+		panic("error：WorkerIdBitLength + SeqBitLength <= 22")
+	}
+
+	// 3.WorkerId
+	maxWorkerIdNumber := uint16(1<<options.WorkerIdBitLength) - 1
+	if maxWorkerIdNumber == 0 {
+		maxWorkerIdNumber = 63
+	}
+	if options.WorkerId < 0 || options.WorkerId > maxWorkerIdNumber {
+		panic("WorkerId error. (range:[0, " + strconv.FormatUint(uint64(maxWorkerIdNumber), 10) + "]")
+	}
+
+	// 4.SeqBitLength
+	if options.SeqBitLength < 2 || options.SeqBitLength > 21 {
+		panic("SeqBitLength error. (range:[2, 21])")
+	}
+
+	// 5.MaxSeqNumber
+	maxSeqNumber := uint32(1<<options.SeqBitLength) - 1
+	if maxSeqNumber == 0 {
+		maxSeqNumber = 63
+	}
+	if options.MaxSeqNumber < 0 || options.MaxSeqNumber > maxSeqNumber {
+		panic("MaxSeqNumber error. (range:[1, " + strconv.FormatUint(uint64(maxSeqNumber), 10) + "]")
+	}
+
+	// 6.MinSeqNumber
+	if options.MinSeqNumber < 5 || options.MinSeqNumber > maxSeqNumber {
+		panic("MinSeqNumber error. (range:[5, " + strconv.FormatUint(uint64(maxSeqNumber), 10) + "]")
+	}
+
+	var snowWorker ISnowWorker
+	switch options.Method {
+	case 1:
+		snowWorker = NewSnowWorkerM1(options)
+	case 2:
+		snowWorker = NewSnowWorkerM2(options)
+	default:
+		snowWorker = NewSnowWorkerM1(options)
+	}
+
+	if options.Method == 1 {
+		time.Sleep(time.Duration(500) * time.Microsecond)
+	}
+
+	return &DefaultIdGenerator{
+		Options:    options,
+		SnowWorker: snowWorker,
+	}
+}
+
+func (dig DefaultIdGenerator) NewLong() int64 {
+	return dig.SnowWorker.NextId()
+}
@@ -0,0 +1,5 @@
+package uniqueid
+
+type IIdGenerator interface {
+	NewLong() uint64
+}
@@ -0,0 +1,5 @@
+package uniqueid
+
+type ISnowWorker interface {
+	NextId() int64
+}
@@ -0,0 +1,12 @@
+package uniqueid
+
+import "fmt"
+
+type IdGeneratorException struct {
+	message string
+	error   error
+}
+
+func (e IdGeneratorException) IdGeneratorException(message ...interface{}) {
+	fmt.Println(message)
+}
@@ -0,0 +1,25 @@
+package uniqueid
+
+type IdGeneratorOptions struct {
+	Method            uint16 // 雪花计算方法,（1-漂移算法|2-传统算法），默认1
+	BaseTime          int64  // 基础时间（ms单位），不能超过当前系统时间
+	WorkerId          uint16 // 机器码，必须由外部设定，最大值 2^WorkerIdBitLength-1
+	WorkerIdBitLength byte   // 机器码位长，默认值6，取值范围 [1, 15]（要求：序列数位长+机器码位长不超过22）
+	SeqBitLength      byte   // 序列数位长，默认值6，取值范围 [3, 21]（要求：序列数位长+机器码位长不超过22）
+	MaxSeqNumber      uint32 // 最大序列数（含），设置范围 [MinSeqNumber, 2^SeqBitLength-1]，默认值0，表示最大序列数取最大值（2^SeqBitLength-1]）
+	MinSeqNumber      uint32 // 最小序列数（含），默认值5，取值范围 [5, MaxSeqNumber]，每毫秒的前5个序列数对应编号0-4是保留位，其中1-4是时间回拨相应预留位，0是手工新值预留位
+	TopOverCostCount  uint32 // 最大漂移次数（含），默认2000，推荐范围500-10000（与计算能力有关）
+}
+
+func NewIdGeneratorOptions(workerId uint16) *IdGeneratorOptions {
+	return &IdGeneratorOptions{
+		Method:            1,
+		WorkerId:          workerId,
+		BaseTime:          1582136402000,
+		WorkerIdBitLength: 6,
+		SeqBitLength:      6,
+		MaxSeqNumber:      0,
+		MinSeqNumber:      5,
+		TopOverCostCount:  2000,
+	}
+}
@@ -0,0 +1,29 @@
+package uniqueid
+
+import (
+	"sync"
+)
+
+var singletonMutex sync.Mutex
+var idGenerator *DefaultIdGenerator
+
+// SetIdGenerator .
+func SetIdGenerator(options *IdGeneratorOptions) {
+	singletonMutex.Lock()
+	idGenerator = NewDefaultIdGenerator(options)
+	singletonMutex.Unlock()
+}
+
+// NextId .
+func NextId() int64 {
+	if idGenerator == nil {
+		singletonMutex.Lock()
+		defer singletonMutex.Unlock()
+		if idGenerator == nil {
+			options := NewIdGeneratorOptions(1)
+			idGenerator = NewDefaultIdGenerator(options)
+		}
+	}
+
+	return idGenerator.NewLong()
+}
@@ -0,0 +1,19 @@
+package uniqueid
+
+type OverCostActionArg struct {
+	ActionType             int32
+	TimeTick               int64
+	WorkerId               uint16
+	OverCostCountInOneTerm int32
+	GenCountInOneTerm      int32
+	TermIndex              int32
+}
+
+func (ocaa OverCostActionArg) OverCostActionArg(workerId uint16, timeTick int64, actionType int32, overCostCountInOneTerm int32, genCountWhenOverCost int32, index int32) {
+	ocaa.ActionType = actionType
+	ocaa.TimeTick = timeTick
+	ocaa.WorkerId = workerId
+	ocaa.OverCostCountInOneTerm = overCostCountInOneTerm
+	ocaa.GenCountInOneTerm = genCountWhenOverCost
+	ocaa.TermIndex = index
+}
@@ -0,0 +1,243 @@
+package uniqueid
+
+import (
+	"sync"
+	"time"
+)
+
+// SnowWorkerM1 .
+type SnowWorkerM1 struct {
+	BaseTime          int64  //基础时间
+	WorkerId          uint16 //机器码
+	WorkerIdBitLength byte   //机器码位长
+	SeqBitLength      byte   //自增序列数位长
+	MaxSeqNumber      uint32 //最大序列数（含）
+	MinSeqNumber      uint32 //最小序列数（含）
+	TopOverCostCount  uint32 //最大漂移次数
+	_TimestampShift   byte
+	_CurrentSeqNumber uint32
+
+	_LastTimeTick           int64
+	_TurnBackTimeTick       int64
+	_TurnBackIndex          byte
+	_IsOverCost             bool
+	_OverCostCountInOneTerm uint32
+	_GenCountInOneTerm      uint32
+	_TermIndex              uint32
+
+	sync.Mutex
+}
+
+// NewSnowWorkerM1 .
+func NewSnowWorkerM1(options *IdGeneratorOptions) ISnowWorker {
+	var workerIdBitLength byte
+	var seqBitLength byte
+	var maxSeqNumber uint32
+
+	// 1.BaseTime
+	var baseTime int64
+	if options.BaseTime != 0 {
+		baseTime = options.BaseTime
+	} else {
+		baseTime = 1582136402000
+	}
+
+	// 2.WorkerIdBitLength
+	if options.WorkerIdBitLength == 0 {
+		workerIdBitLength = 6
+	} else {
+		workerIdBitLength = options.WorkerIdBitLength
+	}
+
+	// 3.WorkerId
+	var workerId = options.WorkerId
+
+	// 4.SeqBitLength
+	if options.SeqBitLength == 0 {
+		seqBitLength = 6
+	} else {
+		seqBitLength = options.SeqBitLength
+	}
+
+	// 5.MaxSeqNumber
+	if options.MaxSeqNumber <= 0 {
+		maxSeqNumber = (1 << seqBitLength) - 1
+	} else {
+		maxSeqNumber = options.MaxSeqNumber
+	}
+
+	// 6.MinSeqNumber
+	var minSeqNumber = options.MinSeqNumber
+
+	// 7.Others
+	var topOverCostCount = options.TopOverCostCount
+	if topOverCostCount == 0 {
+		topOverCostCount = 2000
+	}
+
+	timestampShift := (byte)(workerIdBitLength + seqBitLength)
+	currentSeqNumber := minSeqNumber
+
+	return &SnowWorkerM1{
+		BaseTime:          baseTime,
+		WorkerIdBitLength: workerIdBitLength,
+		WorkerId:          workerId,
+		SeqBitLength:      seqBitLength,
+		MaxSeqNumber:      maxSeqNumber,
+		MinSeqNumber:      minSeqNumber,
+		TopOverCostCount:  topOverCostCount,
+		_TimestampShift:   timestampShift,
+		_CurrentSeqNumber: currentSeqNumber,
+
+		_LastTimeTick:           0,
+		_TurnBackTimeTick:       0,
+		_TurnBackIndex:          0,
+		_IsOverCost:             false,
+		_OverCostCountInOneTerm: 0,
+		_GenCountInOneTerm:      0,
+		_TermIndex:              0,
+	}
+}
+
+// DoGenIDAction .
+func (m1 *SnowWorkerM1) DoGenIdAction(arg *OverCostActionArg) {
+
+}
+
+func (m1 *SnowWorkerM1) BeginOverCostAction(useTimeTick int64) {
+
+}
+
+func (m1 *SnowWorkerM1) EndOverCostAction(useTimeTick int64) {
+	if m1._TermIndex > 10000 {
+		m1._TermIndex = 0
+	}
+}
+
+func (m1 *SnowWorkerM1) BeginTurnBackAction(useTimeTick int64) {
+
+}
+
+func (m1 *SnowWorkerM1) EndTurnBackAction(useTimeTick int64) {
+
+}
+
+func (m1 *SnowWorkerM1) NextOverCostId() int64 {
+	currentTimeTick := m1.GetCurrentTimeTick()
+	if currentTimeTick > m1._LastTimeTick {
+		m1.EndOverCostAction(currentTimeTick)
+		m1._LastTimeTick = currentTimeTick
+		m1._CurrentSeqNumber = m1.MinSeqNumber
+		m1._IsOverCost = false
+		m1._OverCostCountInOneTerm = 0
+		m1._GenCountInOneTerm = 0
+		return m1.CalcId(m1._LastTimeTick)
+	}
+	if m1._OverCostCountInOneTerm >= m1.TopOverCostCount {
+		m1.EndOverCostAction(currentTimeTick)
+		m1._LastTimeTick = m1.GetNextTimeTick()
+		m1._CurrentSeqNumber = m1.MinSeqNumber
+		m1._IsOverCost = false
+		m1._OverCostCountInOneTerm = 0
+		m1._GenCountInOneTerm = 0
+		return m1.CalcId(m1._LastTimeTick)
+	}
+	if m1._CurrentSeqNumber > m1.MaxSeqNumber {
+		m1._LastTimeTick++
+		m1._CurrentSeqNumber = m1.MinSeqNumber
+		m1._IsOverCost = true
+		m1._OverCostCountInOneTerm++
+		m1._GenCountInOneTerm++
+
+		return m1.CalcId(m1._LastTimeTick)
+	}
+
+	m1._GenCountInOneTerm++
+	return m1.CalcId(m1._LastTimeTick)
+}
+
+// NextNormalID .
+func (m1 *SnowWorkerM1) NextNormalId() int64 {
+	currentTimeTick := m1.GetCurrentTimeTick()
+	if currentTimeTick < m1._LastTimeTick {
+		if m1._TurnBackTimeTick < 1 {
+			m1._TurnBackTimeTick = m1._LastTimeTick - 1
+			m1._TurnBackIndex++
+			// 每毫秒序列数的前5位是预留位，0用于手工新值，1-4是时间回拨次序
+			// 最多4次回拨（防止回拨重叠）
+			if m1._TurnBackIndex > 4 {
+				m1._TurnBackIndex = 1
+			}
+			m1.BeginTurnBackAction(m1._TurnBackTimeTick)
+		}
+
+		// time.Sleep(time.Duration(1) * time.Millisecond)
+		return m1.CalcTurnBackId(m1._TurnBackTimeTick)
+	}
+
+	// 时间追平时，_TurnBackTimeTick清零
+	if m1._TurnBackTimeTick > 0 {
+		m1.EndTurnBackAction(m1._TurnBackTimeTick)
+		m1._TurnBackTimeTick = 0
+	}
+
+	if currentTimeTick > m1._LastTimeTick {
+		m1._LastTimeTick = currentTimeTick
+		m1._CurrentSeqNumber = m1.MinSeqNumber
+		return m1.CalcId(m1._LastTimeTick)
+	}
+
+	if m1._CurrentSeqNumber > m1.MaxSeqNumber {
+		m1.BeginOverCostAction(currentTimeTick)
+		m1._TermIndex++
+		m1._LastTimeTick++
+		m1._CurrentSeqNumber = m1.MinSeqNumber
+		m1._IsOverCost = true
+		m1._OverCostCountInOneTerm = 1
+		m1._GenCountInOneTerm = 1
+
+		return m1.CalcId(m1._LastTimeTick)
+	}
+
+	return m1.CalcId(m1._LastTimeTick)
+}
+
+// CalcID .
+func (m1 *SnowWorkerM1) CalcId(useTimeTick int64) int64 {
+	result := int64(useTimeTick<<m1._TimestampShift) + int64(m1.WorkerId<<m1.SeqBitLength) + int64(m1._CurrentSeqNumber)
+	m1._CurrentSeqNumber++
+	return result
+}
+
+// CalcTurnBackID .
+func (m1 *SnowWorkerM1) CalcTurnBackId(useTimeTick int64) int64 {
+	result := int64(useTimeTick<<m1._TimestampShift) + int64(m1.WorkerId<<m1.SeqBitLength) + int64(m1._TurnBackIndex)
+	m1._TurnBackTimeTick--
+	return result
+}
+
+// GetCurrentTimeTick .
+func (m1 *SnowWorkerM1) GetCurrentTimeTick() int64 {
+	var millis = time.Now().UnixNano() / 1e6
+	return millis - m1.BaseTime
+}
+
+// GetNextTimeTick .
+func (m1 *SnowWorkerM1) GetNextTimeTick() int64 {
+	tempTimeTicker := m1.GetCurrentTimeTick()
+	for tempTimeTicker <= m1._LastTimeTick {
+		tempTimeTicker = m1.GetCurrentTimeTick()
+	}
+	return tempTimeTicker
+}
+
+// NextId .
+func (m1 *SnowWorkerM1) NextId() int64 {
+	m1.Lock()
+	defer m1.Unlock()
+	if m1._IsOverCost {
+		return m1.NextOverCostId()
+	} else {
+		return m1.NextNormalId()
+	}
+}
@@ -0,0 +1,37 @@
+package uniqueid
+
+import (
+	"fmt"
+	"strconv"
+)
+
+type SnowWorkerM2 struct {
+	*SnowWorkerM1
+}
+
+func NewSnowWorkerM2(options *IdGeneratorOptions) ISnowWorker {
+	return &SnowWorkerM2{
+		NewSnowWorkerM1(options).(*SnowWorkerM1),
+	}
+}
+
+func (m2 SnowWorkerM2) NextId() int64 {
+	m2.Lock()
+	defer m2.Unlock()
+	currentTimeTick := m2.GetCurrentTimeTick()
+	if m2._LastTimeTick == currentTimeTick {
+		m2._CurrentSeqNumber++
+		if m2._CurrentSeqNumber > m2.MaxSeqNumber {
+			m2._CurrentSeqNumber = m2.MinSeqNumber
+			currentTimeTick = m2.GetNextTimeTick()
+		}
+	} else {
+		m2._CurrentSeqNumber = m2.MinSeqNumber
+	}
+	if currentTimeTick < m2._LastTimeTick {
+		fmt.Println("Time error for {0} milliseconds", strconv.FormatInt(m2._LastTimeTick-currentTimeTick, 10))
+	}
+	m2._LastTimeTick = currentTimeTick
+	result := int64(currentTimeTick<<m2._TimestampShift) + int64(m2.WorkerId<<m2.SeqBitLength) + int64(m2._CurrentSeqNumber)
+	return result
+}
@@ -0,0 +1,102 @@
+package wechat
+
+import (
+	"allapp-go/pkg/common"
+	"allapp-go/pkg/requestx"
+	"fmt"
+	"sync"
+
+	"github.com/gofiber/fiber/v3/client"
+)
+
+type jwtManager struct {
+	appid  string
+	secret string
+}
+
+var (
+	manager *jwtManager
+	once    sync.Once
+)
+
+func Init(appid string, secret string) {
+	once.Do(func() {
+		manager = &jwtManager{
+			appid:  appid,
+			secret: secret,
+		}
+	})
+}
+
+func getManager() *jwtManager {
+	if manager == nil {
+		panic("wechat未初始化，请先调用Init")
+	}
+	return manager
+}
+
+func GetWechatAccess(code string) (openid string, accessToken string, err error) {
+	bodyData, bodyCode, err := requestx.Get(
+		"https://api.weixin.qq.com/sns/oauth2/access_token",
+		client.Config{
+			Param: map[string]string{
+				"appid":      getManager().appid,
+				"secret":     getManager().secret,
+				"code":       code,
+				"grant_type": "authorization_code",
+			},
+		},
+	)
+
+	if err != nil {
+		return "", "", err
+	}
+
+	if bodyCode != 200 {
+		return "", "", fmt.Errorf("微信Http请求失败: %d", bodyCode)
+	}
+
+	accessMap, err := common.JSONStringToMap(bodyData)
+	if err != nil {
+		return "", "", err
+	}
+
+	accessToken, _ = accessMap["access_token"].(string)
+	openid, _ = accessMap["openid"].(string)
+
+	if accessToken == "" || openid == "" {
+		return "", "", fmt.Errorf("获取微信登录凭证失败: %s", bodyData)
+	}
+
+	return
+}
+
+func GetWechatUserInfo(accessToken, openid string) (nickname, avatar string, err error) {
+	bodyData, bodyCode, err := requestx.Get(
+		"https://api.weixin.qq.com/sns/userinfo",
+		client.Config{
+			Param: map[string]string{
+				"access_token": accessToken,
+				"openid":       openid,
+			},
+		},
+	)
+
+	if err != nil {
+		return "", "", err
+	}
+
+	if bodyCode != 200 {
+		return "", "", fmt.Errorf("微信Http请求失败")
+	}
+
+	userMap, err := common.JSONStringToMap(bodyData)
+	if err != nil {
+		return "", "", err
+	}
+
+	nickname, _ = userMap["nickname"].(string)
+	avatar, _ = userMap["headimgurl"].(string)
+
+	return
+}