feat: 资产 CRUD API + 统计接口 + Vue3 管理前端（可选 API Key 鉴权）

app/core/__init__.py

@@ -0,0 +1 @@
+"""核心配置与安全模块"""

app/core/config.py

@@ -0,0 +1,23 @@
+"""应用配置
+
+从项目根目录的 .env 文件加载配置（若存在）。
+API_KEY 留空表示不启用写操作鉴权（适用于纯内网环境）。
+"""
+
+import os
+from pathlib import Path
+
+from dotenv import load_dotenv
+
+BASE_DIR = Path(__file__).resolve().parent.parent.parent
+load_dotenv(BASE_DIR / ".env")
+
+
+class Settings:
+    """应用配置项"""
+
+    APP_NAME: str = os.getenv("APP_NAME", "VPS 资产管理系统")
+    API_KEY: str = os.getenv("API_KEY", "")
+
+
+settings = Settings()

app/core/security.py

@@ -0,0 +1,25 @@
+"""API Key 认证依赖
+
+用于保护写操作（POST/PUT/DELETE）。
+- 若 settings.API_KEY 为空，则放行所有请求（纯内网场景）。
+- 若已配置，则要求请求头携带正确的 X-API-Key，否则返回 401。
+"""
+
+from typing import Optional
+
+from fastapi import Header, HTTPException, status
+
+from app.core.config import settings
+
+
+async def require_api_key(
+    x_api_key: Optional[str] = Header(default=None, alias="X-API-Key"),
+) -> None:
+    """校验 API Key（可选启用）"""
+    if not settings.API_KEY:
+        return
+    if x_api_key != settings.API_KEY:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="API Key 无效或缺失",
+        )