Track uploads util; ignore only runtime /uploads directory.

Co-authored-by: Cursor <cursoragent@cursor.com>

.gitignore

@@ -18,8 +18,8 @@ prisma/dev.db-journal
 # local runtime toggles
 data/
 
-# uploaded tenant assets
-uploads/
+# uploaded tenant assets (runtime dir at repo root — keep src/uploads source tracked)
+/uploads/
 
 # logs & ide
 *.log

src/uploads/uploads.util.ts

@@ -0,0 +1,20 @@
+import { existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+
+export const UPLOADS_ROOT = join(process.cwd(), 'uploads');
+export const AVATARS_DIR = join(UPLOADS_ROOT, 'avatars');
+
+export function ensureUploadsDirs() {
+  if (!existsSync(AVATARS_DIR)) {
+    mkdirSync(AVATARS_DIR, { recursive: true });
+  }
+}
+
+export function publicApiBase(config: {
+  get: (key: string, defaultValue?: string) => string | undefined;
+}): string {
+  const fromEnv = config.get('PUBLIC_API_URL')?.replace(/\/$/, '');
+  if (fromEnv) return fromEnv;
+  const port = config.get('PORT', '3001') ?? '3001';
+  return `http://localhost:${port}`;
+}