Feature/dynamic pricing

[only-wjt]

根据时间动态调整倍率

Summary by CodeRabbit

Release Notes

• New Features

  • Maintenance Mode: Schedule planned maintenance windows with advance user notification, admin bypass option, and whitelist capabilities.
  • Time-Based Dynamic Pricing: Configure rules to apply pricing multipliers during specific days/hours.
  • Token Configuration Export: One-click export of token configs for integration with Codex, Claude Code, Cursor, and other tools.

• Documentation

  • Comprehensive implementation roadmap for monitoring, scheduling, cleanup, and other platform enhancements.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

Walkthrough

This PR introduces multiple interconnected features for New-API: maintenance mode with time windows and whitelist controls, time-based dynamic pricing multipliers for temporal pricing adjustments, token configuration export functionality, and comprehensive implementation documentation. Changes span documentation files, Go backend logic (controllers, middleware, settings), TypeScript/React frontend components, and i18n localization.

Changes

Cohort / File(s)	Summary
Implementation Documentation aidoc/implementation_plan.md, aidoc/implementation_plan_revised.md, aidoc/implementation_playbook.md, aidoc/newapiplus自定义开发实施方案.md	Detailed technical specifications and phased delivery roadmaps for the New-API secondary development initiative, including architecture diagrams, module breakdown, Sprint planning, and engineering constraints.
Feature Module Documentation aidoc/module_1_monitor.md, aidoc/module_2_scheduler.md, aidoc/module_3_maintenance.md, aidoc/module_4_concurrency.md, aidoc/module_5_fallback.md, aidoc/module_6_import.md, aidoc/module_7_cleanup.md, aidoc/module_8_extras.md	Feature-level design documents covering slow request monitoring, scheduling engine, maintenance mode, user concurrency limits, channel fallback strategies, token export, inactive account cleanup, and additional optional features.
Maintenance Mode Backend controller/maintenance.go, middleware/maintenance.go, setting/system_setting/maintenance.go	Maintenance mode control with time-window validation, whitelist enforcement, admin bypass logic, Redis/database persistence, and gating of login operations during active maintenance.
Time Dynamic Ratio Backend setting/operation_setting/time_dynamic_ratio.go, controller/time_dynamic_ratio.go, relay/helper/price.go, service/task_billing.go, service/text_quota.go	Time-based multiplier resolution with weekday/time window/group/model matching, quota and billing recalculation integration points, and configuration management.
Token Export Backend controller/token_export.go	HTTP endpoint and helper functions to generate and export token configurations for external tools (Codex, Claude Code, Cursor, generic OpenAI) with environment scripts, config files, and test commands.
Relay & Pricing Integration controller/relay.go, types/price_data.go, model/task.go, relay/helper/price.go, service/log_info_generate.go	Extension of billing context and price data structures to propagate time dynamic multiplier through relay processing, quota calculation, and logging pipelines.
Login & Status Gating controller/user.go, controller/misc.go	Addition of maintenance-mode login gate and status endpoint enrichment with maintenance configuration for public consumption.
Router Middleware Wiring router/relay-router.go, router/video-router.go, router/api-router.go	Middleware chain updates to include maintenance checks on relay endpoints and new authenticated routes for maintenance/time-dynamic-ratio management.
Frontend Maintenance UI web/src/components/layout/MaintenanceBanner.jsx, web/src/pages/Setting/Operation/SettingsMaintenance.jsx, web/src/components/layout/PageLayout.jsx	Maintenance banner component (overlay and sticky notices based on time window and user role) and admin configuration page with time picker, whitelist user input, and status controls.
Frontend Time Dynamic Ratio UI web/src/pages/Setting/Operation/SettingsTimeDynamicRatio.jsx	Admin page for managing time-based multiplier rules: rule creation/editing with time/weekday/group/model selectors, priority reordering, enable/disable toggles, and API integration.
Frontend Token Export UI web/src/components/table/tokens/modals/TokenExportConfigModal.jsx	Modal component displaying tool-specific token export configurations with environment variables, config file paths/content, test commands, and one-click copy actions.
Frontend Integration web/src/components/settings/OperationSetting.jsx, web/src/components/table/usage-logs/UsageLogsColumnDefs.jsx, web/src/hooks/usage-logs/useUsageLogsData.jsx	Integration of new maintenance and time-dynamic-ratio settings panels; augmentation of usage log UI to display time multiplier when applied.
Internationalization web/src/i18n/locales/en.json, web/src/i18n/locales/zh-CN.json	Locale keys for maintenance mode configuration, time dynamic ratio rules, and related user-facing messages in English and Simplified Chinese.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~75 minutes

Possibly related PRs

• fix: channel affinity #2799: Modifies usage-logs UI (UsageLogsColumnDefs.jsx, useUsageLogsData.jsx) to display log details and pricing information—overlaps with this PR's integration of time multiplier display.
• 💱 feat(settings): introduce site-wide quota display type (USD/CNY/TOKENS/CUSTOM) #1923: Extends controller/misc.go's GetStatus response with quota/currency fields—conflicts with maintenance field addition to the same endpoint.
• 新增"顶栏"、"侧边栏"管理功能 #1701: Adds HeaderNavModules and sidebar configuration fields to GetStatus response—conflicts with maintenance field addition to the same endpoint.

Suggested reviewers

• creamlike1024
• Calcium-Ion

Poem

🐰 Maintenance calls, time bends with grace,
Tokens exported to every place,
Multipliers bloom in twilight hours,
New-API shines with scheduling powers!
Planning complete, the roadmap's clear—
Let the development begin here! 🎉

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 47.89% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title 'Feature/dynamic pricing' partially describes the changeset but is not fully specific. While dynamic pricing is indeed a core feature added, the PR also includes maintenance mode V1—a significant, independent feature. The title only highlights one of two major feature areas.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

⚔️ Resolve merge conflicts

• Resolve merge conflict in branch feature/dynamic-pricing

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}