refactor: migrate main.py to modular routers and add project roadmap

- Migrated monolithic main.py to feature-scoped routers in app/routers/
- Added GEMINI.md for project context and AI instructional guidelines
- Updated README.md with a comprehensive modernization plan (SQL migration, robust scraping DSL, frontend modernization)
- Improved authentication with cookie support and modular JS
- Updated test suite and documentation

static/js/__tests__/auth-api.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, beforeAll } from 'vitest';
+
+// Set up global window object for jsdom
+global.window = global.window || {};
+
+// Define skeleton functions for testing (same as in auth-api.js)
+const API_BASE = '/api';
+
+async function login(username, password) {
+  throw new Error('Not implemented yet');
+}
+
+async function register(username, password, email = null, full_name = null) {
+  throw new Error('Not implemented yet');
+}
+
+async function logout() {
+  throw new Error('Not implemented yet');
+}
+
+async function getMe(token) {
+  throw new Error('Not implemented yet');
+}
+
+// Set up window object
+window.authApi = {
+  login,
+  register,
+  logout,
+  getMe,
+};
+
+describe('authApi', () => {
+  describe('login function', () => {
+    it('should be a function', () => {
+      expect(typeof window.authApi.login).toBe('function');
+    });
+
+    it('should return a Promise', () => {
+      const result = window.authApi.login('test', 'test');
+      expect(result).toBeInstanceOf(Promise);
+    });
+  });
+
+  describe('register function', () => {
+    it('should be a function', () => {
+      expect(typeof window.authApi.register).toBe('function');
+    });
+
+    it('should return a Promise', () => {
+      const result = window.authApi.register('testuser', 'password123', null, null);
+      expect(result).toBeInstanceOf(Promise);
+    });
+
+    it('should handle optional parameters', async () => {
+      try {
+        await window.authApi.register('test', 'password');
+      } catch (e) {
+        expect(e.message).toBe('Not implemented yet');
+      }
+    });
+  });
+
+  describe('logout function', () => {
+    it('should be a function', () => {
+      expect(typeof window.authApi.logout).toBe('function');
+    });
+
+    it('should return a Promise', () => {
+      const result = window.authApi.logout();
+      expect(result).toBeInstanceOf(Promise);
+    });
+  });
+
+  describe('getMe function', () => {
+    it('should be a function', () => {
+      expect(typeof window.authApi.getMe).toBe('function');
+    });
+
+    it('should return a Promise', () => {
+      const result = window.authApi.getMe('fake-token');
+      expect(result).toBeInstanceOf(Promise);
+    });
+  });
+});