feat: Landing page redesign, Docker setup, contact/help pages, and auth improvements

- Redesign landing page: remove AI-heavy aesthetics, simplify hero/bento/CTA sections,
  add BorderGlow button effect, CountUp stats animation, and theme-aware gradients
- Add BorderGlow component (edge glow on hover via CSS conic-gradient + pointer tracking)
- Add Docker configs for web and api services with docker-compose.prod.yml
- Add contact and help pages
- Add AI upgrade modal component
- Improve public header layout and responsiveness
- Fix Google OAuth strategy and auth controller
- Add explore page improvements
- Update dev docs, README, and env examples

Author: Jason-chen-coder

.dockerignore

@@ -0,0 +1,46 @@
+# Dependencies
+node_modules
+**/node_modules
+
+# Build outputs
+apps/api/dist
+apps/web/.next
+apps/web/out
+
+# Environment files (never bake secrets into images)
+.env
+.env.local
+.env.*.local
+apps/api/.env
+apps/web/.env.local
+
+# Git
+.git
+.gitignore
+
+# Docker
+docker-compose*.yml
+**/Dockerfile
+
+# Logs
+*.log
+npm-debug.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode
+.idea
+
+# Test
+coverage
+**/*.test.ts
+**/*.spec.ts
+
+# Docs
+*.md
+images
+plan
+learning

.env.example

@@ -1,8 +1,69 @@
-# ==================== 前端配置示例 ====================
-# 复制此文件到 apps/web/.env.local 并根据需要修改
+# DocStudio 环境变量配置
+# 使用方式：cp .env.example .env，然后修改下方所有变量
+#
+# ⚠️  标注「必填」的项目不填写会导致服务无法启动
+# ⚠️  标注「构建时」的 NEXT_PUBLIC_* 变量在 Docker 镜像构建时烧入，修改后需重新 build
 
-# API 地址
-NEXT_PUBLIC_API_URL=http://localhost:3001
+# ── 数据库（必填）────────────────────────────────────────────
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=change_me_strong_password
+POSTGRES_DB=docstudio
 
-# 环境
-NEXT_PUBLIC_ENV=development
+# ── 服务地址（必填，填写你的实际域名）────────────────────────
+# 本地测试用 http://localhost:3001 和 http://localhost:3000
+API_URL=https://api.yourdomain.com
+FRONTEND_URL=https://yourdomain.com
+
+# ── 前端变量（必填 · 构建时烧入镜像）────────────────────────
+# ⚠️  这些变量在 docker build 时固化到前端代码，改了必须重新构建镜像
+NEXT_PUBLIC_API_URL=https://api.yourdomain.com
+NEXT_PUBLIC_WEBSOCKET_URL=wss://api.yourdomain.com:1234
+NEXT_PUBLIC_CDN_URL=https://cdn.yourdomain.com
+NEXT_PUBLIC_SITE_URL=https://yourdomain.com
+
+# ── JWT（必填）──────────────────────────────────────────────
+# 生成强密钥：openssl rand -base64 32
+JWT_SECRET=change_this_to_a_strong_random_secret
+JWT_EXPIRES_IN=7d
+
+# ── 超级管理员（必填，首次启动自动创建）─────────────────────
+SUPER_ADMIN_EMAIL=admin@yourdomain.com
+SUPER_ADMIN_PASSWORD=change_me_strong_password
+
+# ── MinIO 对象存储（必填）────────────────────────────────────
+MINIO_ACCESS_KEY=change_me_minio_access_key
+MINIO_SECRET_KEY=change_me_minio_secret_key
+MINIO_BUCKET=avatars
+MINIO_PUBLIC_ENDPOINT=https://cdn.yourdomain.com
+MINIO_USE_SSL=false
+
+# ── SMTP 邮件（可选，不填则禁用邮件功能）─────────────────────
+# 支持：Gmail / QQ邮箱 / 企业邮箱 / SendGrid / 腾讯云SES 等
+SMTP_HOST=smtp.yourdomain.com
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=
+SMTP_PASS=
+SMTP_FROM="DocStudio" <noreply@yourdomain.com>
+
+# ── AI 辅助写作（可选，不填则禁用 AI 功能）───────────────────
+# 支持 MiniMax / OpenAI / 其他 OpenAI 兼容 API
+AI_PROVIDER=minimax
+AI_API_KEY=
+AI_BASE_URL=https://api.minimax.io/v1
+AI_MODEL=MiniMax-Text-01
+AI_DAILY_LIMIT=50
+
+# ── GitHub OAuth（可选）──────────────────────────────────────
+# 创建地址：https://github.com/settings/developers
+# ⚠️  在 GitHub 后台填写的 Callback URL：{API_URL}/auth/github/callback
+#     例如：https://api.yourdomain.com/auth/github/callback
+GITHUB_CLIENT_ID=
+GITHUB_CLIENT_SECRET=
+
+# ── Google OAuth（可选）──────────────────────────────────────
+# 创建地址：https://console.cloud.google.com
+# ⚠️  在 Google Cloud 填写的授权重定向 URI：{API_URL}/auth/google/callback
+#     例如：https://api.yourdomain.com/auth/google/callback
+GOOGLE_CLIENT_ID=
+GOOGLE_CLIENT_SECRET=

.impeccable.md

@@ -0,0 +1,41 @@
+# DocStudio Design Context
+
+## Design Context
+
+### Users
+Developers, technical teams, and knowledge workers managing documentation and wikis. They use DocStudio in focused work sessions — writing, reviewing, and organizing information. They are comfortable with technical interfaces and expect precision and reliability. The product is Chinese-first but built for a global developer audience.
+
+### Brand Personality
+**温暖 · 人性化 · 亲和力** (Warm · Human · Approachable)
+
+The brand sits at the intersection of precision tooling and human warmth. Not cold enterprise software, not playful startup fluff — think the quiet confidence of a craftsperson's tool. It should feel like Linear: refined, purposeful, low-key. But with a subtle warmth that makes it feel personal and welcoming, not just technically impressive.
+
+### Aesthetic Direction
+- **Primary reference**: Linear — clean rows, thin borders, minimal chrome, precise typography, confident dark mode
+- **Tone**: Low-key and refined (低调精致). Never flashy, never loud. Let quality speak quietly.
+- **Theme**: Both light and dark must be excellent. Light: warm off-whites (#FAFAF9), not pure white. Dark: deep navy/charcoal (#0D0D10), not pure black.
+- **Anti-references**: Avoid loud gradient buttons, colorful pill everything, glassmorphism gimmicks, heavy shadows
+- **Technical feel**: Subtle dot grids, monospace handles, code-like precision in spacing
+- **Color**: Violet-blue primary (`hsl(237 97% 59%)`). Use platform/brand colors sparingly as icon tints, not full button fills.
+
+### Design Principles
+
+1. **Quiet confidence** — Let quality be felt, not announced. Subtle over showy. One intentional detail beats five decorative ones.
+
+2. **Warmth through detail** — Human touches: online indicators, warm off-whites, approachable type sizing. Technical precision + human warmth = DocStudio's signature.
+
+3. **Linear-caliber interaction** — Every hover state, every transition, every spacing decision should feel considered. Hover reveals (arrows appearing, opacity shifts), not always-visible clutter.
+
+4. **Typography-first hierarchy** — Size and weight do the heavy lifting. Color and decoration are secondary. Plus Jakarta Sans throughout, generous line height, tight tracking on headings.
+
+5. **Motion with restraint** — Framer Motion for entrances (stagger, fade+slide) and state changes (AnimatePresence). Use `cubic-bezier(0.16, 1, 0.3, 1)` (ease-out-expo). Never bounce, never elastic. Exit animations ~75% of enter duration.
+
+### Technical Constraints
+- Next.js 16 + React 19 + TypeScript
+- Tailwind CSS 4 (use utility classes, no arbitrary values unless needed)
+- `framer-motion` for animations (import from `'framer-motion'`)
+- Radix UI primitives for interactive components
+- Plus Jakarta Sans (primary), Geist Mono (code/handles)
+- Border radius base: 32px (use `rounded-2xl` for cards, `rounded-xl` for interactive rows)
+- WCAG AA minimum contrast
+- `prefers-reduced-motion` must be respected