feat(database): add SQLite schema initialization for stats_requests, visitor_logs, and badges tables

Author: pphatdev

.env.example

@@ -20,12 +20,24 @@ CLOUDFLARE_ACCOUNT_ID=
 CLOUDFLARE_D1_DATABASE_ID=
 CLOUDFLARE_D1_TOKEN=
 
-# Example: Redis Cloud
-REDIS_HOST=redis-10434.crce262.us-east-1-1.ec2.cloud.redislabs.com
-REDIS_PORT=10434
-REDIS_USERNAME=default
-REDIS_PASSWORD=your_password_here
-REDIS_TLS=true
+# Tunnel
+CLOUDFLARED_TUNNEL_NAME=github-stats
+CLOUDFLARED_TUNNEL_TOKEN=
+
+# Local Docker Compose Redis (default)
+REDIS_HOST=redis
+REDIS_PORT=6379
+REDIS_USERNAME=
+REDIS_PASSWORD=
+REDIS_TLS=false
+REDIS_DB=0
+
+# Example: Redis Cloud (optional)
+# REDIS_HOST=redis-10434.crce262.us-east-1-1.ec2.cloud.redislabs.com
+# REDIS_PORT=10434
+# REDIS_USERNAME=default
+# REDIS_PASSWORD=your_password_here
+# REDIS_TLS=true
 
 # ============================================================================
 # Debugging

compose.yaml

@@ -0,0 +1,71 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: ${CLOUDFLARED_TUNNEL_NAME}-app
+    restart: unless-stopped
+    ports:
+      - "3000:${PORT:-3000}"
+    environment:
+      NODE_ENV: production
+      APP_ENV: production
+      HOST: 0.0.0.0
+      PORT: ${PORT:-3000}
+      DATABASE_PROVIDER: ${DATABASE_PROVIDER:-sqlite}
+      DATABASE_URL: ${DATABASE_URL:-/app/data/stats.db}
+      CLOUDFLARE_ACCOUNT_ID: ${CLOUDFLARE_ACCOUNT_ID:-}
+      CLOUDFLARE_D1_DATABASE_ID: ${CLOUDFLARE_D1_DATABASE_ID:-}
+      CLOUDFLARE_D1_TOKEN: ${CLOUDFLARE_D1_TOKEN:-}
+      REDIS_ENABLED: "true"
+      REDIS_HOST: redis
+      REDIS_PORT: 6379
+      GITHUB_TOKEN: ${GITHUB_TOKEN:-}
+    volumes:
+      - app-data:/app/data
+    depends_on:
+      redis:
+        condition: service_healthy
+    healthcheck:
+      test:
+        - CMD
+        - node
+        - -e
+        - fetch(`http://127.0.0.1:${PORT:-3000}/health`).then((response)=>process.exit(response.ok?0:1)).catch(()=>process.exit(1))
+      interval: 30s
+      timeout: 10s
+      retries: 5
+      start_period: 20s
+
+  redis:
+    image: redis:7-alpine
+    container_name: ${CLOUDFLARED_TUNNEL_NAME}-redis
+    restart: unless-stopped
+    command: ["redis-server", "--appendonly", "yes"]
+    volumes:
+      - redis-data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  cloudflared:
+    image: cloudflare/cloudflared:latest
+    container_name: ${CLOUDFLARED_TUNNEL_NAME}-cloudflared
+    restart: unless-stopped
+    network_mode: "service:app"
+    depends_on:
+      app:
+        condition: service_healthy
+    environment:
+      TUNNEL_TOKEN: ${CLOUDFLARED_TUNNEL_TOKEN:?Set CLOUDFLARED_TUNNEL_TOKEN in .env}
+    command:
+      - tunnel
+      - --no-autoupdate
+      - run
+      - ${CLOUDFLARED_TUNNEL_NAME}
+
+volumes:
+  app-data:
+  redis-data:

docs/docker-build.md

@@ -15,6 +15,12 @@ Build:
 docker build -f Dockerfile -t github-stats:node .
 ```
 
+Compose:
+
+```bash
+docker compose up --build
+```
+
 Run:
 
 ```bash
@@ -45,12 +51,24 @@ View logs:
 docker logs -f github-stats
 ```
 
+Compose logs:
+
+```bash
+docker compose logs -f
+```
+
 Stop and remove:
 
 ```bash
 docker rm -f github-stats
 ```
 
+Compose stop:
+
+```bash
+docker compose down
+```
+
 ## Important Environment Variables
 
 Defaults are defined in `src/shared/config/env.ts`, so the app can run with minimal configuration. Recommended variables for production:
@@ -129,6 +147,19 @@ docker compose pull
 docker compose up -d --force-recreate
 ```
 
+The repository includes a `compose.yaml` for local development and self-hosting. It starts:
+
+- `app`: the Node.js API built from the local `Dockerfile`
+- `redis`: a local Redis 7 instance for cache storage
+
+The compose setup also forces local-safe defaults that differ from the Cloudflare deployment path:
+
+- `DATABASE_PROVIDER=sqlite`
+- `DATABASE_URL=/app/data/stats.db`
+- `REDIS_HOST=redis`
+
+If you have a `.env` file with a `GITHUB_TOKEN`, Docker Compose will pass it through to the app container.
+
 ## Notes
 
 - `.dockerignore` excludes common local artifacts (`node_modules`, `dist`, `.git`, `.env`, and more) to keep build context small.

src/shared/config/db.ts

@@ -12,6 +12,48 @@ let dbInstance: unknown | null = null;
 let cloudflareDbInstance: ReturnType<typeof drizzleProxy> | null = null;
 let sqliteInstance: import('better-sqlite3').Database | null = null;
 
+function ensureSqliteSchema(db: import('better-sqlite3').Database): void {
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS stats_requests (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            username TEXT NOT NULL,
+            url TEXT NOT NULL,
+            created_at INTEGER
+        );
+
+        CREATE UNIQUE INDEX IF NOT EXISTS uq_stats_request_url
+        ON stats_requests (url);
+
+        CREATE TABLE IF NOT EXISTS visitor_logs (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            username TEXT NOT NULL,
+            ip_hash TEXT NOT NULL,
+            visit_date TEXT NOT NULL,
+            created_at INTEGER
+        );
+
+        CREATE UNIQUE INDEX IF NOT EXISTS uq_visitor_log
+        ON visitor_logs (username, ip_hash, visit_date);
+
+        CREATE TABLE IF NOT EXISTS badges (
+            username TEXT PRIMARY KEY,
+            visitors INTEGER NOT NULL DEFAULT 0,
+            repositories INTEGER,
+            organization INTEGER,
+            languages INTEGER,
+            followers INTEGER,
+            total_stars INTEGER,
+            total_contributors INTEGER,
+            total_commits INTEGER,
+            total_code_reviews INTEGER,
+            total_issues INTEGER,
+            total_pull_requests INTEGER,
+            total_joined_years INTEGER,
+            updated_at INTEGER
+        );
+    `);
+}
+
 function getRequiredCloudflareConfig() {
     const env = getEnv();
     const accountId = env.CLOUDFLARE_ACCOUNT_ID;
@@ -142,11 +184,11 @@ export function initializeDatabase() {
 
         return cloudflareDbInstance;
     }
-    
+
     if (!sqliteInstance) {
         throw new Error('SQLite initialization must use initializeDatabaseAsync()');
     }
-    
+
     return dbInstance;
 }
 
@@ -171,19 +213,20 @@ export async function initializeDatabaseAsync() {
 
         const Database = sqliteModule.default;
         sqliteInstance = new Database(env.DATABASE_URL);
-        
+
         // Enable WAL mode for better concurrent access
         sqliteInstance.pragma('journal_mode = WAL');
-        
+        ensureSqliteSchema(sqliteInstance);
+
         // Initialize Drizzle ORM
         dbInstance = drizzle(sqliteInstance, { schema });
 
         // Populate the shared db proxy so service imports work on the Node.js path
         setDb(dbInstance as any);
-        
+
         console.log(`✅ Database connected: ${env.DATABASE_URL}`);
     }
-    
+
     return dbInstance;
 }