This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
gitgram-ai/docs/launch-secrets-checklist.md
2026-06-22 17:45:56 +03:00

134 lines
3.4 KiB
Markdown

# Launch Secrets Checklist
Last updated: 2026-05-12
This file is the operator-facing checklist for filling the launch env files before deploy.
Preferred file layout:
- staging: `.env.gitgram.staging`, `.env.gitgram-web.staging`, `.env.aitm-api.staging`
- production: `.env.gitgram.production`, `.env.gitgram-web.production`, `.env.aitm-api.production`
Fallback layout:
- `.env.gitgram`
- `.env.gitgram-web`
- `.env.aitm-api`
Current gate:
- `npm run verify:launch` for deployable core readiness
- `npm run verify:launch:full` for all third-party integrations live
Polar reference:
- `docs/polar-payment-setup.md`
Current state:
- deploy/readiness scripts are in place
- AITM package dry-run verification passes
- dedicated Neon databases now exist for `gitgram_staging`, `gitgram_production`, `aitm_staging`, and `aitm_production`
- root staging/production env files now contain real database URLs and generated app-owned secrets
- full-integration launch is still blocked by provider-issued values, not local infra placeholders
## Gitgram Backend Env
App-owned values now set:
- `DATABASE_URL`
- `JWT_SECRET`
- `JWT_REFRESH_SECRET`
Still provider-issued:
- `REDIS_URL`
- `FRONTEND_URL`
- `CORS_ORIGIN`
- `GITHUB_CLIENT_ID`
- `GITHUB_CLIENT_SECRET`
- `POLAR_ACCESS_TOKEN`
- `POLAR_MODE`
- `POLAR_WEBHOOK_SECRET`
- `POLAR_PREMIUM_PRODUCT_ID`
- `POLAR_CREATOR_PRODUCT_ID`
- `RESEND_API_KEY`
- `SENTRY_DSN`
Optional depending on storage mode:
- `AWS_ACCESS_KEY_ID`
- `AWS_SECRET_ACCESS_KEY`
- `AWS_S3_BUCKET`
- `AWS_REGION`
Files:
- staging: `.env.gitgram.staging`
- production fallback: `.env.gitgram` or `.env.gitgram.production`
## Gitgram Web Env
Confirm or fill:
- `NEXT_PUBLIC_API_URL`
- `NEXT_PUBLIC_WS_URL`
- `NEXT_PUBLIC_GITHUB_CLIENT_ID`
- `NEXT_PUBLIC_GOOGLE_CLIENT_ID`
- `NEXT_PUBLIC_AITM_API_URL`
- `NEXT_PUBLIC_SENTRY_DSN`
Files:
- staging: `.env.gitgram-web.staging`
- production fallback: `.env.gitgram-web` or `.env.gitgram-web.production`
## AITM API Env
App-owned values now set:
- `DATABASE_URL`
- `INTERNAL_SECRET`
Still provider-issued:
- `CORS_ORIGIN`
- `WEBSITE_URL`
- `POLAR_ACCESS_TOKEN`
- `POLAR_MODE`
- `POLAR_WEBHOOK_SECRET`
- `POLAR_PRO_PRODUCT_ID`
- `POLAR_TEAM_PRODUCT_ID`
- `RESEND_API_KEY`
- `SENTRY_DSN`
Optional:
- `CLERK_WEBHOOK_SECRET`
- `REDIS_URL`
- `OPENAI_API_KEY`
- `ANTHROPIC_API_KEY`
- `VOYAGE_API_KEY`
- `BRAVE_SEARCH_API_KEY`
Files:
- staging: `.env.aitm-api.staging`
- production fallback: `.env.aitm-api` or `.env.aitm-api.production`
## Provider Mapping
GitHub OAuth:
- `GITHUB_CLIENT_ID`
- `GITHUB_CLIENT_SECRET`
- `NEXT_PUBLIC_GITHUB_CLIENT_ID`
Polar:
- Gitgram: `POLAR_ACCESS_TOKEN`, `POLAR_MODE`, `POLAR_WEBHOOK_SECRET`, `POLAR_PREMIUM_PRODUCT_ID`, `POLAR_CREATOR_PRODUCT_ID`
- AITM: `POLAR_ACCESS_TOKEN`, `POLAR_MODE`, `POLAR_WEBHOOK_SECRET`, `POLAR_PRO_PRODUCT_ID`, `POLAR_TEAM_PRODUCT_ID`
Email:
- `RESEND_API_KEY`
Monitoring:
- `SENTRY_DSN`
- `NEXT_PUBLIC_SENTRY_DSN`
Core infra:
- Gitgram: `DATABASE_URL`, `REDIS_URL`, `JWT_SECRET`, `JWT_REFRESH_SECRET`
- AITM: `DATABASE_URL`, `INTERNAL_SECRET`
## Deploy Sequence
1. Run `npm run verify:launch` for the core deploy gate.
2. Run `bash scripts/deploy-launch.sh staging --gitgram-only`.
3. Run `bash scripts/deploy-launch.sh staging --aitm-only`.
4. Configure nginx and DNS if not already live.
5. Run `npm run verify:public-launch`.
6. Once OAuth, Polar, Resend, and Sentry are configured, run `npm run verify:launch:full`.