feat: add comprehensive tests for token candidates and proxy log path metadata

- Implemented tests for the `/api/models/token-candidates` endpoint to verify model availability and token coverage scenarios.
- Added tests for `composeProxyLogMessage` to ensure proper formatting of log messages with downstream and upstream metadata.
- Created utility functions for parsing proxy log path metadata and handling missing token hints.
- Developed tests for the `Sites` and `TokenRoutes` components to validate UI behavior and interactions, including scrolling and group expansion.
- Introduced a custom hook `useAnimatedVisibility` for managing visibility animations in components.
- Enhanced the documentation link for site resources.

src/server/db/index.ts

@@ -34,6 +34,7 @@ function ensureTokenManagementSchema() {
       account_id integer NOT NULL,
       name text NOT NULL,
       token text NOT NULL,
+      token_group text,
       source text DEFAULT 'manual',
       enabled integer DEFAULT true,
       is_default integer DEFAULT false,
@@ -47,6 +48,10 @@ function ensureTokenManagementSchema() {
     sqlite.exec('ALTER TABLE route_channels ADD COLUMN token_id integer;');
   }
 
+  if (!tableColumnExists('account_tokens', 'token_group')) {
+    sqlite.exec('ALTER TABLE account_tokens ADD COLUMN token_group text;');
+  }
+
   sqlite.exec(`
     INSERT INTO account_tokens (account_id, name, token, source, enabled, is_default, created_at, updated_at)
     SELECT
@@ -123,6 +128,33 @@ function ensureSiteProxySchema() {
   }
 }
 
+function ensureSiteExternalCheckinUrlSchema() {
+  if (!tableExists('sites')) {
+    return;
+  }
+
+  if (!tableColumnExists('sites', 'external_checkin_url')) {
+    sqlite.exec(`ALTER TABLE sites ADD COLUMN external_checkin_url text;`);
+  }
+}
+
+function ensureSiteGlobalWeightSchema() {
+  if (!tableExists('sites')) {
+    return;
+  }
+
+  if (!tableColumnExists('sites', 'global_weight')) {
+    sqlite.exec(`ALTER TABLE sites ADD COLUMN global_weight real DEFAULT 1;`);
+  }
+
+  sqlite.exec(`
+    UPDATE sites
+    SET global_weight = 1
+    WHERE global_weight IS NULL
+      OR global_weight <= 0;
+  `);
+}
+
 function ensureRouteGroupingSchema() {
   if (!tableExists('token_routes') || !tableExists('route_channels')) {
     return;
@@ -184,6 +216,8 @@ function ensureDownstreamApiKeySchema() {
 ensureTokenManagementSchema();
 ensureSiteStatusSchema();
 ensureSiteProxySchema();
+ensureSiteExternalCheckinUrlSchema();
+ensureSiteGlobalWeightSchema();
 ensureRouteGroupingSchema();
 ensureDownstreamApiKeySchema();
 

src/server/db/schema.ts

@@ -5,11 +5,13 @@ export const sites = sqliteTable('sites', {
   id: integer('id').primaryKey({ autoIncrement: true }),
   name: text('name').notNull(),
   url: text('url').notNull(),
+  externalCheckinUrl: text('external_checkin_url'),
   platform: text('platform').notNull(), // 'new-api' | 'one-api' | 'veloera' | 'one-hub' | 'done-hub' | 'sub2api' | 'openai' | 'claude' | 'gemini'
   proxyUrl: text('proxy_url'),
   status: text('status').notNull().default('active'), // 'active' | 'disabled'
   isPinned: integer('is_pinned', { mode: 'boolean' }).default(false),
   sortOrder: integer('sort_order').default(0),
+  globalWeight: real('global_weight').default(1),
   apiKey: text('api_key'),
   createdAt: text('created_at').default(sql`(datetime('now'))`),
   updatedAt: text('updated_at').default(sql`(datetime('now'))`),
@@ -48,6 +50,7 @@ export const accountTokens = sqliteTable('account_tokens', {
   accountId: integer('account_id').notNull().references(() => accounts.id, { onDelete: 'cascade' }),
   name: text('name').notNull(),
   token: text('token').notNull(),
+  tokenGroup: text('token_group'),
   source: text('source').default('manual'), // 'manual' | 'sync' | 'legacy'
   enabled: integer('enabled', { mode: 'boolean' }).default(true),
   isDefault: integer('is_default', { mode: 'boolean' }).default(false),