feat: 完善项目架构并增强分析页面功能

- 新增项目文档和 Docker 配置
  - 添加 README.md 和 TODO.md 项目文档
  - 为各服务添加 Dockerfile 和 docker-compose 配置

- 重构后端架构
  - 新增 adapter 层（HTTP/Python 适配器）
  - 新增 repository 层（数据访问抽象）
  - 新增 router 模块统一管理路由
  - 新增账单处理 handler

- 扩展前端 UI 组件库
  - 新增 Calendar、DateRangePicker、Drawer、Popover 等组件
  - 集成 shadcn-svelte 组件库

- 增强分析页面功能
  - 添加时间范围筛选器（支持本月默认值）
  - 修复 DateRangePicker 默认值显示问题
  - 优化数据获取和展示逻辑

- 完善分析器服务
  - 新增 FastAPI 服务接口
  - 改进账单清理器实现

analyzer/cleaners/base.py

@@ -85,6 +85,58 @@ def compute_date_range(args) -> tuple[date | None, date | None]:
     return start_date, end_date
 
 
+def compute_date_range_from_values(
+    year: str = None,
+    month: str = None,
+    start: str = None,
+    end: str = None
+) -> tuple[date | None, date | None]:
+    """
+    根据参数值计算日期范围（不依赖 argparse）
+    供 HTTP API 调用使用
+    
+    Returns:
+        (start_date, end_date) 或 (None, None) 表示不筛选
+    """
+    start_date = None
+    end_date = None
+    
+    # 1. 根据年份设置范围
+    if year:
+        y = int(year)
+        start_date = date(y, 1, 1)
+        end_date = date(y, 12, 31)
+    
+    # 2. 根据月份进一步收窄
+    if month:
+        m = int(month)
+        y = int(year) if year else datetime.now().year
+        
+        if not start_date:
+            start_date = date(y, 1, 1)
+            end_date = date(y, 12, 31)
+        
+        month_start = date(y, m, 1)
+        if m == 12:
+            month_end = date(y, 12, 31)
+        else:
+            month_end = date(y, m + 1, 1) - timedelta(days=1)
+        
+        start_date = max(start_date, month_start) if start_date else month_start
+        end_date = min(end_date, month_end) if end_date else month_end
+    
+    # 3. 根据 start/end 参数进一步收窄
+    if start:
+        custom_start = parse_date(start)
+        start_date = max(start_date, custom_start) if start_date else custom_start
+    
+    if end:
+        custom_end = parse_date(end)
+        end_date = min(end_date, custom_end) if end_date else custom_end
+    
+    return start_date, end_date
+
+
 def is_in_date_range(date_str: str, start_date: date | None, end_date: date | None) -> bool:
     """检查日期字符串是否在指定范围内"""
     if start_date is None and end_date is None: