fixed the bugs and edited some content

Author: shadil-rayyan

docs/architecture/technology.md

@@ -1,7 +1,4 @@
-Below is a **clean, corrected, and professional version** of your document with the **Analytics** and **Security tooling (Snyk + Dependabot)** sections properly added.
-I’ve kept the tone suitable for **2025, a student-driven volunteer project**, and something you can confidently include in **reports, approvals, and resumes**.
 
----
 
 # 🧱 Technology Stack & Rationale
 

…community.md/ contribution-guidelines.md …cs/community/ contribution-guidelines.mddocs/community.md/ contribution-guidelines.md renamed to docs/community/ contribution-guidelines.md docs/community.md/ contribution-guidelines.md renamed to docs/community/ contribution-guidelines.md

@@ -12,14 +12,4 @@ Gecian Hub exists to ensure that no student feels left behind due to lack of inf
 **Our vision is to create a connected, tech-enabled student community where every student has equal access to opportunities, resources, and collaboration.**
 We aim to transform traditional college experiences by introducing modern digital solutions, encouraging innovation, and ensuring that no student ever feels their institution is outdated or lacking in technological support.
 
----
-
-### ✨ Short & Simple Version ()
-
-**Mission:**
-To help students succeed by centralizing college resources, improving communication, and making campus life more efficient through technology.
-
-**Vision:**
-A future where every student is digitally empowered, well-informed, and confident that their college supports innovation and modern learning.
-
 

docs/community.md/community.md docs/community/community-guidelines.mddocs/community.md/community.md renamed to docs/community/community-guidelines.md

@@ -1,13 +1,11 @@
-# ===============================
 # Database Configuration
-# ===============================
+
 DATABASE_URL="postgresql://USERNAME:PASSWORD@HOST:PORT/DATABASE?sslmode=require"
 
 
-# ===============================
+
 # Firebase Client Configuration
-# (Public – used in frontend)
-# ===============================
+
 NEXT_PUBLIC_FIREBASE_API_KEY="your_firebase_api_key"
 NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN="your_project_id.firebaseapp.com"
 NEXT_PUBLIC_FIREBASE_PROJECT_ID="your_project_id"
@@ -16,15 +14,8 @@ NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID="your_messaging_sender_id"
 NEXT_PUBLIC_FIREBASE_APP_ID="your_app_id"
 
 
-# ===============================
 # Firebase Admin SDK (Server Only)
-# ❌ NEVER expose to frontend
-# ❌ NEVER commit real values
-# ===============================
-
-
 
-# Option 2 (ONLY if platform requires single var)
 FIREBASE_ADMIN_SDK_KEY='{
   "type": "service_account",
   "project_id": "your_project_id",

docs/community.md/why-contribute.md docs/community/why-contribute.mddocs/community.md/why-contribute.md renamed to docs/community/why-contribute.md

@@ -1,23 +1,22 @@
 
-
 # 🔥 Firebase Setup & Admin Access Documentation
 
 This document explains how to:
 
 1. Obtain Firebase **client (public) configuration**
 2. Obtain Firebase **Admin SDK credentials**
 3. Securely store environment variables
-4. Manually bootstrap the **first admin user** in Firestore
+4. Manually bootstrap the **first admin user**
 5. Define the required Firestore collections and structure
 
 ---
 
 ## 1️⃣ Create a Firebase Project
 
-1. Go to **Firebase Console**
-   👉 [https://console.firebase.google.com](https://console.firebase.google.com)
+1. Go to the Firebase Console  
+   https://console.firebase.google.com
 2. Click **Add Project**
-3. Enter project name (e.g. `gecian-hub`)
+3. Enter a project name (e.g. `gecian-hub`)
 4. Disable Google Analytics (optional)
 5. Click **Create Project**
 
@@ -31,11 +30,11 @@ These values are used on the **frontend (Next.js)**.
 
 1. Firebase Console → **Project Settings**
 2. Scroll to **Your Apps**
-3. Click **Add App → Web (</>)**
+3. Click **Add App → Web**
 4. Register the app
 5. Copy the generated config
 
-Example:
+### Example
 
 ```js
 const firebaseConfig = {
@@ -46,11 +45,11 @@ const firebaseConfig = {
   messagingSenderId: "1234567890",
   appId: "1:1234567890:web:abcdef"
 };
-```
+````
 
 ---
 
-### ✅ Environment Variables (Client)
+## 3️⃣ Client Environment Variables
 
 ```env
 NEXT_PUBLIC_FIREBASE_API_KEY=AIza...
@@ -61,32 +60,32 @@ NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=1234567890
 NEXT_PUBLIC_FIREBASE_APP_ID=1:1234567890:web:abcdef
 ```
 
-🔐 These are **public by design** and safe to expose.
+> 🔐 These values are **public by design** and safe to expose.
 
 ---
 
-## 3️⃣ Enable Required Firebase Services
+## 4️⃣ Enable Required Firebase Services
 
 ### Authentication
 
-* Enable **Email/Password**
+* Enable **Email / Password**
 * Optional: Google Sign-In
 
 ### Firestore
 
 * Create Firestore database
 * Start in **Production Mode**
-* Choose correct region
+* Choose the correct region
 
 ---
 
-## 4️⃣ Firebase Admin SDK (Server-Side – SECRET)
+## 5️⃣ Firebase Admin SDK (Server Side – SECRET)
 
-The **Admin SDK is REQUIRED** for:
+The Admin SDK is required for:
 
 * Admin management
-* Firestore writes bypassing rules
-* Secure backend APIs
+* Secure Firestore writes
+* Backend-only APIs
 
 ### Steps
 
@@ -95,69 +94,54 @@ The **Admin SDK is REQUIRED** for:
 3. Click **Generate new private key**
 4. Download the JSON file
 
-Example:
-
-```json
-{
-  "type": "service_account",
-  "project_id": "project-id",
-  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
-  "client_email": "firebase-adminsdk@project-id.iam.gserviceaccount.com"
-}
-```
-
 ---
 
-## 5️⃣ Storing Firebase Admin Credentials 
-
+## 6️⃣ Storing Firebase Admin Credentials (Recommended)
 
-### : FULL Admin SDK JSON (ONLY if needed)
+### Option A: Individual Environment Variables (Best)
 
 ```env
-FIREBASE_ADMIN_SDK_KEY='{
-  "type": "service_account",
-  "project_id": "project-id",
-  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
-  "client_email": "firebase-adminsdk@project-id.iam.gserviceaccount.com"
-}'
+FIREBASE_PROJECT_ID=project-id
+FIREBASE_CLIENT_EMAIL=firebase-adminsdk@project-id.iam.gserviceaccount.com
+FIREBASE_PRIVATE_KEY=-----BEGIN_PRIVATE_KEY-----\n...\n-----END_PRIVATE_KEY-----
 ```
 
-
+> ✅ This avoids multiline parsing issues and is production-safe.
 
 ---
 
-## 6️⃣ Firestore Admin Bootstrap (CRITICAL)
+## 7️⃣ Firestore Admin Bootstrap (Critical)
 
-Since no admin exists initially, **the first admin MUST be added manually** from the Firebase Console.
+Since no admin exists initially, the **first admin must be added manually**.
 
 ---
 
-## 7️⃣ ✅ CORRECT Firestore Collection Structure
+## 8️⃣ Firestore Collection Structure
 
-### ✔ YES — THIS STRUCTURE IS CORRECT
+### Correct Structure
 
 ```text
 adminemail (collection)
-├── {autoDocId}
-│   ├── email: string
-│   ├── role: "admin" or "superadmin"
-│   ├── addedBy: string
-│   ├── timestamp: Timestamp
+└── auto-generated-doc-id
+    ├── email: string
+    ├── role: "admin" | "superadmin"
+    ├── addedBy: string
+    └── timestamp: timestamp
 ```
 
-### 🔴 Important Notes
+### Important Notes
 
-* **Document ID should be Auto-ID**
-* Do **NOT** use email as document ID (causes problems later)
+* Use **Auto-ID** for documents
+* Do **NOT** use email as document ID
 * `role` must be controlled by backend only
 
 ---
 
-## 8️⃣ Manually Add First Admin (Bootstrap)
+## 9️⃣ Add First Admin Manually
 
 ### Steps
 
-1. Firebase Console → **Firestore Database**
+1. Firebase Console → Firestore Database
 2. Click **Start Collection**
 3. Collection ID: `adminemail`
 4. Document ID: **Auto-ID**
@@ -166,28 +150,29 @@ adminemail (collection)
 
 | Field     | Type      | Value                                                                 |
 | --------- | --------- | --------------------------------------------------------------------- |
-| email     | string    | [musthafalmukthar907@gmail.com]| role      | string    | admin                                                                 |
-| addedBy   | string    | emailid                                                                |
+| email     | string    | [musthafalmukthar907@gmail.com](mailto:musthafalmukthar907@gmail.com) |
+| role      | string    | admin                                                                 |
+| addedBy   | string    | system                                                                |
 | timestamp | timestamp | current time                                                          |
 
-✅ This user is now the **initial system admin**
+✅ This user is now the initial system admin.
 
 ---
 
-## 9️⃣ Example Admin Document
+## 10️⃣ Example Admin Document
 
 ```json
 {
   "email": "psabhidram5600@gmail.com",
   "role": "admin",
-  "addedBy": "psabhidram5000@gmail.com",
+  "addedBy": "system",
   "timestamp": "2025-09-04T11:51:19Z"
 }
 ```
 
 ---
 
-## 🔐 Security Rules (Recommended)
+## 🔐 Recommended Firestore Security Rules
 
 ```js
 rules_version = '2';
@@ -196,7 +181,7 @@ service cloud.firestore {
 
     match /adminemail/{doc} {
       allow read: if request.auth != null;
-      allow write: if false; // Admin SDK only
+      allow write: if false;
     }
 
     match /{document=**} {
@@ -205,4 +190,3 @@ service cloud.firestore {
     }
   }
 }
-```

docs/introduction/mission.md

@@ -1,9 +1,3 @@
-Got it 👍
-You want **pure Markdown**, **no `.sh` file**, **just copy-paste terminal commands** that contributors can run step by step.
-
-Below is a **clean, strict, copy-paste–friendly MkDocs section**.
-
----
 
 # 🚀 Gecian Hub – Complete Local Setup (Copy-Paste Ready)
 

docs/community.md/hackeroctoberfest.md docs/organization/hackeroctoberfest.mddocs/community.md/hackeroctoberfest.md renamed to docs/organization/hackeroctoberfest.md

@@ -81,6 +81,7 @@
   * GitHub activity
   * Google Forms
   * Official email inbox
+  * Google analytics 
 * Ask seniors or previous leads if unsure—**no guesswork**.
 
 ---