Merge all open feature branches + admin whitelist management

.github/workflows/ci.yml

@@ -9,7 +9,7 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v3
         with:
-          node-version: 16
+          node-version: 18
       - name: Use Yarn Cache
         uses: actions/cache@v3
         with:

.github/workflows/firebase-hosting-merge.yml

@@ -12,6 +12,10 @@ jobs:
     environment: prod
     steps:
       - uses: actions/checkout@v2
+      - name: Set up Node
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18
       - run: yarn install
       - run: yarn workspace frontend build
         env:

.github/workflows/firebase-hosting-pull-request.yml

@@ -12,7 +12,7 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v3
         with:
-          node-version: 16
+          node-version: 18
       - run: yarn install
       - run: yarn workspace frontend build
         env:

.gitignore

@@ -57,6 +57,11 @@ yarn-error.log*
 *.code-workspace
 **/.idea
 
+# Local reference files (not for repo)
+TODO.md
+DOCS_GUIDE.md
+BLOG_TODO.md
+
 # Misc
 .DS_Store
 .env

backend/package.json

@@ -7,6 +7,10 @@
     "add_buildings": "ts-node scripts/add_buildings.ts",
     "add_landlords": "ts-node scripts/add_landlords.ts",
     "add_reviews": "ts-node scripts/add_reviews_nodups.ts",
+    "export_apartments": "env-cmd -f ../.env.prod ts-node scripts/export_apartments.ts",
+    "update_apartments": "env-cmd -f ../.env.prod ts-node scripts/update_apartments_from_csv.ts",
+    "export_apartment_names": "ts-node scripts/export_apartment_names.ts",
+    "init_blogposts": "env-cmd -f ../.env.prod ts-node scripts/init_blogposts_collection.ts",
     "build": "tsc",
     "tsc": "tsc",
     "start": "node dist/backend/src/server.js",

backend/scripts/add_buildings.ts

@@ -43,13 +43,11 @@ const formatBuilding = ({
   name,
   address,
   landlordId: landlordId.toString(),
-  numBaths: 0,
-  numBeds: 0,
+  roomTypes: [], // Initialize with empty room types
   photos: [],
   area: getAreaType(area),
   latitude,
   longitude,
-  price: 0,
   distanceToCampus: 0,
 });
 

backend/scripts/export_apartment_names.ts

@@ -0,0 +1,89 @@
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+
+// Define the structure of the API response based on the AdminPage usage
+interface ApartmentData {
+  buildingData: {
+    id: string;
+    name: string;
+    address: string;
+    area: string;
+    numBeds: number;
+    numBaths: number;
+    landlordId: string;
+    photos: string[];
+    urlName: string;
+    latitude: number;
+    longitude: number;
+    distanceToCampus: number;
+  };
+  numReviews: number;
+  company: string;
+  avgRating: number;
+  avgPrice: number;
+}
+
+interface ApiResponse {
+  buildingData: ApartmentData[];
+  isEnded: boolean;
+}
+
+/**
+ * Script to export apartment names to a CSV file
+ *
+ * This script fetches all apartment data from the API endpoint used in AdminPage
+ * and exports just the apartment names to a CSV file.
+ */
+const exportApartmentNames = async () => {
+  try {
+    console.log('Fetching apartment data...');
+
+    // Use the same API endpoint as AdminPage
+    const response = await axios.get<ApiResponse>(
+      'http://localhost:8080/api/page-data/home/1000/numReviews'
+    );
+
+    if (!response.data || !response.data.buildingData) {
+      throw new Error('No apartment data received from API');
+    }
+
+    const apartments = response.data.buildingData;
+    console.log(`Found ${apartments.length} apartments`);
+
+    // Extract apartment names
+    const apartmentNames = apartments.map((apt) => apt.buildingData.name);
+
+    // Create CSV content
+    const csvHeader = 'Apartment Name\n';
+    const csvContent = apartmentNames.map((name) => `"${name}"`).join('\n');
+    const fullCsvContent = csvHeader + csvContent;
+
+    // Write to CSV file
+    const outputPath = path.join(__dirname, 'apartment_names.csv');
+    fs.writeFileSync(outputPath, fullCsvContent, 'utf8');
+
+    console.log(`Successfully exported ${apartmentNames.length} apartment names to: ${outputPath}`);
+    console.log('First few apartment names:');
+    apartmentNames.slice(0, 5).forEach((name, index) => {
+      console.log(`${index + 1}. ${name}`);
+    });
+  } catch (error) {
+    console.error('Error exporting apartment names:', error);
+
+    if (axios.isAxiosError(error)) {
+      if (error.code === 'ECONNREFUSED') {
+        console.error(
+          'Could not connect to the server. Make sure the backend server is running on localhost:3000'
+        );
+      } else {
+        console.error('API request failed:', error.message);
+      }
+    }
+
+    process.exit(1);
+  }
+};
+
+// Run the script
+exportApartmentNames();

backend/scripts/export_apartments.ts

@@ -0,0 +1,101 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { db } from '../src/firebase-config';
+
+/**
+ * export_apartments.ts
+ *
+ * Exports all apartment documents from Firestore to a CSV file.
+ * The business team can then edit the CSV and pass it to update_apartments_from_csv.ts.
+ *
+ * Usage:
+ *   env-cmd -f ../.env.prod ts-node scripts/export_apartments.ts
+ *
+ * Output:
+ *   backend/scripts/apartments_export.csv
+ */
+
+const buildingCollection = db.collection('buildings');
+
+// TODO: might have to change header fields or order (talk with business)
+const CSV_HEADERS = [
+  'id',
+  'name',
+  'address',
+  'landlordId',
+  'numBeds',
+  'numBaths',
+  'price',
+  'area',
+  'latitude',
+  'longitude',
+  'distanceToCampus',
+];
+
+// escape CSV field values
+export const escapeCSVField = (value: unknown): string => {
+  const str = value === null || value === undefined ? '' : String(value);
+  if (str.includes(',') || str.includes('"') || str.includes('\n')) {
+    return `"${str.replace(/"/g, '""')}"`;
+  }
+  return str;
+};
+
+const exportApartments = async () => {
+  console.log('Fetching apartments from Firestore...');
+
+  const snapshot = await buildingCollection.get();
+
+  if (snapshot.empty) {
+    console.log('No apartments found in the database.');
+    process.exit(0);
+  }
+
+  console.log(`Found ${snapshot.docs.length} apartments. Writing CSV...`);
+
+  const rows: string[] = [CSV_HEADERS.join(',')];
+
+  snapshot.docs.forEach((doc) => {
+    const data = doc.data();
+    const row = [
+      doc.id,
+      data.name,
+      data.address,
+      data.landlordId,
+      data.numBeds,
+      data.numBaths,
+      data.price,
+      data.area,
+      data.latitude,
+      data.longitude,
+      data.distanceToCampus,
+    ]
+      .map(escapeCSVField)
+      .join(',');
+
+    rows.push(row);
+  });
+
+  const outputPath = path.join(__dirname, 'apartments_export.csv');
+  fs.writeFileSync(outputPath, rows.join('\n'), 'utf8');
+
+  console.log(`Export complete: ${outputPath}`);
+  console.log(`   ${snapshot.docs.length} apartments exported.`);
+  console.log('');
+  console.log('Next steps:');
+  console.log('  1. Open apartments_export.csv in Excel or Google Sheets');
+  console.log('  2. Edit the fields you want to update (do NOT change the id column)');
+  console.log('  3. Save as CSV');
+  console.log('  4. Run: env-cmd -f ../.env.prod ts-node scripts/update_apartments_from_csv.ts');
+
+  process.exit(0);
+};
+
+if (require.main === module) {
+  exportApartments().catch((err) => {
+    console.error('Export failed:', err);
+    process.exit(1);
+  });
+}
+
+export default exportApartments;

backend/scripts/init_blogposts_collection.ts

@@ -0,0 +1,61 @@
+/**
+ * init_blogposts_collection.ts
+ *
+ * One-time idempotent script to ensure the `blogposts` Firestore collection exists
+ * with the correct schema. Creates a sentinel document if the collection is empty.
+ *
+ * Safe to run multiple times — never overwrites existing documents.
+ *
+ * Usage: ts-node scripts/init_blogposts_collection.ts
+ */
+
+import { db } from '../src/firebase-config';
+
+const blogPostCollection = db.collection('blogposts');
+
+const initBlogPostsCollection = async (): Promise<void> => {
+  console.log('Checking blogposts collection...');
+
+  const snapshot = await blogPostCollection.limit(1).get();
+
+  if (!snapshot.empty) {
+    console.log(`Collection already has ${snapshot.size}+ document(s). No initialization needed.`);
+    return;
+  }
+
+  console.log('Collection is empty. Creating sentinel document...');
+
+  const sentinelDoc = blogPostCollection.doc('_init');
+  const existing = await sentinelDoc.get();
+
+  if (existing.exists) {
+    console.log('Sentinel document already exists. Done.');
+    return;
+  }
+
+  await sentinelDoc.set({
+    title: '[INIT] Collection initialized',
+    content: '',
+    blurb: '',
+    date: new Date(),
+    tags: [],
+    visibility: 'DELETED',
+    likes: 0,
+    saves: 0,
+    coverImageUrl: '',
+    userId: null,
+  });
+
+  console.log('Sentinel document created at blogposts/_init with visibility=DELETED.');
+  console.log('Collection is ready. This sentinel document is safe to delete.');
+};
+
+initBlogPostsCollection()
+  .then(() => {
+    console.log('Done.');
+    process.exit(0);
+  })
+  .catch((err) => {
+    console.error('Error initializing blogposts collection:', err);
+    process.exit(1);
+  });