Merge branch 'main' into test-dev

frontend/src/components/admin/user/UserAllowedGroupsModal.vue

+<template>
+  <BaseDialog :show="show" :title="t('admin.users.setAllowedGroups')" width="normal" @close="$emit('close')">
+    <div v-if="user" class="space-y-4">
+      <div class="flex items-center gap-3 rounded-xl bg-gray-50 p-4 dark:bg-dark-700">
+        <div class="flex h-10 w-10 items-center justify-center rounded-full bg-primary-100">
+          <span class="text-lg font-medium text-primary-700">{{ user.email.charAt(0).toUpperCase() }}</span>
+        </div>
+        <p class="font-medium text-gray-900 dark:text-white">{{ user.email }}</p>
+      </div>
+      <div v-if="loading" class="flex justify-center py-8"><svg class="h-8 w-8 animate-spin text-primary-500" fill="none" viewBox="0 0 24 24"><circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle><path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path></svg></div>
+      <div v-else>
+        <p class="mb-3 text-sm text-gray-600">{{ t('admin.users.allowedGroupsHint') }}</p>
+        <div class="max-h-64 space-y-2 overflow-y-auto">
+          <label v-for="group in groups" :key="group.id" class="flex cursor-pointer items-center gap-3 rounded-lg border border-gray-200 p-3 hover:bg-gray-50" :class="{'border-primary-300 bg-primary-50': selectedIds.includes(group.id)}">
+            <input type="checkbox" :value="group.id" v-model="selectedIds" class="h-4 w-4 rounded border-gray-300 text-primary-600" />
+            <div class="flex-1"><p class="font-medium text-gray-900">{{ group.name }}</p><p v-if="group.description" class="truncate text-sm text-gray-500">{{ group.description }}</p></div>
+            <div class="flex items-center gap-2"><span class="badge badge-gray text-xs">{{ group.platform }}</span><span v-if="group.is_exclusive" class="badge badge-purple text-xs">{{ t('admin.groups.exclusive') }}</span></div>
+          </label>
+        </div>
+        <div class="mt-4 border-t border-gray-200 pt-4">
+          <label class="flex cursor-pointer items-center gap-3 rounded-lg border border-gray-200 p-3 hover:bg-gray-50" :class="{'border-green-300 bg-green-50': selectedIds.length === 0}">
+            <input type="radio" :checked="selectedIds.length === 0" @change="selectedIds = []" class="h-4 w-4 border-gray-300 text-green-600" />
+            <div class="flex-1"><p class="font-medium text-gray-900">{{ t('admin.users.allowAllGroups') }}</p><p class="text-sm text-gray-500">{{ t('admin.users.allowAllGroupsHint') }}</p></div>
+          </label>
+        </div>
+      </div>
+    </div>
+    <template #footer>
+      <div class="flex justify-end gap-3">
+        <button @click="$emit('close')" class="btn btn-secondary">{{ t('common.cancel') }}</button>
+        <button @click="handleSave" :disabled="submitting" class="btn btn-primary">{{ submitting ? t('common.saving') : t('common.save') }}</button>
+      </div>
+    </template>
+  </BaseDialog>
+</template>
+
+<script setup lang="ts">
+import { ref, watch } from 'vue'
+import { useI18n } from 'vue-i18n'
+import { useAppStore } from '@/stores/app'
+import { adminAPI } from '@/api/admin'
+import type { User, Group } from '@/types'
+import BaseDialog from '@/components/common/BaseDialog.vue'
+
+const props = defineProps<{ show: boolean, user: User | null }>()
+const emit = defineEmits(['close', 'success']); const { t } = useI18n(); const appStore = useAppStore()
+
+const groups = ref<Group[]>([]); const selectedIds = ref<number[]>([]); const loading = ref(false); const submitting = ref(false)
+
+watch(() => props.show, (v) => { if(v && props.user) { selectedIds.value = props.user.allowed_groups || []; load() } })
+const load = async () => { loading.value = true; try { const res = await adminAPI.groups.list(1, 1000); groups.value = res.items.filter(g => g.subscription_type === 'standard' && g.status === 'active') } catch {} finally { loading.value = false } }
+const handleSave = async () => {
+  if (!props.user) return; submitting.value = true
+  try {
+    await adminAPI.users.update(props.user.id, { allowed_groups: selectedIds.value.length > 0 ? selectedIds.value : null })
+    appStore.showSuccess(t('admin.users.allowedGroupsUpdated')); emit('success'); emit('close')
+  } catch {} finally { submitting.value = false }
+}
+</script>
\ No newline at end of file

frontend/src/components/admin/user/UserApiKeysModal.vue

+<template>
+  <BaseDialog :show="show" :title="t('admin.users.userApiKeys')" width="wide" @close="$emit('close')">
+    <div v-if="user" class="space-y-4">
+      <div class="flex items-center gap-3 rounded-xl bg-gray-50 p-4 dark:bg-dark-700">
+        <div class="flex h-10 w-10 items-center justify-center rounded-full bg-primary-100 dark:bg-primary-900/30">
+          <span class="text-lg font-medium text-primary-700 dark:text-primary-300">{{ user.email.charAt(0).toUpperCase() }}</span>
+        </div>
+        <div><p class="font-medium text-gray-900 dark:text-white">{{ user.email }}</p><p class="text-sm text-gray-500 dark:text-dark-400">{{ user.username }}</p></div>
+      </div>
+      <div v-if="loading" class="flex justify-center py-8"><svg class="h-8 w-8 animate-spin text-primary-500" fill="none" viewBox="0 0 24 24"><circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle><path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path></svg></div>
+      <div v-else-if="apiKeys.length === 0" class="py-8 text-center"><p class="text-sm text-gray-500">{{ t('admin.users.noApiKeys') }}</p></div>
+      <div v-else class="max-h-96 space-y-3 overflow-y-auto">
+        <div v-for="key in apiKeys" :key="key.id" class="rounded-xl border border-gray-200 bg-white p-4 dark:border-dark-600 dark:bg-dark-800">
+          <div class="flex items-start justify-between">
+            <div class="min-w-0 flex-1">
+              <div class="mb-1 flex items-center gap-2"><span class="font-medium text-gray-900 dark:text-white">{{ key.name }}</span><span :class="['badge text-xs', key.status === 'active' ? 'badge-success' : 'badge-danger']">{{ key.status }}</span></div>
+              <p class="truncate font-mono text-sm text-gray-500">{{ key.key.substring(0, 20) }}...{{ key.key.substring(key.key.length - 8) }}</p>
+            </div>
+          </div>
+          <div class="mt-3 flex flex-wrap gap-4 text-xs text-gray-500">
+            <div class="flex items-center gap-1"><span>{{ t('admin.users.group') }}: {{ key.group?.name || t('admin.users.none') }}</span></div>
+            <div class="flex items-center gap-1"><span>{{ t('admin.users.columns.created') }}: {{ formatDateTime(key.created_at) }}</span></div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </BaseDialog>
+</template>
+
+<script setup lang="ts">
+import { ref, watch } from 'vue'
+import { useI18n } from 'vue-i18n'
+import { adminAPI } from '@/api/admin'
+import { formatDateTime } from '@/utils/format'
+import type { User, ApiKey } from '@/types'
+import BaseDialog from '@/components/common/BaseDialog.vue'
+
+const props = defineProps<{ show: boolean, user: User | null }>()
+defineEmits(['close']); const { t } = useI18n()
+const apiKeys = ref<ApiKey[]>([]); const loading = ref(false)
+
+watch(() => props.show, (v) => { if (v && props.user) load() })
+const load = async () => {
+  if (!props.user) return; loading.value = true
+  try { const res = await adminAPI.users.getUserApiKeys(props.user.id); apiKeys.value = res.items || [] } catch {} finally { loading.value = false }
+}
+</script>
\ No newline at end of file

frontend/src/components/admin/user/UserBalanceModal.vue

+<template>
+  <BaseDialog :show="show" :title="operation === 'add' ? t('admin.users.deposit') : t('admin.users.withdraw')" width="narrow" @close="$emit('close')">
+    <form v-if="user" id="balance-form" @submit.prevent="handleBalanceSubmit" class="space-y-5">
+      <div class="flex items-center gap-3 rounded-xl bg-gray-50 p-4 dark:bg-dark-700">
+        <div class="flex h-10 w-10 items-center justify-center rounded-full bg-primary-100"><span class="text-lg font-medium text-primary-700">{{ user.email.charAt(0).toUpperCase() }}</span></div>
+        <div class="flex-1"><p class="font-medium text-gray-900">{{ user.email }}</p><p class="text-sm text-gray-500">{{ t('admin.users.currentBalance') }}: ${{ user.balance.toFixed(2) }}</p></div>
+      </div>
+      <div>
+        <label class="input-label">{{ operation === 'add' ? t('admin.users.depositAmount') : t('admin.users.withdrawAmount') }}</label>
+        <div class="relative"><div class="absolute left-3 top-1/2 -translate-y-1/2 font-medium text-gray-500">$</div><input v-model.number="form.amount" type="number" step="0.01" min="0.01" required class="input pl-8" /></div>
+      </div>
+      <div><label class="input-label">{{ t('admin.users.notes') }}</label><textarea v-model="form.notes" rows="3" class="input"></textarea></div>
+      <div v-if="form.amount > 0" class="rounded-xl border border-blue-200 bg-blue-50 p-4"><div class="flex items-center justify-between text-sm"><span>{{ t('admin.users.newBalance') }}:</span><span class="font-bold">${{ calculateNewBalance().toFixed(2) }}</span></div></div>
+    </form>
+    <template #footer>
+      <div class="flex justify-end gap-3">
+        <button @click="$emit('close')" class="btn btn-secondary">{{ t('common.cancel') }}</button>
+        <button type="submit" form="balance-form" :disabled="submitting || !form.amount" class="btn" :class="operation === 'add' ? 'bg-emerald-600 text-white' : 'btn-danger'">{{ submitting ? t('common.saving') : t('common.confirm') }}</button>
+      </div>
+    </template>
+  </BaseDialog>
+</template>
+
+<script setup lang="ts">
+import { reactive, ref, watch } from 'vue'
+import { useI18n } from 'vue-i18n'
+import { useAppStore } from '@/stores/app'
+import { adminAPI } from '@/api/admin'
+import type { User } from '@/types'
+import BaseDialog from '@/components/common/BaseDialog.vue'
+
+const props = defineProps<{ show: boolean, user: User | null, operation: 'add' | 'subtract' }>()
+const emit = defineEmits(['close', 'success']); const { t } = useI18n(); const appStore = useAppStore()
+
+const submitting = ref(false); const form = reactive({ amount: 0, notes: '' })
+watch(() => props.show, (v) => { if(v) { form.amount = 0; form.notes = '' } })
+
+const calculateNewBalance = () => (props.user ? (props.operation === 'add' ? props.user.balance + form.amount : props.user.balance - form.amount) : 0)
+const handleBalanceSubmit = async () => {
+  if (!props.user) return; submitting.value = true
+  try {
+    await adminAPI.users.updateBalance(props.user.id, form.amount, props.operation, form.notes)
+    appStore.showSuccess(t('common.success')); emit('success'); emit('close')
+  } catch {} finally { submitting.value = false }
+}
+</script>
\ No newline at end of file

frontend/src/components/admin/user/UserCreateModal.vue

+<template>
+  <BaseDialog
+    :show="show"
+    :title="t('admin.users.createUser')"
+    width="normal"
+    @close="$emit('close')"
+  >
+    <form id="create-user-form" @submit.prevent="submit" class="space-y-5">
+      <div>
+        <label class="input-label">{{ t('admin.users.email') }}</label>
+        <input v-model="form.email" type="email" required class="input" :placeholder="t('admin.users.enterEmail')" />
+      </div>
+      <div>
+        <label class="input-label">{{ t('admin.users.password') }}</label>
+        <div class="flex gap-2">
+          <div class="relative flex-1">
+            <input v-model="form.password" type="text" required class="input pr-10" :placeholder="t('admin.users.enterPassword')" />
+          </div>
+          <button type="button" @click="generateRandomPassword" class="btn btn-secondary px-3">
+            <svg class="h-5 w-5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M16.023 9.348h4.992v-.001M2.985 19.644v-4.992m0 0h4.992m-4.993 0l3.181 3.183a8.25 8.25 0 0013.803-3.7M4.031 9.865a8.25 8.25 0 0113.803-3.7l3.181 3.182m0-4.991v4.99" /></svg>
+          </button>
+        </div>
+      </div>
+      <div>
+        <label class="input-label">{{ t('admin.users.username') }}</label>
+        <input v-model="form.username" type="text" class="input" :placeholder="t('admin.users.enterUsername')" />
+      </div>
+      <div class="grid grid-cols-2 gap-4">
+        <div>
+          <label class="input-label">{{ t('admin.users.columns.balance') }}</label>
+          <input v-model.number="form.balance" type="number" step="any" class="input" />
+        </div>
+        <div>
+          <label class="input-label">{{ t('admin.users.columns.concurrency') }}</label>
+          <input v-model.number="form.concurrency" type="number" class="input" />
+        </div>
+      </div>
+    </form>
+    <template #footer>
+      <div class="flex justify-end gap-3">
+        <button @click="$emit('close')" type="button" class="btn btn-secondary">{{ t('common.cancel') }}</button>
+        <button type="submit" form="create-user-form" :disabled="loading" class="btn btn-primary">
+          {{ loading ? t('admin.users.creating') : t('common.create') }}
+        </button>
+      </div>
+    </template>
+  </BaseDialog>
+</template>
+
+<script setup lang="ts">
+import { reactive, watch } from 'vue'
+import { useI18n } from 'vue-i18n'; import { adminAPI } from '@/api/admin'
+import { useForm } from '@/composables/useForm'
+import BaseDialog from '@/components/common/BaseDialog.vue'
+
+const props = defineProps<{ show: boolean }>()
+const emit = defineEmits(['close', 'success']); const { t } = useI18n()
+
+const form = reactive({ email: '', password: '', username: '', notes: '', balance: 0, concurrency: 1 })
+
+const { loading, submit } = useForm({
+  form,
+  submitFn: async (data) => {
+    await adminAPI.users.create(data)
+    emit('success'); emit('close')
+  },
+  successMsg: t('admin.users.userCreated')
+})
+
+watch(() => props.show, (v) => { if(v) Object.assign(form, { email: '', password: '', username: '', notes: '', balance: 0, concurrency: 1 }) })
+
+const generateRandomPassword = () => {
+  const chars = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz23456789!@#$%^&*'
+  let p = ''; for (let i = 0; i < 16; i++) p += chars.charAt(Math.floor(Math.random() * chars.length))
+  form.password = p
+}
+</script>

frontend/src/components/admin/user/UserEditModal.vue

+<template>
+  <BaseDialog
+    :show="show"
+    :title="t('admin.users.editUser')"
+    width="normal"
+    @close="$emit('close')"
+  >
+    <form v-if="user" id="edit-user-form" @submit.prevent="handleUpdateUser" class="space-y-5">
+      <div>
+        <label class="input-label">{{ t('admin.users.email') }}</label>
+        <input v-model="form.email" type="email" class="input" />
+      </div>
+      <div>
+        <label class="input-label">{{ t('admin.users.password') }}</label>
+        <div class="flex gap-2">
+          <div class="relative flex-1">
+            <input v-model="form.password" type="text" class="input pr-10" :placeholder="t('admin.users.enterNewPassword')" />
+            <button v-if="form.password" type="button" @click="copyPassword" class="absolute right-2 top-1/2 -translate-y-1/2 rounded-lg p-1 transition-colors hover:bg-gray-100 dark:hover:bg-dark-700" :class="passwordCopied ? 'text-green-500' : 'text-gray-400'">
+              <svg v-if="passwordCopied" class="h-4 w-4" fill="none" stroke="currentColor" viewBox="0 0 24 24" stroke-width="2"><path stroke-linecap="round" stroke-linejoin="round" d="M5 13l4 4L19 7" /></svg>
+              <svg v-else class="h-4 w-4" fill="none" stroke="currentColor" viewBox="0 0 24 24" stroke-width="1.5"><path stroke-linecap="round" stroke-linejoin="round" d="M15.666 3.888A2.25 2.25 0 0013.5 2.25h-3c-1.03 0-1.9.693-2.166 1.638m7.332 0c.055.194.084.4.084.612v0a.75.75 0 01-.75.75H9a.75.75 0 01-.75-.75v0c0-.212.03-.418.084-.612m7.332 0c.646.049 1.288.11 1.927.184 1.1.128 1.907 1.077 1.907 2.185V19.5a2.25 2.25 0 01-2.25 2.25H6.75A2.25 2.25 0 014.5 19.5V6.257c0-1.108.806-2.057 1.907-2.185a48.208 48.208 0 011.927-.184" /></svg>
+            </button>
+          </div>
+          <button type="button" @click="generatePassword" class="btn btn-secondary px-3">
+            <svg class="h-5 w-5" fill="none" stroke="currentColor" viewBox="0 0 24 24" stroke-width="1.5"><path stroke-linecap="round" stroke-linejoin="round" d="M16.023 9.348h4.992v-.001M2.985 19.644v-4.992m0 0h4.992m-4.993 0l3.181 3.183a8.25 8.25 0 0013.803-3.7M4.031 9.865a8.25 8.25 0 0113.803-3.7l3.181 3.182m0-4.991v4.99" /></svg>
+          </button>
+        </div>
+      </div>
+      <div>
+        <label class="input-label">{{ t('admin.users.username') }}</label>
+        <input v-model="form.username" type="text" class="input" />
+      </div>
+      <div>
+        <label class="input-label">{{ t('admin.users.notes') }}</label>
+        <textarea v-model="form.notes" rows="3" class="input"></textarea>
+      </div>
+      <div>
+        <label class="input-label">{{ t('admin.users.columns.concurrency') }}</label>
+        <input v-model.number="form.concurrency" type="number" class="input" />
+      </div>
+      <UserAttributeForm v-model="form.customAttributes" :user-id="user?.id" />
+    </form>
+    <template #footer>
+      <div class="flex justify-end gap-3">
+        <button @click="$emit('close')" type="button" class="btn btn-secondary">{{ t('common.cancel') }}</button>
+        <button type="submit" form="edit-user-form" :disabled="submitting" class="btn btn-primary">
+          {{ submitting ? t('admin.users.updating') : t('common.update') }}
+        </button>
+      </div>
+    </template>
+  </BaseDialog>
+</template>
+
+<script setup lang="ts">
+import { ref, reactive, watch } from 'vue'
+import { useI18n } from 'vue-i18n'
+import { useAppStore } from '@/stores/app'
+import { useClipboard } from '@/composables/useClipboard'
+import { adminAPI } from '@/api/admin'
+import type { User, UserAttributeValuesMap } from '@/types'
+import BaseDialog from '@/components/common/BaseDialog.vue'
+import UserAttributeForm from '@/components/user/UserAttributeForm.vue'
+
+const props = defineProps<{ show: boolean, user: User | null }>()
+const emit = defineEmits(['close', 'success'])
+const { t } = useI18n(); const appStore = useAppStore(); const { copyToClipboard } = useClipboard()
+
+const submitting = ref(false); const passwordCopied = ref(false)
+const form = reactive({ email: '', password: '', username: '', notes: '', concurrency: 1, customAttributes: {} as UserAttributeValuesMap })
+
+watch(() => props.user, (u) => {
+  if (u) {
+    Object.assign(form, { email: u.email, password: '', username: u.username || '', notes: u.notes || '', concurrency: u.concurrency, customAttributes: {} })
+    passwordCopied.value = false
+  }
+}, { immediate: true })
+
+const generatePassword = () => {
+  const chars = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz23456789!@#$%^&*'
+  let p = ''; for (let i = 0; i < 16; i++) p += chars.charAt(Math.floor(Math.random() * chars.length))
+  form.password = p
+}
+const copyPassword = async () => {
+  if (form.password && await copyToClipboard(form.password, t('admin.users.passwordCopied'))) {
+    passwordCopied.value = true; setTimeout(() => passwordCopied.value = false, 2000)
+  }
+}
+const handleUpdateUser = async () => {
+  if (!props.user) return
+  submitting.value = true
+  try {
+    const data: any = { email: form.email, username: form.username, notes: form.notes, concurrency: form.concurrency }
+    if (form.password.trim()) data.password = form.password.trim()
+    await adminAPI.users.update(props.user.id, data)
+    if (Object.keys(form.customAttributes).length > 0) await adminAPI.userAttributes.updateUserAttributeValues(props.user.id, form.customAttributes)
+    appStore.showSuccess(t('admin.users.userUpdated'))
+    emit('success'); emit('close')
+  } catch (e: any) {
+    appStore.showError(e.response?.data?.detail || t('admin.users.failedToUpdate'))
+  } finally { submitting.value = false }
+}
+</script>
\ No newline at end of file

frontend/src/components/common/GroupOptionItem.vue

+<template>
+  <div class="flex min-w-0 flex-1 items-center justify-between gap-2">
+    <div
+      class="flex min-w-0 flex-1 flex-col items-start gap-1"
+      :title="description || undefined"
+    >
+      <GroupBadge
+        :name="name"
+        :platform="platform"
+        :subscription-type="subscriptionType"
+        :rate-multiplier="rateMultiplier"
+      />
+      <span
+        v-if="description"
+        class="w-full truncate text-left text-xs text-gray-500 dark:text-gray-400"
+      >
+        {{ description }}
+      </span>
+    </div>
+    <svg
+      v-if="showCheckmark && selected"
+      class="h-4 w-4 shrink-0 text-primary-600 dark:text-primary-400"
+      fill="none"
+      stroke="currentColor"
+      viewBox="0 0 24 24"
+      stroke-width="2"
+    >
+      <path stroke-linecap="round" stroke-linejoin="round" d="M5 13l4 4L19 7" />
+    </svg>
+  </div>
+</template>
+
+<script setup lang="ts">
+import GroupBadge from './GroupBadge.vue'
+import type { SubscriptionType, GroupPlatform } from '@/types'
+
+interface Props {
+  name: string
+  platform: GroupPlatform
+  subscriptionType?: SubscriptionType
+  rateMultiplier?: number
+  description?: string | null
+  selected?: boolean
+  showCheckmark?: boolean
+}
+
+withDefaults(defineProps<Props>(), {
+  subscriptionType: 'standard',
+  selected: false,
+  showCheckmark: true
+})
+</script>

frontend/src/components/common/GroupSelector.vue

 <template>
   <div>
     <label class="input-label">
-      Groups
-      <span class="font-normal text-gray-400">({{ modelValue.length }} selected)</span>
+      {{ t('admin.users.groups') }}
+      <span class="font-normal text-gray-400">{{ t('common.selectedCount', { count: modelValue.length }) }}</span>
     </label>
     <div
       class="grid max-h-32 grid-cols-2 gap-1 overflow-y-auto rounded-lg border border-gray-200 bg-gray-50 p-2 dark:border-dark-600 dark:bg-dark-800"
@@ -32,7 +32,7 @@
         v-if="filteredGroups.length === 0"
         class="col-span-2 py-2 text-center text-sm text-gray-500 dark:text-gray-400"
       >
-        No groups available
+        {{ t('common.noGroupsAvailable') }}
       </div>
     </div>
   </div>

frontend/src/components/common/Input.vue

+<template>
+  <div class="w-full">
+    <label v-if="label" :for="id" class="input-label mb-1.5 block">
+      {{ label }}
+      <span v-if="required" class="text-red-500">*</span>
+    </label>
+    <div class="relative">
+      <!-- Prefix Icon Slot -->
+      <div
+        v-if="$slots.prefix"
+        class="pointer-events-none absolute inset-y-0 left-0 flex items-center pl-3.5 text-gray-400 dark:text-dark-400"
+      >
+        <slot name="prefix"></slot>
+      </div>
+
+      <input
+        :id="id"
+        ref="inputRef"
+        :type="type"
+        :value="modelValue"
+        :disabled="disabled"
+        :required="required"
+        :placeholder="placeholderText"
+        :autocomplete="autocomplete"
+        :readonly="readonly"
+        :class="[
+          'input w-full transition-all duration-200',
+          $slots.prefix ? 'pl-11' : '',
+          $slots.suffix ? 'pr-11' : '',
+          error ? 'input-error ring-2 ring-red-500/20' : '',
+          disabled ? 'cursor-not-allowed bg-gray-100 opacity-60 dark:bg-dark-900' : ''
+        ]"
+        @input="onInput"
+        @change="$emit('change', ($event.target as HTMLInputElement).value)"
+        @blur="$emit('blur', $event)"
+        @focus="$emit('focus', $event)"
+        @keyup.enter="$emit('enter', $event)"
+      />
+
+      <!-- Suffix Slot (e.g. Password Toggle or Clear Button) -->
+      <div
+        v-if="$slots.suffix"
+        class="absolute inset-y-0 right-0 flex items-center pr-3 text-gray-400 dark:text-dark-400"
+      >
+        <slot name="suffix"></slot>
+      </div>
+    </div>
+    <!-- Hint / Error Text -->
+    <p v-if="error" class="input-error-text mt-1.5">
+      {{ error }}
+    </p>
+    <p v-else-if="hint" class="input-hint mt-1.5">
+      {{ hint }}
+    </p>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, ref } from 'vue'
+
+interface Props {
+  modelValue: string | number | null | undefined
+  type?: string
+  label?: string
+  placeholder?: string
+  disabled?: boolean
+  required?: boolean
+  readonly?: boolean
+  error?: string
+  hint?: string
+  id?: string
+  autocomplete?: string
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  type: 'text',
+  disabled: false,
+  required: false,
+  readonly: false
+})
+
+const emit = defineEmits<{
+  (e: 'update:modelValue', value: string): void
+  (e: 'change', value: string): void
+  (e: 'blur', event: FocusEvent): void
+  (e: 'focus', event: FocusEvent): void
+  (e: 'enter', event: KeyboardEvent): void
+}>()
+
+const inputRef = ref<HTMLInputElement | null>(null)
+const placeholderText = computed(() => props.placeholder || '')
+
+const onInput = (event: Event) => {
+  const value = (event.target as HTMLInputElement).value
+  emit('update:modelValue', value)
+}
+
+// Expose focus method
+defineExpose({
+  focus: () => inputRef.value?.focus(),
+  select: () => inputRef.value?.select()
+})
+</script>

frontend/src/components/common/Skeleton.vue

+<template>
+  <div
+    :class="[
+      'animate-pulse bg-gray-200 dark:bg-dark-700',
+      variant === 'circle' ? 'rounded-full' : 'rounded-lg',
+      customClass
+    ]"
+    :style="style"
+  ></div>
+</template>
+
+<script setup lang="ts">
+import { computed } from 'vue'
+
+interface Props {
+  variant?: 'rect' | 'circle' | 'text'
+  width?: string | number
+  height?: string | number
+  class?: string
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  variant: 'rect',
+  width: '100%'
+})
+
+const customClass = computed(() => props.class || '')
+
+const style = computed(() => {
+  const s: Record<string, string> = {}
+  
+  if (props.width) {
+    s.width = typeof props.width === 'number' ? `${props.width}px` : props.width
+  }
+  
+  if (props.height) {
+    s.height = typeof props.height === 'number' ? `${props.height}px` : props.height
+  } else if (props.variant === 'text') {
+    s.height = '1em'
+    s.marginTop = '0.25em'
+    s.marginBottom = '0.25em'
+  }
+  
+  return s
+})
+</script>