Dev

.env.example

@@ -197,4 +197,7 @@ NEXT_PUBLIC_APPWRITE_BYOB_TENANTS_ID=byob_tenants
 # -- Storage Buckets --
 NEXT_PUBLIC_APPWRITE_IMAGES_BUCKET_ID=images
 NEXT_PUBLIC_APPWRITE_ATTACHMENTS_BUCKET_ID=attachments_bucket
-NEXT_PUBLIC_APPWRITE_PROJECT_DOCS_BUCKET_ID=project-docs
+NEXT_PUBLIC_APPWRITE_PROJECT_DOCS_BUCKET_ID=project-docs
+
+NEXT_PUBLIC_APPWRITE_BUG_REPORT=bug_report
+NEXT_PUBLIC_APPWRITE_BUG_REPORTS_BUCKET_ID=bug_reports_bucket

.github/workflows/deploy.yml

@@ -139,6 +139,10 @@ jobs:
           NEXT_PUBLIC_APPWRITE_PROJECT_WEBHOOK_DELIVERIES_ID: ${{ vars.NEXT_PUBLIC_APPWRITE_PROJECT_WEBHOOK_DELIVERIES_ID }}
           NEXT_PUBLIC_APPWRITE_BYOB_TENANTS_ID: ${{ vars.NEXT_PUBLIC_APPWRITE_BYOB_TENANTS_ID }}
 
+          # Bug Reports
+          NEXT_PUBLIC_APPWRITE_BUG_REPORTS_ID: ${{ vars.NEXT_PUBLIC_APPWRITE_BUG_REPORTS_ID }}
+          NEXT_PUBLIC_APPWRITE_BUG_REPORTS_BUCKET_ID: ${{ vars.NEXT_PUBLIC_APPWRITE_BUG_REPORTS_BUCKET_ID }}
+
           # Two-Factor Authentication (2FA)
           NEXT_PUBLIC_APPWRITE_USER_RECOVERY_CODES_ID: ${{ vars.NEXT_PUBLIC_APPWRITE_USER_RECOVERY_CODES_ID }}
           NEXT_PUBLIC_APPWRITE_EMAIL_OTP_CODES_ID: ${{ vars.NEXT_PUBLIC_APPWRITE_EMAIL_OTP_CODES_ID }}
@@ -290,6 +294,8 @@ jobs:
             NEXT_PUBLIC_APPWRITE_PROJECT_WEBHOOKS_ID=${{ vars.NEXT_PUBLIC_APPWRITE_PROJECT_WEBHOOKS_ID }}
             NEXT_PUBLIC_APPWRITE_PROJECT_WEBHOOK_DELIVERIES_ID=${{ vars.NEXT_PUBLIC_APPWRITE_PROJECT_WEBHOOK_DELIVERIES_ID }}
             NEXT_PUBLIC_APPWRITE_BYOB_TENANTS_ID=${{ vars.NEXT_PUBLIC_APPWRITE_BYOB_TENANTS_ID }}
+            NEXT_PUBLIC_APPWRITE_BUG_REPORTS_ID=${{ vars.NEXT_PUBLIC_APPWRITE_BUG_REPORTS_ID }}
+            NEXT_PUBLIC_APPWRITE_BUG_REPORTS_BUCKET_ID=${{ vars.NEXT_PUBLIC_APPWRITE_BUG_REPORTS_BUCKET_ID }}
             NEXT_PUBLIC_APPWRITE_USER_RECOVERY_CODES_ID=${{ vars.NEXT_PUBLIC_APPWRITE_USER_RECOVERY_CODES_ID }}
             NEXT_PUBLIC_APPWRITE_EMAIL_OTP_CODES_ID=${{ vars.NEXT_PUBLIC_APPWRITE_EMAIL_OTP_CODES_ID }}
             TWO_FACTOR_ENCRYPTION_SECRET=${{ secrets.TWO_FACTOR_ENCRYPTION_SECRET }}

scripts/database-initialization/collections/bug-reports.ts

@@ -0,0 +1,40 @@
+import { Databases, IndexType, Permission, Role } from 'node-appwrite';
+import {
+    ensureCollection,
+    ensureStringAttribute,
+    ensureIndex,
+    sleep,
+} from '../lib/db-helpers';
+import { logger } from '../lib/logger';
+
+const COLLECTION_ID = process.env.NEXT_PUBLIC_APPWRITE_BUG_REPORTS_ID || 'bug_reports';
+const COLLECTION_NAME = 'Bug Reports';
+
+export async function setupBugReports(databases: Databases, databaseId: string): Promise<void> {
+    logger.collection(COLLECTION_NAME);
+
+    await ensureCollection(databases, databaseId, COLLECTION_ID, COLLECTION_NAME, [
+        Permission.read(Role.any()),
+    ]);
+
+    // Reporter identity
+    await ensureStringAttribute(databases, databaseId, COLLECTION_ID, 'userId', 256, true);
+    await ensureStringAttribute(databases, databaseId, COLLECTION_ID, 'email', 256, true);
+    await ensureStringAttribute(databases, databaseId, COLLECTION_ID, 'username', 256, true);
+
+    // Report content
+    await ensureStringAttribute(databases, databaseId, COLLECTION_ID, 'title', 200, true);
+    await ensureStringAttribute(databases, databaseId, COLLECTION_ID, 'description', 5000, true);
+
+    // Attached images (stored in R2 / Appwrite storage)
+    await ensureStringAttribute(databases, databaseId, COLLECTION_ID, 'imageFileIds', 512, false, undefined, true);
+    await ensureStringAttribute(databases, databaseId, COLLECTION_ID, 'imageUrls', 1024, false, undefined, true);
+
+    // Wait for attributes to register before creating indexes
+    await sleep(2000);
+
+    // Indexes
+    await ensureIndex(databases, databaseId, COLLECTION_ID, 'userId_idx', IndexType.Key, ['userId']);
+    await ensureIndex(databases, databaseId, COLLECTION_ID, 'email_idx', IndexType.Key, ['email']);
+    await ensureIndex(databases, databaseId, COLLECTION_ID, 'createdAt_idx', IndexType.Key, ['$createdAt']);
+}

scripts/database-initialization/setup-database.ts

@@ -11,6 +11,7 @@ import { writeEnvVars } from './lib/env-writer';
 import { setupImagesBucket } from './storage/images-bucket';
 import { setupAttachmentsBucket } from './storage/attachments-bucket';
 import { setupProjectDocsBucket } from './storage/project-docs-bucket';
+import { setupBugReportsBucket } from './storage/bug-reports-bucket';
 
 // ─── Collection Setup Imports ────────────────────────────────
 import { setupWorkspaces } from './collections/workspaces';
@@ -75,6 +76,7 @@ import { setupUserRecoveryCodes } from './collections/user-recovery-codes';
 import { setupEmailOtpCodes } from './collections/email-otp-codes';
 import { setupBYOBTenants } from './collections/byob-tenants';
 import { setupAIModelPricing } from './collections/ai-model-pricing';
+import { setupBugReports } from './collections/bug-reports';
 
 // ─── Configuration ───────────────────────────────────────────
 const DATABASE_ID = process.env.NEXT_PUBLIC_APPWRITE_DATABASE_ID ?? 'fairlx';
@@ -180,6 +182,9 @@ const collectionSetups: Array<{
 
         // BYOB (Bring Your Own Backend)
         { name: 'BYOB Tenants', setup: setupBYOBTenants },
+
+        // Bug Reports
+        { name: 'Bug Reports', setup: setupBugReports },
     ];
 
 // ─── All Environment Variables ───────────────────────────────
@@ -302,10 +307,14 @@ function getAutoGeneratedVars(): Record<string, string> {
         NEXT_PUBLIC_APPWRITE_IMAGES_BUCKET_ID: process.env.NEXT_PUBLIC_APPWRITE_IMAGES_BUCKET_ID || 'images',
         NEXT_PUBLIC_APPWRITE_ATTACHMENTS_BUCKET_ID: process.env.NEXT_PUBLIC_APPWRITE_ATTACHMENTS_BUCKET_ID || 'attachments_bucket',
         NEXT_PUBLIC_APPWRITE_PROJECT_DOCS_BUCKET_ID: process.env.NEXT_PUBLIC_APPWRITE_PROJECT_DOCS_BUCKET_ID || 'project-docs',
+        NEXT_PUBLIC_APPWRITE_BUG_REPORTS_BUCKET_ID: process.env.NEXT_PUBLIC_APPWRITE_BUG_REPORTS_BUCKET_ID || 'bug_reports_bucket',
 
         // ── BYOB ──
         NEXT_PUBLIC_APPWRITE_BYOB_TENANTS_ID: process.env.NEXT_PUBLIC_APPWRITE_BYOB_TENANTS_ID || 'byob_tenants',
 
+        // ── Bug Reports ──
+        NEXT_PUBLIC_APPWRITE_BUG_REPORTS_ID: process.env.NEXT_PUBLIC_APPWRITE_BUG_REPORTS_ID || 'bug_reports',
+
         // ── Billing Defaults ──
         BILLING_GRACE_PERIOD_DAYS: process.env.BILLING_GRACE_PERIOD_DAYS || '7',
         BILLING_CURRENCY: process.env.BILLING_CURRENCY || 'INR',
@@ -483,6 +492,7 @@ export async function runBucketSetups(
         { name: 'Images', setup: setupImagesBucket },
         { name: 'Attachments', setup: setupAttachmentsBucket },
         { name: 'Project Documents', setup: setupProjectDocsBucket },
+        { name: 'Bug Reports', setup: setupBugReportsBucket },
     ];
 
     const succeeded: string[] = [];

scripts/database-initialization/setup-runner.ts

@@ -71,11 +71,13 @@ import { setupProjectWebhookDeliveries } from './collections/project-webhook-del
 import { setupUserRecoveryCodes } from './collections/user-recovery-codes';
 import { setupEmailOtpCodes } from './collections/email-otp-codes';
 import { setupAIModelPricing } from './collections/ai-model-pricing';
+import { setupBugReports } from './collections/bug-reports';
 
 // ─── Storage Bucket Imports ──────────────────────────────────
 import { setupImagesBucket } from './storage/images-bucket';
 import { setupAttachmentsBucket } from './storage/attachments-bucket';
 import { setupProjectDocsBucket } from './storage/project-docs-bucket';
+import { setupBugReportsBucket } from './storage/bug-reports-bucket';
 
 // ─── Collection Setup List ───────────────────────────────────
 const collectionSetups: Array<{
@@ -143,6 +145,7 @@ const collectionSetups: Array<{
         { name: 'Project Webhook Deliveries', setup: setupProjectWebhookDeliveries },
         { name: 'User Recovery Codes', setup: setupUserRecoveryCodes },
         { name: 'Email OTP Codes', setup: setupEmailOtpCodes },
+        { name: 'Bug Reports', setup: setupBugReports },
     ];
 
 // ─── Exported Functions ──────────────────────────────────────
@@ -179,6 +182,7 @@ export async function runBucketSetups(
         { name: 'Images', setup: setupImagesBucket },
         { name: 'Attachments', setup: setupAttachmentsBucket },
         { name: 'Project Documents', setup: setupProjectDocsBucket },
+        { name: 'Bug Reports', setup: setupBugReportsBucket },
     ];
 
     const succeeded: string[] = [];

scripts/database-initialization/storage/bug-reports-bucket.ts

@@ -0,0 +1,25 @@
+import { Storage, Permission, Role, Compression } from 'node-appwrite';
+import { ensureBucket } from '../lib/storage-helpers';
+import { logger } from '../lib/logger';
+
+const BUCKET_ID = process.env.NEXT_PUBLIC_APPWRITE_BUG_REPORTS_BUCKET_ID || 'bug_reports_bucket';
+const BUCKET_NAME = 'Bug Reports';
+
+export async function setupBugReportsBucket(storage: Storage): Promise<void> {
+    logger.collection(BUCKET_NAME);
+
+    await ensureBucket(storage, BUCKET_ID, BUCKET_NAME, {
+        permissions: [
+            Permission.read(Role.any()),
+            Permission.create(Role.users()),
+            Permission.update(Role.users()),
+            Permission.delete(Role.users()),
+        ],
+        fileSecurity: false,
+        maximumFileSize: 10 * 1024 * 1024, // 10MB
+        allowedFileExtensions: ['jpg', 'jpeg', 'png', 'gif', 'webp'],
+        compression: Compression.Gzip,
+        encryption: true,
+        antivirus: true,
+    });
+}

src/app/(dashboard)/bug-report/page.tsx

@@ -0,0 +1,9 @@
+import { BugReportForm } from "@/features/bug-reports/components/bug-report-form";
+
+export default function BugReportPage() {
+  return (
+    <div className="py-8 px-6 max-w-3xl mx-auto w-full">
+      <BugReportForm />
+    </div>
+  );
+}