merge: sync upstream wavelet/main (clean contracts DTOs and configs)

2026-10-13 18:36:37 +08:00 · 2026-09-03 10:25:52 +08:00
parent 25c3249ce2 99fff5d5af
commit 630803d5a3
10 changed files with 195 additions and 200 deletions
@@ -0,0 +1,120 @@
+# openflare — Platform Config
+# Copy this file to config.yaml and fill in your values.
+# Fields marked with <...> are required; others have sensible defaults.
+
+# ─── Application ────────────────────────────────────────────────────────────────
+app:
+  app_name: "openflare"
+  env: "production"          # development | testing | production
+  addr: ":3000"
+  node_id: 1                  # Snowflake node ID (0-1023). Must be unique per instance.
+  graceful_shutdown_timeout: 30
+  session_cookie_name: "openflare_session_id"  # Change to something unique before deploy
+  session_secret: "<uniq-random-string>"         # Cannot be changed after first start
+  session_domain: ""                             # e.g. ".yourdomain.com"
+  session_age: 86400                             # Session lifetime in seconds (default: 24h)
+  session_secure: false
+  session_http_only: false
+  api_prefix: "/api"
+  redirect_trailing_slash: false
+
+# ─── PostgreSQL ─────────────────────────────────────────────────────────────────
+# Supports Standalone and Primary-Replica (read/write split) modes.
+database:
+  enabled: true
+  sqlite_path: "openflare.db"      # PostgreSQL 禁用时使用此 SQLite 文件路径
+  host: "127.0.0.1"
+  port: 5432
+  username: "openflare"
+  password: "replace-with-strong-password"
+  database: "openflare"
+  max_idle_conn: 16
+  max_open_conn: 128
+  conn_max_lifetime: 1800
+  conn_max_idle_time: 600
+  log_level: "info"            # error | warn | info | debug | silent；SQL 语句仅在 log.level=debug 时输出
+  ssl_mode: "disable"
+  time_zone: "UTC"
+  application_name: "openflare-server"
+  prefer_simple_protocol: false
+  search_path: "public"
+  statement_cache_capacity: 256
+  default_query_exec_mode: "cache_statement"
+  slow_threshold: 200ms
+  # Optional read replicas:
+  # replicas:
+  #   - host: "replica1.db.internal"
+  #     port: 5432
+  #   - host: "replica2.db.internal"
+  #     port: 5432
+
+# ─── Redis ──────────────────────────────────────────────────────────────────────
+# Supports Standalone, Sentinel (HA), and Cluster modes.
+redis:
+  enabled: true
+  addrs:
+    - "127.0.0.1:6379"
+  username: ""
+  password: ""
+  db: 0                        # Ignored in Cluster mode
+  cluster_mode: false          # Set true to enable Cluster mode
+  master_name: ""              # Set non-empty to enable Sentinel mode
+  key_prefix: "openflare:"
+  pool_size: 100
+  min_idle_conn: 10
+  dial_timeout: 5
+  read_timeout: 3
+  write_timeout: 3
+  max_retries: 3
+  pool_timeout: 4
+  conn_max_idle_time: 300
+  maint_notifications: false # 启动时开关；启用 Redis maintenance notifications 自动协商，修改后需重启
+
+# ─── Logging ────────────────────────────────────────────────────────────────────
+log:
+  level: "info"                # debug | info | warn | error | fatal | panic
+  format: "console"               # console | json
+  output: "stdout"             # stdout | file
+  file_path: "./logs/app.log"
+  max_size: 100                # MB per log file
+  max_age: 30                  # Days to retain old log files
+  max_backups: 10
+  compress: true
+
+
+# ─── Async Task Worker ──────────────────────────────────────────────────────────
+worker:
+  concurrency: 20
+  strict_priority: false
+  queues:
+    - name: webhook
+      priority: 10
+    - name: whitelist_only
+      priority: 5
+    - name: default
+      priority: 3
+
+# ─── OpenTelemetry Tracing ──────────────────────────────────────────────────────
+otel:
+  sampling_rate: 0.0           # Trace sampling rate (0.0 – 1.0)
+  tracer_name: "github.com/Rain-kl/OpenFlare" # Global tracer instrumentation name
+
+
+# ─── ClickHouse (optional) ─────────────────────────────────────────────────────
+# Analytics / observability OLAP store. Telemetry writes are best-effort (async batch).
+# 默认关闭：缺失本配置块或 enabled: false 时不启用 ClickHouse，日志/指标由主库承担；
+# 设置 CLICKHOUSE_HOST 或 CLICKHOUSE_ENABLED=true 可经环境变量启用。
+clickhouse:
+  enabled: false
+  hosts:
+    - "127.0.0.1:9000"        # compose 内应用可用 clickhouse:9000（经 CLICKHOUSE_HOST）
+  username: "default"
+  password: "replace-with-clickhouse-password"  # 与 .env / compose CLICKHOUSE_PASSWORD 一致
+  database: "openflare"
+  max_idle_conn: 8            # keep warm sockets low to save client + server RAM
+  max_open_conn: 16           # cap concurrent native sessions on modest CH boxes
+  conn_max_lifetime: 3600
+  dial_timeout: 5
+  block_buffer_size: 32       # rows buffered per block; 32 is enough for our batch sizes
+  # Runtime client also enables async_insert (wait_for_async_insert=1, busy_timeout≈2s)
+  # in internal/infra/persistence/clickhouse.go — not configured via YAML.