feat: rebrand site as MaxAPI

Author: beetle0915

AGENTS.md

@@ -4,17 +4,19 @@ These rules are project-specific and apply to all agent work on Pixel.
 
 ## Development Environment
 
-- Do all feature development on the remote server `root@52.77.228.143`.
-- Main repository path: `/opt/pixel-src`.
-- Feature worktree path pattern: `/opt/pixel-worktrees/<feature-name>`.
-- Do not pull the repository to the user's Mac for development, testing, or builds unless the user explicitly asks for local work.
-- The local machine may be used only for conversation, coordination, or temporary non-source artifacts when unavoidable.
+- Do feature development, testing, and builds locally in `/Users/beetle/Desktop/code/Pixel`.
+- Use the remote server only for deployment, production builds, production service restarts, and post-deploy verification unless the user explicitly asks for server-side development.
+- Production server: `root@52.77.228.143`.
+- Server repository path for deployment: `/opt/pixel-src`.
+- Server service path: `/opt/pixel`.
+- Do not use the production runtime directory as a development workspace.
 
 ## Branch And Worktree Flow
 
-- Every new requirement starts from the latest GitHub `origin/main`.
-- Fetch first, then create a dedicated feature branch from `origin/main`.
-- Use one isolated worktree per requirement.
+- Every new requirement starts locally from the latest GitHub `origin/main`.
+- Fetch first, then create a dedicated local feature branch from `origin/main`.
+- Use one dedicated branch per requirement.
+- Use a local isolated worktree only when multiple requirements or parallel branches need to be active at the same time.
 - Branch naming:
   - `feat/<feature-name>` for features.
   - `fix/<bug-name>` for bug fixes.
@@ -26,10 +28,18 @@ These rules are project-specific and apply to all agent work on Pixel.
 Example:
 
 ```bash
-cd /opt/pixel-src
+cd /Users/beetle/Desktop/code/Pixel
 git fetch origin
-mkdir -p /opt/pixel-worktrees
-git worktree add /opt/pixel-worktrees/<feature-name> -b feat/<feature-name> origin/main
+git switch -c feat/<feature-name> origin/main
+```
+
+Optional local worktree example for parallel work:
+
+```bash
+cd /Users/beetle/Desktop/code/Pixel
+git fetch origin
+mkdir -p .worktrees
+git worktree add .worktrees/<feature-name> -b feat/<feature-name> origin/main
 ```
 
 ## Default Multi-Agent Roles
@@ -74,14 +84,14 @@ The controller agent is responsible for coordination:
 
 - Use test-driven development for code behavior changes whenever practical.
 - Write or update tests before production code for new behavior.
-- Prefer running most verification in the local development environment or an isolated test environment before handoff.
-- In this project, "local development environment" means the feature worktree on the development server or another explicitly approved non-production environment, not the production runtime directory.
-- Development-environment tests are allowed by default when they are scoped, reproducible, and do not mutate production data.
-- Allowed by default on the development environment:
+- Run development verification locally before handoff.
+- In this project, "local development environment" means the local repository or local feature worktree, not the production server runtime directory.
+- Local development tests are allowed by default when they are scoped, reproducible, and do not mutate production data.
+- Allowed by default locally:
   - Targeted backend unit tests, for example a specific Go package or `-run` pattern.
   - Targeted frontend tests, for example a specific Vitest spec.
   - Static checks such as `gofmt`, `git diff --check`, type checks, and lint checks.
-  - Frontend/backend builds when needed to prove compile correctness, as long as they run from the feature worktree and do not restart production services.
+  - Frontend/backend builds when needed to prove compile correctness, as long as they run from the local feature branch/worktree and do not restart production services.
 - Require explicit user approval before running:
   - Load tests, pressure tests, benchmark loops, or high-concurrency checks.
   - Full-suite tests known to be long-running or resource-heavy.
@@ -100,24 +110,25 @@ The controller agent is responsible for coordination:
 
 Feature branches are not deployed automatically.
 
-1. Develop in the feature worktree.
-2. Run relevant tests and verification.
+1. Develop locally on the feature branch or local feature worktree.
+2. Run relevant local tests and verification.
 3. Commit changes on the feature branch.
 4. Push the feature branch to GitHub.
 5. Tell the user the branch name, summary, changed files, and verification results.
 6. Wait for user review or explicit approval.
 7. Merge to `main` only after approval.
-8. Deploy from `main`.
-9. Build the production binary/assets.
+8. On the server, pull the approved GitHub `main`.
+9. Build the production binary/assets on the server from the pulled GitHub code.
 10. Restart services.
 11. Verify production behavior.
 12. Create a version tag when the deployment is accepted.
 
 ## Production Deployment Rules
 
-- Deployments happen on the server, not from the user's Mac.
+- Deployments happen on the server by pulling from GitHub, not by copying uncommitted local files.
 - Do not deploy a feature branch directly unless the user explicitly requests it.
 - Prefer deploying from `main` after merge.
+- Before deployment, make sure the intended commits have been pushed to GitHub.
 - Keep backups of service config files before editing operational configuration.
 - After deployment, verify:
   - `pixel.service` is active.

backend/internal/server/api_contract_test.go

@@ -579,7 +579,7 @@ func TestAPIContracts(t *testing.T) {
 					service.SettingKeySMTPUsername: "user",
 					service.SettingKeySMTPPassword: "secret",
 					service.SettingKeySMTPFrom:     "no-reply@example.com",
-					service.SettingKeySMTPFromName: "Sub2API",
+					service.SettingKeySMTPFromName: "MaxAPI",
 					service.SettingKeySMTPUseTLS:   "true",
 
 					service.SettingKeyTurnstileEnabled:   "true",
@@ -608,7 +608,7 @@ func TestAPIContracts(t *testing.T) {
 					service.SettingKeyOIDCConnectUserInfoIDPath:       "",
 					service.SettingKeyOIDCConnectUserInfoUsernamePath: "",
 
-					service.SettingKeySiteName:     "Sub2API",
+					service.SettingKeySiteName:     "MaxAPI",
 					service.SettingKeySiteLogo:     "",
 					service.SettingKeySiteSubtitle: "Subtitle",
 					service.SettingKeyAPIBaseURL:   "https://api.example.com",
@@ -651,7 +651,7 @@ func TestAPIContracts(t *testing.T) {
 					"smtp_username": "user",
 					"smtp_password_configured": true,
 					"smtp_from_email": "no-reply@example.com",
-					"smtp_from_name": "Sub2API",
+					"smtp_from_name": "MaxAPI",
 					"smtp_use_tls": true,
 					"turnstile_enabled": true,
 					"turnstile_site_key": "site-key",
@@ -686,7 +686,7 @@ func TestAPIContracts(t *testing.T) {
 						"ops_realtime_monitoring_enabled": true,
 						"ops_query_mode_default": "auto",
 						"ops_metrics_interval_seconds": 60,
-						"site_name": "Sub2API",
+						"site_name": "MaxAPI",
 						"site_logo": "",
 						"site_subtitle": "Subtitle",
 						"api_base_url": "https://api.example.com",
@@ -895,7 +895,7 @@ func TestAPIContracts(t *testing.T) {
 					"oidc_connect_userinfo_email_path": "",
 					"oidc_connect_userinfo_id_path": "",
 					"oidc_connect_userinfo_username_path": "",
-					"site_name": "Sub2API",
+					"site_name": "MaxAPI",
 					"site_logo": "",
 					"site_subtitle": "Subscription to API Conversion Platform",
 					"api_base_url": "",

backend/internal/service/auth_email_binding.go

@@ -124,7 +124,7 @@ func (s *AuthService) SendEmailIdentityBindCode(ctx context.Context, userID int6
 		return ErrServiceUnavailable
 	}
 
-	siteName := "Sub2API"
+	siteName := "MaxAPI"
 	if s.settingService != nil {
 		siteName = s.settingService.GetSiteName(ctx)
 	}

backend/internal/service/auth_oauth_email_flow.go

@@ -41,7 +41,7 @@ func (s *AuthService) SendPendingOAuthVerifyCode(ctx context.Context, email stri
 		return nil, ErrServiceUnavailable
 	}
 
-	siteName := "Sub2API"
+	siteName := "MaxAPI"
 	if s.settingService != nil {
 		siteName = s.settingService.GetSiteName(ctx)
 	}

backend/internal/service/auth_service.go

@@ -313,7 +313,7 @@ func (s *AuthService) SendVerifyCode(ctx context.Context, email string) error {
 	}
 
 	// 获取网站名称
-	siteName := "Sub2API"
+	siteName := "MaxAPI"
 	if s.settingService != nil {
 		siteName = s.settingService.GetSiteName(ctx)
 	}
@@ -356,7 +356,7 @@ func (s *AuthService) SendVerifyCodeAsync(ctx context.Context, email string) (*S
 	}
 
 	// 获取网站名称
-	siteName := "Sub2API"
+	siteName := "MaxAPI"
 	if s.settingService != nil {
 		siteName = s.settingService.GetSiteName(ctx)
 	}
@@ -1241,7 +1241,7 @@ func (s *AuthService) preparePasswordReset(ctx context.Context, email, frontendB
 	}
 
 	// Get site name
-	siteName := "Sub2API"
+	siteName := "MaxAPI"
 	if s.settingService != nil {
 		siteName = s.settingService.GetSiteName(ctx)
 	}

backend/internal/service/balance_notify_service.go

@@ -22,7 +22,7 @@ const (
 	quotaDimWeekly = "weekly"
 	quotaDimTotal  = "total"
 
-	defaultSiteName = "Sub2API"
+	defaultSiteName = "MaxAPI"
 )
 
 // quotaDimLabels maps dimension names to display labels.

backend/internal/service/payment_order.go

@@ -471,15 +471,15 @@ func (s *PaymentService) buildPaymentSubject(plan *dbent.SubscriptionPlan, limit
 		if plan.ProductName != "" {
 			return plan.ProductName
 		}
-		return "Sub2API Subscription " + plan.Name
+		return "MaxAPI Subscription " + plan.Name
 	}
 	amountStr := strconv.FormatFloat(limitAmount, 'f', 2, 64)
 	pf := strings.TrimSpace(cfg.ProductNamePrefix)
 	sf := strings.TrimSpace(cfg.ProductNameSuffix)
 	if pf != "" || sf != "" {
 		return strings.TrimSpace(pf + " " + amountStr + " " + sf)
 	}
-	return "Sub2API " + amountStr + " CNY"
+	return "MaxAPI " + amountStr + " CNY"
 }
 
 func (s *PaymentService) maybeBuildWeChatOAuthRequiredResponse(ctx context.Context, req CreateOrderRequest, amount, payAmount, feeRate float64) (*CreateOrderResponse, error) {

backend/internal/service/setting_service.go

@@ -511,7 +511,7 @@ func (s *SettingService) GetPublicSettings(ctx context.Context) (*PublicSettings
 		TotpEnabled:                      settings[SettingKeyTotpEnabled] == "true",
 		TurnstileEnabled:                 settings[SettingKeyTurnstileEnabled] == "true",
 		TurnstileSiteKey:                 settings[SettingKeyTurnstileSiteKey],
-		SiteName:                         s.getStringOrDefault(settings, SettingKeySiteName, "Sub2API"),
+		SiteName:                         s.getStringOrDefault(settings, SettingKeySiteName, "MaxAPI"),
 		SiteLogo:                         settings[SettingKeySiteLogo],
 		SiteSubtitle:                     s.getStringOrDefault(settings, SettingKeySiteSubtitle, "Subscription to API Conversion Platform"),
 		APIBaseURL:                       settings[SettingKeyAPIBaseURL],
@@ -1650,7 +1650,7 @@ func (s *SettingService) IsTotpEncryptionKeyConfigured() bool {
 func (s *SettingService) GetSiteName(ctx context.Context) string {
 	value, err := s.settingRepo.GetValue(ctx, SettingKeySiteName)
 	if err != nil || value == "" {
-		return "Sub2API"
+		return "MaxAPI"
 	}
 	return value
 }
@@ -1826,7 +1826,7 @@ func (s *SettingService) InitializeDefaultSettings(ctx context.Context) error {
 		SettingKeyEmailVerifyEnabled:                       "false",
 		SettingKeyRegistrationEmailSuffixWhitelist:         "[]",
 		SettingKeyPromoCodeEnabled:                         "true", // 默认启用优惠码功能
-		SettingKeySiteName:                                 "Sub2API",
+		SettingKeySiteName:                                 "MaxAPI",
 		SettingKeySiteLogo:                                 "",
 		SettingKeyPurchaseSubscriptionEnabled:              "false",
 		SettingKeyPurchaseSubscriptionURL:                  "",
@@ -1972,7 +1972,7 @@ func (s *SettingService) parseSettings(settings map[string]string) *SystemSettin
 		TurnstileEnabled:                 settings[SettingKeyTurnstileEnabled] == "true",
 		TurnstileSiteKey:                 settings[SettingKeyTurnstileSiteKey],
 		TurnstileSecretKeyConfigured:     settings[SettingKeyTurnstileSecretKey] != "",
-		SiteName:                         s.getStringOrDefault(settings, SettingKeySiteName, "Sub2API"),
+		SiteName:                         s.getStringOrDefault(settings, SettingKeySiteName, "MaxAPI"),
 		SiteLogo:                         settings[SettingKeySiteLogo],
 		SiteSubtitle:                     s.getStringOrDefault(settings, SettingKeySiteSubtitle, "Subscription to API Conversion Platform"),
 		APIBaseURL:                       settings[SettingKeyAPIBaseURL],

backend/internal/service/totp_service.go

@@ -89,7 +89,7 @@ const (
 	totpLoginTTL    = 5 * time.Minute
 	totpAttemptsTTL = 15 * time.Minute
 	maxTotpAttempts = 5
-	totpIssuer      = "Sub2API"
+	totpIssuer      = "MaxAPI"
 )
 
 // TotpService handles TOTP operations

backend/internal/service/user_service.go

@@ -1168,7 +1168,7 @@ func saveNotifyVerifyCode(ctx context.Context, cache EmailCache, email, code str
 
 // sendNotifyVerifyEmail builds and sends the verification email.
 func (s *UserService) sendNotifyVerifyEmail(ctx context.Context, emailService *EmailService, email, code string) error {
-	siteName := "Sub2API"
+	siteName := "MaxAPI"
 	if s.settingRepo != nil {
 		if name, err := s.settingRepo.GetValue(ctx, SettingKeySiteName); err == nil && name != "" {
 			siteName = name