Initial commit - Project start (July 17, 2025)

Original: feat: enhance security logging and ensure rate limit blocks are properly tracked

- Add comprehensive logging for rate limit blocks with full request details
  - IP address (with proper proxy detection), user agent, headers, timestamps
  - Rate limit info (current count, limit, remaining, reset time)
  - Separate tracking for auth vs general endpoints

- Enhance authentication failure logging
  - JWT validation failures with detailed error info
  - Admin auth attempts without token
  - Failed token validation with user context
  - All events include IP, path, method, user agent

- Improve Winston logger configuration for production
  - Add automatic log rotation (10MB errors, 50MB combined)
  - Create separate security.log for auth/rate limit events
  - Ensure logs directory exists automatically
  - Add structured JSON format for log aggregation
  - Support container logging with LOG_TO_CONSOLE env var

- Create comprehensive documentation
  - Security logging guide with examples
  - Monitoring recommendations
  - Configuration reference

- Add test script to verify logging functionality

All rate limit settings remain configurable via admin panel:
- Window duration, max requests, auth limits
- Skip authenticated requests option
- Public endpoints only option

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

backend/src/utils/filenameSanitizer.js

@@ -0,0 +1,57 @@
+/**
+ * Sanitize a string to be used as a filename component
+ * @param {string} str - The string to sanitize
+ * @param {number} maxLength - Maximum length of the sanitized string
+ * @returns {string} - Sanitized string
+ */
+function sanitizeFilename(str, maxLength = 50) {
+  if (!str) return 'unnamed';
+  
+  // Convert to string and trim
+  let sanitized = String(str).trim();
+  
+  // Replace spaces with underscores
+  sanitized = sanitized.replace(/\s+/g, '_');
+  
+  // Remove special characters except hyphens, underscores, and dots
+  sanitized = sanitized.replace(/[^a-zA-Z0-9_\-\.]/g, '');
+  
+  // Remove multiple consecutive underscores or hyphens
+  sanitized = sanitized.replace(/[_\-]{2,}/g, '_');
+  
+  // Remove leading/trailing underscores or hyphens
+  sanitized = sanitized.replace(/^[_\-]+|[_\-]+$/g, '');
+  
+  // Limit length
+  if (sanitized.length > maxLength) {
+    sanitized = sanitized.substring(0, maxLength);
+  }
+  
+  // If empty after sanitization, use default
+  if (!sanitized) {
+    sanitized = 'unnamed';
+  }
+  
+  return sanitized;
+}
+
+/**
+ * Generate a photo filename based on event name, category, and counter
+ * @param {string} eventName - The event name
+ * @param {string} categoryName - The category name
+ * @param {number} counter - The photo counter
+ * @param {string} extension - The file extension (including dot)
+ * @returns {string} - Generated filename
+ */
+function generatePhotoFilename(eventName, categoryName, counter, extension) {
+  const sanitizedEvent = sanitizeFilename(eventName, 30);
+  const sanitizedCategory = sanitizeFilename(categoryName || 'uncategorized', 20);
+  const paddedCounter = String(counter).padStart(4, '0');
+  
+  return `${sanitizedEvent}_${sanitizedCategory}_${paddedCounter}${extension}`;
+}
+
+module.exports = {
+  sanitizeFilename,
+  generatePhotoFilename
+};