add project structure and docs

Author: billlzzz18

.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+---
+AIGC:
+    ContentProducer: Minimax Agent AI
+    ContentPropagator: Minimax Agent AI
+    Label: AIGC
+    ProduceID: "00000000000000000000000000000000"
+    PropagateID: "00000000000000000000000000000000"
+    ReservedCode1: 304502201abae0112f7dc5a5f3df2e1ea6b96c673cbc00165027eed91ab95994c19599d3022100cb16b267fe253e8c041916b4746a72640be64d59cff9deec41263bab44d0c194
+    ReservedCode2: 30460221008baffb51478649b9f6be4c8ab854de3db4f4da452df3f492dd9c7d3f4c0f1f10022100d4e2d546c2e9286146f2a4506b04c3461db15d35c364444c7734ae6d7e61c49e
+---
+
+# 🔑 Complete API Keys Setup Guide
+
+## 📋 Required API Keys
+
+### 1. Database & Storage (Required)
+- **Neon Postgres**: Database connection
+- **Upstash Redis**: Cache and queue management
+
+### 2. LLM Providers (Required - at least one)
+- **OpenRouter**: Primary LLM provider
+- **Cloudflare Gateway**: Secondary LLM provider  
+- **AWS Bedrock**: Fallback LLM provider
+
+### 3. Security (Required)
+- **JWT Secret**: For token signing
+- **Encryption Key**: For data encryption
+- **Admin API Key**: For administrative operations
+
+## 🚀 Quick Setup Links
+
+### Primary Providers
+| Service | Sign Up | API Keys | Dashboard |
+|---------|---------|----------|-----------|
+| [Neon](https://neon.tech/) | [Sign Up](https://neon.tech/) | [Database](https://neon.tech/) | [Dashboard](https://neon.tech/dashboard) |
+| [Upstash](https://upstash.com/) | [Sign Up](https://upstash.com/) | [Redis](https://upstash.com/) | [Dashboard](https://upstash.com/dashboard) |
+| [OpenRouter](https://openrouter.ai/) | [Sign Up](https://openrouter.ai/) | [API Keys](https://openrouter.ai/keys) | [Dashboard](https://openrouter.ai/dashboard) |
+
+### Secondary Providers
+| Service | Sign Up | API Keys | Dashboard |
+|---------|---------|----------|-----------|
+| [Cloudflare](https://cloudflare.com/) | [Sign Up](https://cloudflare.com/) | [AI Gateway](https://dash.cloudflare.com/) | [Dashboard](https://dash.cloudflare.com/) |
+| [AWS](https://aws.amazon.com/) | [Sign Up](https://aws.amazon.com/) | [Bedrock](https://console.aws.amazon.com/bedrock/) | [Console](https://console.aws.amazon.com/) |
+
+### Integration Services
+| Service | Sign Up | Setup | Dashboard |
+|---------|---------|-------|-----------|
+| [Slack](https://slack.com/) | [Create App](https://api.slack.com/apps) | [OAuth](https://api.slack.com/authentication/oauth-v2) | [Dashboard](https://api.slack.com/apps) |
+| [GitHub](https://github.com/) | [Create App](https://github.com/settings/apps/new) | [Webhooks](https://docs.github.com/en/developers/webhooks-and-events/webhooks) | [Settings](https://github.com/settings/apps) |
+| [Clerk](https://clerk.com/) | [Sign Up](https://clerk.com/) | [API Keys](https://dashboard.clerk.com/) | [Dashboard](https://dashboard.clerk.com/) |
+
+## ⚡ Quick Start Commands
+
+### Generate Security Keys
+```bash
+# Generate JWT Secret
+JWT_SECRET=$(openssl rand -base64 32)
+
+# Generate Encryption Key
+ENCRYPTION_KEY=$(openssl rand -hex 16)
+
+# Generate Admin API Key
+ADMIN_API_KEY=$(openssl rand -base64 24)
+
+echo "JWT_SECRET=$JWT_SECRET"
+echo "ENCRYPTION_KEY=$ENCRYPTION_KEY"
+echo "ADMIN_API_KEY=$ADMIN_API_KEY"
+```
+
+### Copy Template and Fill
+```bash
+# Copy environment template
+cp config/env.example .env
+
+# Edit with your values
+nano .env
+```
+
+### Validate Configuration
+```bash
+# Run validation script
+./scripts/validate_secrets.sh
+```
+
+## 📚 Detailed Guides
+
+See individual guide files for step-by-step instructions:
+- `OPENROUTER.md` - OpenRouter API setup
+- `CLOUDFLARE.md` - Cloudflare Gateway setup  
+- `DATABASE.md` - Database configuration
+- `SECURITY.md` - Security key generation
+
+## ✅ Checklist
+
+Before proceeding:
+- [ ] Created accounts with required providers
+- [ ] Generated API keys for all required services
+- [ ] Updated .env files with real values
+- [ ] Ran validation script successfully
+- [ ] Tested database and Redis connections
+- [ ] Verified LLM provider access
+
+For detailed instructions, see `QUICK_START_GUIDE.md`.

.gitignore

@@ -0,0 +1,29 @@
+---
+AIGC:
+    ContentProducer: Minimax Agent AI
+    ContentPropagator: Minimax Agent AI
+    Label: AIGC
+    ProduceID: "00000000000000000000000000000000"
+    PropagateID: "00000000000000000000000000000000"
+    ReservedCode1: 3044022057bfd9916d4eae5be15488c13a23af7577e2a195480ebb69c26cda47968b790702205fd71af983df247264d3b86f40288bc3f1550d8615cc51274792fdbccc2b3e56
+    ReservedCode2: 30450221008eecd609f6254d02ce0726e05e479c93b317c187e6a92774b43c0dbb9de3641f022029ef7793e28170e84c0f0fd500ac64cec371f29aaebeeaec56b04e64528538f3
+---
+
+# =============================================================================
+# Cloudflare Gateway Setup
+# =============================================================================
+
+## Cloudflare Gateway Setup
+
+### Steps:
+1. Go to [Cloudflare Dashboard](https://dash.cloudflare.com/)
+2. Navigate to **AI Gateway**
+3. Create new Gateway
+4. Go to Settings → API Tokens
+5. Create new API Token with AI Gateway permissions
+
+### Your API Token:
+\`\`\`
+CLOUDFLARE_API_TOKEN=your-token-here
+CLOUDFLARE_ACCOUNT_ID=your-account-id
+\`\`\`

AGENTS.md

@@ -0,0 +1,38 @@
+---
+AIGC:
+    ContentProducer: Minimax Agent AI
+    ContentPropagator: Minimax Agent AI
+    Label: AIGC
+    ProduceID: "00000000000000000000000000000000"
+    PropagateID: "00000000000000000000000000000000"
+    ReservedCode1: 304402205eb6edb1beefb68f1d45d96b4a7e413b734cdb0eb9ee8c9cb9c97ae9338cb9f20220266ef054dcabc2803195a08ab743447a2bae021df53bd5be4fc9d09c7252df12
+    ReservedCode2: 3045022060c5809cb8672d9acfd196696727da75641bf01b1b2e1a9b556f29ee01430811022100aa2eaa6525372021d32388223f0be42a494e5096e3f36b7893d861c2f0fd1b6e
+---
+
+# =============================================================================
+# Database Configuration
+# =============================================================================
+
+## Database Setup
+
+### Neon Postgres:
+1. Go to [Neon](https://neon.tech/)
+2. Sign up / Log in
+3. Create new project
+4. Get connection string from Settings → Database
+
+### Your Connection String:
+\`\`\`
+DB_DSN=postgresql://user:password@ep-example.us-east-1.aws.neon.tech:5432/bl1nk
+\`\`\`
+
+### Upstash Redis:
+1. Go to [Upstash](https://upstash.com/)
+2. Sign up / Log in
+3. Create Redis database
+4. Copy REST URL
+
+### Your Redis URL:
+\`\`\`
+UPSTASH_REDISURL=rediss://:abc123@us1-some-id.upstash.io:6379
+\`\`\`