Your on-demand AI engineering workforce. Architecture reviews, security audits, and product analysisβdelivered instantly.
Status: β PRODUCTION READY with 6 Enterprise Features (51/51 tests passing)
- OAuth 2.0 Authentication β Google login with JWT tokens (7-day expiration)
- Stripe Subscriptions β 4 tiers (Startup/Enterprise Γ Monthly/Annual)
- Credit-Based Billing β Tiered plans with automatic allocation (300-1200 credits/month)
- BYOK Support β Users bring their own Gemini key for unlimited access
- Admin Dashboard β User management, analytics, suspension, reactivation
- Per-User Rate Limiting β Database-backed by subscription tier
- Audit Logging β Compliance-ready with severity levels
- PostgreSQL Backups β Automated daily with 30-day retention
- Monitoring Stack β Prometheus + Grafana + AlertManager (11 metrics, 6 alerts)
- Email Service β SendGrid integration for transactional emails
- Error Tracking β Sentry for real-time error monitoring
Start here for your use case:
| Document | Purpose | Time |
|---|---|---|
| GETTING_STARTED.md | 10-step launch guide | 5 min |
| LAUNCH_CHECKLIST.md | Pre-launch verification | 5 min |
| QUICKSTART.md | Quick reference (5 commands) | 2 min |
| ENTERPRISE.md | Complete feature guide | 30 min |
| IMPLEMENTATION_SUMMARY.md | Technical architecture | 20 min |
| LAUNCH_STATUS_REPORT.md | Full implementation status | 10 min |
chmod +x setup.sh
./setup.sh# 1. Copy environment template
cp backend/.env.example backend/.env.local
# 2. Fill in your credentials (see GETTING_STARTED.md)
# STRIPE_SECRET_KEY, GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, DATABASE_URL
# 3. Install dependencies
cd backend && npm install && cd ..
cd codecouncil-ai && npm install && cd ..
# 4. Setup database
cd backend && npm run db:migrate && npm run db:seed && cd ..
# 5. Start services
# Terminal 1: cd backend && npm run dev
# Terminal 2: cd codecouncil-ai && npm run devCodeConcilAI/
βββ codecouncil-ai/ # Frontend (React 19 + Vite 6)
β βββ components/ # UI components
β βββ services/ # API, Gemini, GitHub services
βββ backend/ # Node.js + Express API
β βββ src/
β β βββ routes/ # 13 API endpoints
β β βββ services/ # 8 business logic services
β β βββ middleware/ # Auth, rate limit, metrics
β β βββ prisma/ # Database schema & migrations
β βββ scripts/ # Backup, restore, setup
βββ monitoring/ # Prometheus + Grafana configs
βββ docker-compose.yml # Full stack (local)
βββ docker-compose.monitoring.yml # Monitoring stack
| Plan | Price | Credits/mo | Requests/day | Analyses/day | Support |
|---|---|---|---|---|---|
| Startup Monthly | $49/mo | 300 | 1,000 | 20 | Basic |
| Startup Annual | $499/yr | 350 | 1,000 | 20 | Basic |
| Enterprise Monthly | $149/mo | 1,000 | 10,000 | 500 | Priority |
| Enterprise Annual | $1,499/yr | 1,200 | 10,000 | 500 | Priority |
| Trial | Free | 400 | β | β | Community |
GET /api/subscriptions/plans List all plans
GET /api/subscriptions/current Get user's subscription
POST /api/subscriptions/create Create subscription
POST /api/subscriptions/cancel Cancel subscription
POST /api/subscriptions/change-plan Upgrade/downgrade
GET /api/admin/stats Dashboard metrics
GET /api/admin/audit-logs Query audit logs
GET /api/admin/users/:userId User details
POST /api/admin/users/:userId/suspend Suspend user
POST /api/admin/users/:userId/reactivate Reactivate user
GET /api/admin/analytics Usage analytics
GET /metrics Prometheus metrics
GET /api/rate-limit/usage User rate limits
β Authentication & Authorization
- OAuth 2.0 with PKCE
- JWT tokens (7-day expiration)
- Role-based access (admin flag)
- Refresh token rotation
β API & Data Protection
- Per-user rate limiting (database-backed)
- Request validation & sanitization
- CORS restricted to allowed domains
- CSP headers in frontend
- Stripe webhook signature verification
- PostgreSQL with encrypted connections
- API keys stored only in backend
β Compliance & Monitoring
- Audit logging with severity levels
- Real-time error tracking (Sentry)
- Security event alerts
- GDPR-ready (user data export)
- PII protection in logs
- Automated daily backups
HTTP: Request duration, total requests, error rate
Business: Subscriptions created/canceled, payment success
System: DB pool, memory, rate limit events
Alerts: 6 rules (errors, latency, pool, memory, disk, payments)
View dashboards: http://localhost:3001/grafana (admin/admin)
chmod +x verify.sh
./verify.shShould show 51/51 tests PASSING β
railway login && railway init
railway variables set STRIPE_SECRET_KEY=...
railway upConnect GitHub β Create Web Service β Auto-deploy
heroku create codecouncil-ai
heroku addons:create heroku-postgresql:hobby-dev
git push heroku maindocker-compose up -dSee GETTING_STARTED.md for platform-specific instructions.
Before going live (1 hour):
- Create 4 Stripe products with price IDs
- Setup Google OAuth credentials
- Configure PostgreSQL database
- Fill
backend/.env.localwith all credentials - Run
./pre-launch.sh(interactive setup) - Run
./verify.sh(confirm 51/51 tests pass) - Test locally with
npm run dev(backend + frontend) - Deploy to chosen platform
- Configure Stripe webhook:
https://your-app.com/api/webhooks/stripe - Promote admin user to access dashboard
- Setup Slack/PagerDuty alerts (optional)
Full checklist: LAUNCH_CHECKLIST.md
| Problem | Solution |
|---|---|
| Backend won't start | Check Node.js >= 18, npm install, database connection |
| OAuth fails | Verify GOOGLE_CLIENT_ID matches frontend & backend |
| Stripe not working | Confirm credentials and webhook registered |
| Database error | Run npm run db:migrate, check DATABASE_URL |
| Rate limit issues | Check user tier with GET /api/rate-limit/usage |
Full troubleshooting: See ENTERPRISE.md
- π Docs: ENTERPRISE.md β Complete guide
- π Launch: GETTING_STARTED.md β 10-step guide
- β
Verify: Run
./verify.shto test all features - π Status: LAUNCH_STATUS_REPORT.md
Production readiness verified:
β 51/51 verification tests PASSING
β TypeScript compiles cleanly
β All migrations ready to deploy
β 13 API endpoints working
β 8 database models with 7 indexes
β 11 Prometheus metrics collecting
β 6 alert rules configured
β Daily backup automation ready
Frontend: React 19.2 + Vite 6.2 + TypeScript 5.8
Backend: Node.js + Express 4.18 + TypeScript 5.8
Database: PostgreSQL 15 + Prisma ORM 5.7
Billing: Stripe 14.8 (subscriptions, webhooks)
Monitoring: Prometheus + Grafana + AlertManager
Email: SendGrid
Error Tracking: Sentry
Authentication: Google OAuth 2.0 + JWT
Containerization: Docker + Docker Compose
- First time? β Read GETTING_STARTED.md
- Ready to launch? β Follow LAUNCH_CHECKLIST.md
- Need details? β Check ENTERPRISE.md
- Verify setup? β Run
./verify.sh
Status: β
Production-Ready
Version: 1.0.0
Last Updated: 2025
π Good luck with your launch!