FAA.ZONE™

Meeting Overview

Date: June 22, 2025

Attendees: Gemini (AI), Heyns (User)

Purpose: Document the initial Firebase project setup, including Authentication and Cloud Firestore, which form the core backend for the Seedwave Admin Panel.

Seedwave Admin Panel Application Context

Overview of the core application relevant to Firebase setup.

• Application Name: Seedwave Admin Panel
• Deployment URL: https://seedwave.faa.zone/admin_panel_xero.html
• Hosting Platform: Git Pages
• Core Technologies: HTML, JavaScript, Tailwind CSS.
• Integrated Services: Firebase (Authentication, Firestore), Google Analytics, Xero (via OAuth 2.0 API).

Firebase Project Setup: "FAA Nexus"

Detailed steps for setting up the foundational Firebase project.

• Project Name: FAA Nexus
• Firebase Console URL: https://console.firebase.google.com/project/faa-nexus/overview
• Firebase SDK Version Used in Code: `11.9.1`
• Firebase Project ID (`appId`): `faa-nexus`

Live Firebase Configuration Snippet (from `admin_panel_xero.html`):

const firebaseConfig = {
    apiKey: "AIzaSyCR3mbgoiiCkRyaAm5BSWBWBFwut0MDCW8",
    authDomain: "faa-nexus.firebaseapp.com",
    projectId: "faa-nexus",
    storageBucket: "faa-nexus.firebasestorage.app",
    messagingSenderId: "459816542686",
    appId: "1:459816542686:web:7fc0596fb70e2e6b753d4f",
    measurementId: "G-S4ZB8QV782"
};

Firebase Authentication Setup

Configuration of user identity within Firebase Auth.

• Purpose: Provides user identity solution for the admin panel, enabling anonymous sign-in for Firestore access.
• Provider Enabled: Anonymous (as the initial sign-in method to store Xero tokens).
• Console Path for Authentication Methods: Firebase Console -> Build -> Authentication -> Sign-in method.

Client-Side Authentication Code Snippet (from `admin_panel_xero.html`):

import { getAuth, signInAnonymously, onAuthStateChanged, signOut } from "https://www.gstatic.com/firebasejs/11.9.1/firebase-auth.js";
// ... initialization code
const auth = getAuth(app);

// Authenticate with Firebase
window.firebaseAuth = async function() {
    try {
        await signInAnonymously(auth); // Currently using anonymous sign-in
        console.log("Firebase authentication successful.");
    } catch (error) {
        console.error("Firebase authentication failed:", error);
        window.showMessageBox("Failed to authenticate with Firebase. Check console for details.", "error");
    }
};

// Listen for auth state changes
onAuthStateChanged(auth, (user) => {
    if (user) { /* User is signed in */ }
    else { /* User is signed out */ }
});

// Logout function
window.logout = async function() { await signOut(auth); };

Cloud Firestore Setup

Configuration of the Firestore database for data storage.

• Purpose: Real-time NoSQL database used for securely storing user-specific Xero access and refresh tokens.
• Database Creation: Initiated in "Production Mode."
• Console Path for Firestore: Firebase Console -> Build -> Firestore Database.
• Data Path for Xero Tokens: `/artifacts/{appId}/users/{userId}/xeroTokens/xero_oauth`

Cloud Firestore Security Rules Snippet (from Firebase Console Rules Tab):

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /artifacts/{appId}/users/{userId}/xeroTokens/{document=**} {
      allow read, write: if request.auth != null && request.auth.uid == userId;
    }
  }
}

Client-Side Firestore Interaction Snippet (from `admin_panel_xero.html` for Xero Tokens):

import { getFirestore, doc, setDoc, getDoc } from "https://www.gstatic.com/firebasejs/11.9.1/firebase-firestore.js";
// ... initialization code
const db = getFirestore(app);

// Function to save Xero tokens to Firestore
window.saveXeroTokens = async function(userId, tokens) {
    await setDoc(doc(db, `artifacts/${appId}/users/${userId}/xeroTokens/xero_oauth`), tokens);
};

// Function to load Xero tokens from Firestore
window.loadXeroTokens = async function(userId) {
    const docRef = doc(db, `artifacts/${appId}/users/${userId}/xeroTokens/xero_oauth`);
    const docSnap = await getDoc(docRef);
    if (docSnap.exists()) { return docSnap.data(); }
    return null;
};

Firebase Hosting Setup

Configuration for deploying the Seedwave Admin Panel web application.

• Purpose: Used to deploy the `admin_panel_xero.html` web application.
• Deployment URL: https://seedwave.faa.zone/admin_panel_xero.html
• Console Path for Hosting: Firebase Console -> Build -> Hosting
• **Current Deployment Method:** Git Pages (Firebase Hosting is a viable alternative for future direct deployment).

Google Analytics Integration

Setup for tracking application usage.

• Purpose: Provides insights into application usage and user behavior via Google Analytics 4 (GA4).
• Measurement ID: `G-S4ZB8QV782`
• Console Path: Google Analytics Console

GA4 Tracking Code Snippet (in `admin_panel_xero.html` ``):

<script async src="https://www.googletagmanager.com/gtag/js?id=G-S4ZB8QV782"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-S4ZB8QV782');
</script>

Detailed Troubleshooting & Resolutions (Firebase Specific)

Record of Firebase-related issues encountered and their resolutions.

• **Initial Javascript Errors (`Uncaught ReferenceError: loadContent is not defined`):**
  • **Cause:** Functions defined inside `