new-api/CUSTOM_REDEEM_SUBSCRIPTION.md

Customization: subscription-capable redemption codes

Base upstream commit: 677d02f2 Local branch: codex/redeem-subscription Deployment dir: /root/docker/newapi

What changed

• Redemption codes support two modes: quota and subscription.
• Subscription redemption creates user_subscriptions with source=redeem.
• Admin redemption UI supports selecting a subscription plan.
• User redemption response distinguishes quota vs subscription.

Suggested future upgrade flow

1. Pull latest upstream source into a clean clone.
2. Re-apply the patch file in this folder.
3. Resolve any merge conflicts in redemption/subscription files.
4. Rebuild with: docker compose up -d --build new-api
5. Verify with: curl http://127.0.0.1:3000/api/status

Current compose note

• This server is currently using source build mode instead of the official image.
• Original compose backup: docker-compose.yml.bak-20260406094555