Fix/country field validation

.codeclimate.yml

@@ -0,0 +1,34 @@
+version: "2"
+checks:
+  argument-count:
+    enabled: true
+  complex-logic:
+    enabled: true
+  file-lines:
+    enabled: true
+  method-complexity:
+    enabled: true
+  method-count:
+    enabled: true
+  method-lines:
+    enabled: true
+  nested-control-flow:
+    enabled: true
+  return-statements:
+    enabled: true
+  similar-code:
+    enabled: true
+  identical-code:
+    enabled: true
+plugins:
+  eslint:
+    enabled: true
+  pep8:
+    enabled: true
+exclude_patterns:
+  - "**/node_modules/"
+  - "**/venv/"
+  - "**/__pycache__/"
+  - "**/*.spec.js"
+  - "**/*.test.js"
+  - "**/tests/"

.devcontainer/devcontainer.json

@@ -0,0 +1,22 @@
+{
+  "name": "HelpDesk.AI",
+  "image": "mcr.microsoft.com/devcontainers/python:3.12",
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {
+      "version": "20"
+    },
+    "ghcr.io/devcontainers/features/git:1": {}
+  },
+  "forwardPorts": [8000, 3000],
+  "postCreateCommand": "pip install -r backend/requirements.txt && cd Frontend && npm install",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "dbaeumer.vscode-eslint",
+        "esbenp.prettier-vscode"
+      ]
+    }
+  }
+}

.dockerignore

@@ -0,0 +1,73 @@
+# =============================================================================
+# .dockerignore — Exclude unnecessary files from Docker build context
+# =============================================================================
+# The root Dockerfile only requires the `backend/` directory for the Python
+# FastAPI application. Everything else is excluded to:
+#   - Reduce build context size (was sending entire repo including .git/ ~400MB+)
+#   - Speed up Docker builds (especially in CI/CD pipelines)
+#   - Prevent accidental inclusion of secrets, node_modules, etc.
+# =============================================================================
+
+# ── Version Control ──────────────────────────────────────────────────────────
+.git/
+.gitattributes
+.gitignore
+
+# ── CI / Dev Configs ─────────────────────────────────────────────────────────
+.github/
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# ── Other Top-Level Projects (not needed for backend Docker image) ───────────
+Frontend/
+MobileApp/
+docs/
+templates/
+scratch/
+supabase/
+Model/
+node_modules/
+.npm-cache/
+.easignore
+
+# ── Python Cache ─────────────────────────────────────────────────────────────
+**/__pycache__/
+**/*.pyc
+**/*.pyo
+**/.pytest_cache/
+**/*.egg-info/
+
+# ── Virtual Environments ─────────────────────────────────────────────────────
+**/venv/
+**/.venv/
+venv/
+.venv/
+
+# ── Environment / Secrets ────────────────────────────────────────────────────
+.env
+.env.local
+.env.*.local
+backend/.env
+
+# ── Data & Model Artifacts (should be handled separately, not in Docker image)
+backend/data/
+backend/models/
+backend/*.csv
+backend/training/
+
+# ── Generated / Build Files ──────────────────────────────────────────────────
+dist/
+build/
+*.tsbuildinfo
+
+# ── OS Files ─────────────────────────────────────────────────────────────────
+.DS_Store
+Thumbs.db
+desktop.ini
+*.log
+
+# ── Documentation (not needed at runtime) ────────────────────────────────────
+**/*.md
+LICENSE

.easignore

@@ -0,0 +1,29 @@
+# ====================================================
+# EAS Build & Update Ignore Configuration (.easignore)
+# ====================================================
+# Exclude heavy non-mobile project directories from EAS cloud bundle
+# to keep archive sizes under 5MB instead of 700MB+.
+
+# Exclude non-mobile services
+/Frontend/
+/backend/
+/Model/
+/docs/
+/scratch/
+/scripts/
+/templates/
+/final_dataset.xlsx
+
+# Exclude package caches and git configs
+/.npm-cache/
+/.git/
+/.github/
+/.vscode/
+
+# Exclude local mobile development artifacts
+/MobileApp/node_modules/
+/MobileApp/.expo/
+/MobileApp/android/
+/MobileApp/ios/
+/MobileApp/web-build/
+/MobileApp/dist/

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{py,pyi}]
+indent_size = 4
+
+[Makefile]
+indent_style = tab
+
+[*.md]
+trim_trailing_whitespace = false

.env.example

@@ -0,0 +1,50 @@
+# HELPDESK.AI Environment Variables
+# Copy to .env and fill in your values. NEVER commit .env to git.
+
+# --- Server ---
+PORT=5000
+NODE_ENV=development
+SECRET_KEY=your-secret-key-here
+
+# --- Database ---
+DATABASE_URL=postgresql://user:password@localhost:5432/helpdesk
+MONGODB_URI=mongodb://localhost:27017/helpdesk
+
+# --- AI/ML Services ---
+OPENAI_API_KEY=sk-...
+HUGGINGFACE_API_TOKEN=hf_...
+OCR_SERVICE_API_KEY=
+
+# --- Email ---
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_USER=
+SMTP_PASS=
+
+# --- Auth ---
+JWT_SECRET=your-j...hars
+JWT_EXPIRY=24h
+PASSWORD_RESET_EXPIRY=***
+
+# --- Redis ---
+# Redis password for authentication (leave empty for no auth in dev)
+REDIS_PASSWORD=
+
+# --- CORS & Security Headers ---
+# Comma-separated list of allowed origins (no trailing slash)
+ALLOWED_ORIGINS=https://helpdeskaiv1.vercel.app,http://localhost:5173,http://localhost:3000
+# Optional: regex pattern for flexible origin matching (e.g., staging deployments)
+# ALLOWED_ORIGIN_REGEX=https://.*\.vercel\.app
+
+# Optional: Custom Content-Security-Policy (full policy string or comma-separated
+# origins to append to the default policy used by backend/security_middleware.py)
+# CSP_ALLOWED_SOURCES=https://analytics.example.com,https://cdn.example.com
+
+# Token for /metrics endpoint authentication
+METRICS_TOKEN=
+
+# --- Logging ---
+# Severity threshold for the backend structured logger (issue #2944).
+# Accepts DEBUG/INFO/WARNING/ERROR/CRITICAL (case-insensitive) or an integer.
+# Defaults to INFO when unset or invalid.
+LOG_LEVEL=INFO

.eslintrc.json

@@ -0,0 +1,37 @@
+{
+  "root": true,
+  "env": {
+    "browser": true,
+    "es2020": true,
+    "node": true
+  },
+  "extends": [
+    "eslint:recommended"
+  ],
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "rules": {
+    "no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "no-console": "warn",
+    "prefer-const": "error",
+    "no-var": "error",
+    "eqeqeq": ["error", "always"]
+  },
+  "overrides": [
+    {
+      "files": ["*.test.js", "*.test.jsx", "*.spec.js", "*.spec.jsx"],
+      "env": {
+        "jest": true
+      }
+    }
+  ],
+  "ignorePatterns": [
+    "node_modules/",
+    "dist/",
+    "build/",
+    "coverage/",
+    "*.min.js"
+  ]
+}