cleanup and changes to GA

Author: TimLFletcher

.env.local.example

@@ -0,0 +1,18 @@
+# Local Environment Variables
+# This file is for local development only and will NOT be committed to git
+# Copy this file to .env.local and fill in your actual credentials
+
+# Google Analytics 4 Configuration
+GA_PROPERTY_ID=your-ga4-property-id-here
+GOOGLE_SERVICE_ACCOUNT_KEY={"type":"service_account","project_id":"your-project-id","private_key":"-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY_HERE\n-----END PRIVATE KEY-----\n","client_email":"your-service-account@your-project-id.iam.gserviceaccount.com"}
+
+# JIRA Configuration  
+JIRA_BASE_URL=https://your-domain.atlassian.net
+JIRA_USERNAME=your-email@company.com
+JIRA_API_TOKEN=your-jira-api-token-here
+
+# OpenAI Configuration (optional)
+OPENAI_API_KEY=your-openai-api-key-here
+
+# Site Password
+SITE_PASS=docsdash2024

LOCAL_TESTING.md

@@ -0,0 +1,57 @@
+# Local Testing Setup
+
+This allows you to test the actual data fetching mechanism locally with real credentials.
+
+## Quick Setup
+
+1. **Copy the template:**
+   ```bash
+   cp .env.local.example .env.local
+   ```
+
+2. **Edit .env.local with your real credentials:**
+   ```env
+   # Google Analytics 4
+   GA_PROPERTY_ID=your-actual-ga4-property-id
+   GOOGLE_SERVICE_ACCOUNT_KEY={"type":"service_account","project_id":"your-project",...}
+
+   # JIRA
+   JIRA_BASE_URL=https://your-domain.atlassian.net
+   JIRA_USERNAME=your-email@company.com
+   JIRA_API_TOKEN=your-actual-jira-api-token
+
+   # OpenAI (optional)
+   OPENAI_API_KEY=your-openai-api-key
+
+   # Site Password
+   SITE_PASS=docsdash2024
+   ```
+
+3. **Test the fetch:**
+   ```bash
+   npm run fetch-data
+   ```
+
+4. **Start development server:**
+   ```bash
+   npm run dev
+   ```
+
+## How It Works
+
+- **Local Development**: Uses credentials from `.env.local` file
+- **GitHub Actions**: Uses credentials from GitHub secrets
+- **No Sample Data**: Tests actual API calls and data fetching
+- **Secure**: `.env.local` is ignored by git and won't be committed
+
+## Files
+
+- `.env.local.example` - Template with placeholder values
+- `.env.local` - Your actual credentials (create this, don't commit)
+- Scripts automatically load `.env.local` if it exists
+
+## Notes
+
+- The `.env.local` file is in `.gitignore` so it won't be committed
+- If `.env.local` doesn't exist, scripts fall back to environment variables
+- This tests the exact same fetch mechanism used in production

README.md

@@ -184,18 +184,6 @@ Add the new data to `src/data/sample-data.json` and update `scripts/fetch-data.j
 | `RecentIssuesTable` | Table with status badges |
 | `TrafficSourcesChart` | Pie chart |
 
-## AI Assistant
-
-The AI assistant uses OpenAI's API to provide insights. Users provide their own API key, which is stored in their browser's localStorage (never sent to your servers).
-
-### Customizing the AI Context
-
-Edit the `buildContext()` function in `src/components/AIAssistant.jsx` to change what data is sent to the AI.
-
-### Using a Different LLM
-
-Replace the OpenAI API call with any other provider (Anthropic, Google, etc.) by modifying the `sendMessage()` function.
-
 ## Data Refresh Schedule
 
 The GitHub Action runs every 6 hours by default. To change this, edit `.github/workflows/fetch-and-deploy.yml`:
@@ -221,7 +209,6 @@ docsdash/
 ├── src/
 │   ├── components/
 │   │   ├── charts/                 # Chart components
-│   │   ├── AIAssistant.jsx         # LLM integration
 │   │   ├── ChartCard.jsx           # Chart wrapper
 │   │   └── MetricCard.jsx          # Metric display
 │   ├── data/

package-lock.json

@@ -12,6 +12,7 @@
   },
   "dependencies": {
     "@google-analytics/data": "^5.2.1",
+    "dotenv": "^17.2.3",
     "express": "^4.18.2",
     "google-trends-api": "^4.9.2",
     "lucide-react": "^0.303.0",

package.json

@@ -10,9 +10,27 @@
  * Required Environment Variables:
  * - GA_PROPERTY_ID: Google Analytics 4 property ID
  * - GOOGLE_SERVICE_ACCOUNT_KEY: JSON key for GCP service account
+ * 
+ * Local Development:
+ * Create .env.local file with your credentials (won't be committed to git)
  */
 
-// Check if we're in a CI environment with real credentials
+// Load environment variables from .env.local for local development
+import { config } from 'dotenv'
+import { fileURLToPath } from 'url'
+import { dirname, join } from 'path'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+// Try to load .env.local first (for local development)
+try {
+  config({ path: join(__dirname, '../.env.local') })
+} catch (error) {
+  // .env.local doesn't exist, will use environment variables (GitHub Actions)
+}
+
+// Check if we have credentials (either from .env.local or environment)
 const hasGACredentials = process.env.GA_PROPERTY_ID && process.env.GOOGLE_SERVICE_ACCOUNT_KEY
 
 export async function fetchGoogleAnalyticsData() {

scripts/ai-assistant-api.js

@@ -1,5 +1,5 @@
 /**
- * Fetch Jira Data
+ * Fetch JIRA Data
  * 
  * Uses the Jira REST API to fetch:
  * - Open issues by priority
@@ -13,9 +13,27 @@
  * - JIRA_EMAIL: Jira account email
  * - JIRA_API_TOKEN: Jira API token
  * - JIRA_PROJECT_KEY: Jira project key (e.g., DOC)
+ * 
+ * Local Development:
+ * Create .env.local file with your credentials (won't be committed to git)
  */
 
-// Check if we're in a CI environment with real credentials
+// Load environment variables from .env.local for local development
+import { config } from 'dotenv'
+import { fileURLToPath } from 'url'
+import { dirname, join } from 'path'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+// Try to load .env.local first (for local development)
+try {
+  config({ path: join(__dirname, '.env.local') })
+} catch (error) {
+  // .env.local doesn't exist, will use environment variables (GitHub Actions)
+}
+
+// Check if we have credentials (either from .env.local or environment)
 const hasJiraCredentials = process.env.JIRA_BASE_URL && process.env.JIRA_EMAIL && process.env.JIRA_API_TOKEN
 
 export async function fetchJiraData() {

scripts/fetch-ga.js

@@ -7,7 +7,6 @@ import express from 'express'
 import { fileURLToPath } from 'url'
 import { dirname, join } from 'path'
 import insightsHandler from './scripts/insights-api.js'
-import aiAssistantHandler from './scripts/ai-assistant-api.js'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
@@ -33,16 +32,12 @@ app.use((req, res, next) => {
 // Insights API endpoint
 app.post('/api/insights', insightsHandler)
 
-// AI Assistant API endpoint
-app.post('/api/ai-assistant', aiAssistantHandler)
-
 // Serve static files from public directory
 app.use(express.static(join(__dirname, 'public')))
 
 // Start server
 app.listen(PORT, () => {
   console.log(`🚀 API server running on http://localhost:${PORT}`)
   console.log(`📊 Insights endpoint available at http://localhost:${PORT}/api/insights`)
-  console.log(`🤖 AI Assistant endpoint available at http://localhost:${PORT}/api/ai-assistant`)
   console.log(`🔑 Using OPENAI_API_KEY from environment: ${process.env.OPENAI_API_KEY ? '✅' : '❌ Not set'}`)
 })