nproxy

Product codebase for a crypto-subscription image gateway.

The repository contains:

• runtime applications and shared packages;
• the agreed system plan and architecture documents;
• operational notes for deployment, Telegram pairing, and provider key rotation;
• directory-scoped instructions so Codex runs implement against the same decisions.

Chosen baseline

• Product: B2C website
• Billing: one monthly plan, paid with crypto through a payment processor
• Model support: starts with nano_banana
• Generation modes: text-to-image and image-to-image
• Infra target: one VPS with Docker Compose
• Admin surfaces: web admin and Telegram bot
• Key management: multiple provider keys with round-robin routing, failover, cooldown, balance tracking, and optional per-key proxy

Main directories

• apps/ runtime entrypoints
• packages/ shared domain and adapter code
• docs/ source-of-truth planning documents
• infra/ deployment templates
• scripts/ operational helpers

Read first

• docs/plan/system-plan.md
• docs/architecture/system-overview.md
• docs/ops/deployment.md
• CONTRIBUTING.md