added

Author: Syntax-Error-1337

version 2/.env.example

@@ -0,0 +1,15 @@
+# Database Configuration
+TEMP_MAIL_DB_ID=c82663ac-62b6-4ba6-be81-cbe297f2a3dd
+
+# Mail Configuration
+MAIL_DOMAIN=temp.example.com
+RESEND_API_KEY=your_resend_api_key_here
+
+# Security
+ADMIN_PASSWORD=change_me_secure_password
+ADMIN_NAME=admin
+JWT_TOKEN=change_me_jwt_secret_key
+SESSION_EXPIRE_DAYS=7
+
+# Optional: Forwarding
+# FORWARD_RULES="[{\"prefix\":\"vip\",\"email\":\"a@example.com\"},{\"prefix\":\"*\",\"email\":\"admin@example.com\"}]"

version 2/DEPLOY.md

@@ -0,0 +1,64 @@
+# Deploy Guide
+
+## Prerequisites
+
+- Node.js & npm installed
+- Cloudflare Wrangler CLI installed (`npm install -g wrangler`)
+- A Cloudflare account
+
+## Setup
+
+1.  **Install dependencies**:
+    ```bash
+    npm install
+    ```
+
+2.  **Configure Environment**:
+    -   Copy `.env.example` to `.env` (for local development using Vite's proxy, though `wrangler.toml` handles production vars).
+    -   Update `wrangler.toml` with your D1 Database ID and Name.
+    -   Set secrets in Cloudflare dashboard OR via wrangler:
+        ```bash
+        wrangler secret put ADMIN_PASSWORD
+        wrangler secret put JWT_TOKEN
+        wrangler secret put RESEND_API_KEY
+        # ... other variables
+        ```
+
+3.  **Database Initialization**:
+    -   If you haven't created the database yet:
+        ```bash
+        wrangler d1 create maill_free_db
+        ```
+    -   Initialize the schema:
+        ```bash
+        wrangler d1 execute maill_free_db --file=d1-init.sql
+        ```
+
+## Development
+
+1.  **Frontend & Backend**:
+    -   Run `npm run dev` to start the Vite dev server.
+    -   Note: The Vite dev server proxies API requests to `http://localhost:8787`. You will need to run the worker locally separately or adjust the proxy target.
+    -   **Better Approach**: Run `wrangler dev` to serve both the worker and the static assets (after building).
+
+    ```bash
+    npm run build
+    wrangler dev
+    ```
+
+## Deployment
+
+1.  **Build Frontend**:
+    ```bash
+    npm run build
+    ```
+
+2.  **Deploy to Cloudflare Workers**:
+    ```bash
+    wrangler deploy
+    ```
+
+## Verification
+
+-   Visit your worker URL (e.g., `https://freemail-v2.your-subdomain.workers.dev`).
+-   Log in with the credentials you set.

version 2/README.md

@@ -6,6 +6,10 @@ A modern, responsive frontend for the Freemail application, built with React, Vi
 - **Modern UI**: Clean interface built with Tailwind CSS v4.
 - **Authentication**: Secure login for Admins, Users, and Mailbox accounts.
 - **Dashboard**: Overview of system status and mailboxes.
+- **Mailbox Management**: 
+    - **Favorites**: Star important mailboxes for quick access.
+    - **Filtering**: Easily filter by All, Favorites, or Forwarding status.
+    - **Forwarding**: Set up auto-forwarding rules for mailboxes.
 - **Mailbox**: Real-time email listing and reading with sanitized HTML view.
 - **Responsive**: Fully optimized for mobile and desktop.
 
@@ -33,8 +37,10 @@ The frontend is configured to proxy API requests to `http://localhost:8787`.
 To change this, edit `vite.config.ts`.
 
 ## Deployment
+See [DEPLOY.md](DEPLOY.md) for detailed deployment instructions using Cloudflare Workers.
+
 To build for production:
 ```bash
 npm run build
 ```
-The output will be in the `dist` directory.
+The output will be in the `dist` directory, which is served by the Cloudflare Worker.

version 2/d1-init.sql

@@ -0,0 +1,106 @@
+-- Cloudflare D1 数据库初始化脚本
+-- 首次部署时执行：wrangler d1 execute DB --file=./d1-init.sql
+
+-- 启用外键约束
+PRAGMA foreign_keys = ON;
+
+-- 邮箱地址表
+CREATE TABLE IF NOT EXISTS mailboxes (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  address TEXT NOT NULL UNIQUE,
+  local_part TEXT NOT NULL,
+  domain TEXT NOT NULL,
+  password_hash TEXT,
+  created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+  last_accessed_at TEXT,
+  expires_at TEXT,
+  is_pinned INTEGER DEFAULT 0,
+  can_login INTEGER DEFAULT 0,
+  forward_to TEXT DEFAULT NULL,
+  is_favorite INTEGER DEFAULT 0
+);
+
+-- 邮件消息表
+CREATE TABLE IF NOT EXISTS messages (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  mailbox_id INTEGER NOT NULL,
+  sender TEXT NOT NULL,
+  to_addrs TEXT NOT NULL DEFAULT '',
+  subject TEXT NOT NULL,
+  verification_code TEXT,
+  preview TEXT,
+  r2_bucket TEXT NOT NULL DEFAULT 'mail-eml',
+  r2_object_key TEXT NOT NULL DEFAULT '',
+  received_at TEXT DEFAULT CURRENT_TIMESTAMP,
+  is_read INTEGER DEFAULT 0,
+  FOREIGN KEY(mailbox_id) REFERENCES mailboxes(id)
+);
+
+-- 用户表
+CREATE TABLE IF NOT EXISTS users (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  username TEXT NOT NULL UNIQUE,
+  password_hash TEXT,
+  role TEXT NOT NULL DEFAULT 'user',
+  can_send INTEGER NOT NULL DEFAULT 0,
+  mailbox_limit INTEGER NOT NULL DEFAULT 10,
+  created_at TEXT DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 用户-邮箱关联表
+CREATE TABLE IF NOT EXISTS user_mailboxes (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  user_id INTEGER NOT NULL,
+  mailbox_id INTEGER NOT NULL,
+  created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+  is_pinned INTEGER NOT NULL DEFAULT 0,
+  UNIQUE(user_id, mailbox_id),
+  FOREIGN KEY(user_id) REFERENCES users(id) ON DELETE CASCADE,
+  FOREIGN KEY(mailbox_id) REFERENCES mailboxes(id) ON DELETE CASCADE
+);
+
+-- 发送邮件记录表
+CREATE TABLE IF NOT EXISTS sent_emails (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  resend_id TEXT,
+  from_name TEXT,
+  from_addr TEXT NOT NULL,
+  to_addrs TEXT NOT NULL,
+  subject TEXT NOT NULL,
+  html_content TEXT,
+  text_content TEXT,
+  status TEXT DEFAULT 'queued',
+  scheduled_at TEXT,
+  created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+  updated_at TEXT DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 创建索引
+
+-- mailboxes 索引
+CREATE INDEX IF NOT EXISTS idx_mailboxes_address ON mailboxes(address);
+CREATE INDEX IF NOT EXISTS idx_mailboxes_is_pinned ON mailboxes(is_pinned DESC);
+CREATE INDEX IF NOT EXISTS idx_mailboxes_address_created ON mailboxes(address, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_mailboxes_is_favorite ON mailboxes(is_favorite DESC);
+
+-- messages 索引
+CREATE INDEX IF NOT EXISTS idx_messages_mailbox_id ON messages(mailbox_id);
+CREATE INDEX IF NOT EXISTS idx_messages_received_at ON messages(received_at DESC);
+CREATE INDEX IF NOT EXISTS idx_messages_r2_object_key ON messages(r2_object_key);
+CREATE INDEX IF NOT EXISTS idx_messages_mailbox_received ON messages(mailbox_id, received_at DESC);
+CREATE INDEX IF NOT EXISTS idx_messages_mailbox_received_read ON messages(mailbox_id, received_at DESC, is_read);
+
+-- users 索引
+CREATE INDEX IF NOT EXISTS idx_users_username ON users(username);
+
+-- user_mailboxes 索引
+CREATE INDEX IF NOT EXISTS idx_user_mailboxes_user ON user_mailboxes(user_id);
+CREATE INDEX IF NOT EXISTS idx_user_mailboxes_mailbox ON user_mailboxes(mailbox_id);
+CREATE INDEX IF NOT EXISTS idx_user_mailboxes_user_pinned ON user_mailboxes(user_id, is_pinned DESC);
+CREATE INDEX IF NOT EXISTS idx_user_mailboxes_composite ON user_mailboxes(user_id, mailbox_id, is_pinned);
+
+-- sent_emails 索引
+CREATE INDEX IF NOT EXISTS idx_sent_emails_resend_id ON sent_emails(resend_id);
+CREATE INDEX IF NOT EXISTS idx_sent_emails_status_created ON sent_emails(status, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_sent_emails_from_addr ON sent_emails(from_addr);
+

version 2/src/pages/dashboard/index.tsx

@@ -4,7 +4,7 @@ import { apiFetch } from '@/lib/api';
 import { Card, CardContent, CardHeader, CardTitle, CardDescription } from '@/components/ui/card';
 import { Button } from '@/components/ui/button';
 import { Link } from 'react-router-dom';
-import { Mail, Users, Trash2, ExternalLink } from 'lucide-react';
+import { Mail, Users, Trash2, ExternalLink, Star } from 'lucide-react';
 import toast from 'react-hot-toast';
 import { formatDistanceToNow } from 'date-fns';
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
@@ -15,12 +15,15 @@ interface Mailbox {
     address: string;
     created_at: string;
     email_count?: number;
+    is_favorite?: boolean;
+    forward_to?: string;
 }
 
 export default function Dashboard() {
     const { user } = useAuth();
     const [mailboxes, setMailboxes] = useState<Mailbox[]>([]);
     const [isLoading, setIsLoading] = useState(false);
+    const [filter, setFilter] = useState<'all' | 'favorites' | 'forwarding'>('all');
 
     const isMailboxUser = user?.role === 'mailbox';
     const isAdmin = user?.role === 'admin';
@@ -29,9 +32,13 @@ export default function Dashboard() {
         if (isMailboxUser) return;
         setIsLoading(true);
         try {
-            const data = await apiFetch<any>('/api/mailboxes?limit=10');
-            if (data.success && Array.isArray(data.results)) {
-                setMailboxes(data.results);
+            let url = '/api/mailboxes?limit=20';
+            if (filter === 'favorites') url += '&favorite=true';
+            if (filter === 'forwarding') url += '&forward=true';
+
+            const data = await apiFetch<any>(url);
+            if (data.success && Array.isArray(data.results || data.list)) {
+                setMailboxes(data.results || data.list);
             }
         } catch (error) {
             console.error('Failed to fetch mailboxes');
@@ -42,7 +49,22 @@ export default function Dashboard() {
 
     useEffect(() => {
         fetchMailboxes();
-    }, [user]);
+    }, [user, filter]);
+
+    const toggleFavorite = async (mailbox: Mailbox) => {
+        try {
+            await apiFetch('/api/mailbox/favorite', {
+                method: 'POST',
+                body: JSON.stringify({ mailbox_id: mailbox.id })
+            });
+            setMailboxes(mailboxes.map(m =>
+                m.id === mailbox.id ? { ...m, is_favorite: !m.is_favorite } : m
+            ));
+            toast.success(mailbox.is_favorite ? 'Removed from favorites' : 'Added to favorites');
+        } catch (error) {
+            toast.error('Failed to update favorite status');
+        }
+    };
 
     const handleDeleteMailbox = async (id: number) => {
         if (!confirm('Delete this mailbox?')) return;
@@ -121,11 +143,37 @@ export default function Dashboard() {
                     </div>
 
                     <Card className="col-span-3">
-                        <CardHeader>
-                            <CardTitle>Recent Mailboxes</CardTitle>
-                            <CardDescription>
-                                Manage your temporary mailboxes here.
-                            </CardDescription>
+                        <CardHeader className="flex flex-row items-center justify-between">
+                            <div>
+                                <CardTitle>Recent Mailboxes</CardTitle>
+                                <CardDescription>
+                                    Manage your temporary mailboxes here.
+                                </CardDescription>
+                            </div>
+                            <div className="flex bg-muted p-1 rounded-md">
+                                <Button
+                                    variant={filter === 'all' ? 'secondary' : 'ghost'}
+                                    size="sm"
+                                    onClick={() => setFilter('all')}
+                                >
+                                    All
+                                </Button>
+                                <Button
+                                    variant={filter === 'favorites' ? 'secondary' : 'ghost'}
+                                    size="sm"
+                                    onClick={() => setFilter('favorites')}
+                                    className="gap-2"
+                                >
+                                    <Star className="h-3 w-3" /> Favorites
+                                </Button>
+                                <Button
+                                    variant={filter === 'forwarding' ? 'secondary' : 'ghost'}
+                                    size="sm"
+                                    onClick={() => setFilter('forwarding')}
+                                >
+                                    Forwarding
+                                </Button>
+                            </div>
                         </CardHeader>
                         <CardContent>
                             <div className="space-y-4">
@@ -137,11 +185,26 @@ export default function Dashboard() {
                                                     <Mail className="h-4 w-4 text-primary" />
                                                 </div>
                                                 <div>
-                                                    <p className="font-medium">{mb.address}</p>
+                                                    <div className="flex items-center gap-2">
+                                                        <p className="font-medium">{mb.address}</p>
+                                                        {mb.forward_to && (
+                                                            <span className="text-[10px] bg-blue-100 text-blue-700 dark:bg-blue-900/30 dark:text-blue-300 px-1.5 py-0.5 rounded-full">
+                                                                Forwarding
+                                                            </span>
+                                                        )}
+                                                    </div>
                                                     <p className="text-xs text-muted-foreground">Created {formatDistanceToNow(new Date(mb.created_at), { addSuffix: true })}</p>
                                                 </div>
                                             </div>
                                             <div className="flex items-center gap-2">
+                                                <Button
+                                                    variant="ghost"
+                                                    size="icon"
+                                                    onClick={() => toggleFavorite(mb)}
+                                                    className={mb.is_favorite ? "text-yellow-500 hover:text-yellow-600 hover:bg-yellow-100/50" : "text-muted-foreground hover:text-yellow-500"}
+                                                >
+                                                    <Star className={`h-4 w-4 ${mb.is_favorite ? "fill-current" : ""}`} />
+                                                </Button>
                                                 <Button variant="ghost" size="icon" asChild>
                                                     <Link to={`/mailbox?mailbox=${mb.address}`}><ExternalLink className="h-4 w-4" /></Link>
                                                 </Button>