企迹(qiji) 政企周报管理系统 — v0.1

后端: FastAPI + SQLAlchemy 2.0 (async) + Alembic + MinIO + Casdoor + 企微
前端: Vue 3 + Vite + TypeScript + Element Plus + Pinia

功能清单:
- 8 张数据表自动建表 / Casdoor OIDC 登录 / 企微静默登录
- 双布局: 移动端(填报) + PC端(汇总管理)
- 拜访记录 CRUD + MinIO 照片直传 + 缩略图预览 + 同访人草稿
- 今日纪要 (6 分类) / 工作计划 / 小微商机 / 要客拜访 CRUD
- 客户档案: 备注/收支费用/联系人/归属分配/批量转移
- 客户导入导出 + 模板下载 + 搜索/分页/筛选
- 仪表盘: 四卡统计 + 填报进度 (拜访+纪要双维度)
- 周报详情: 五 Tab + 按人/客户筛选 + 时间轴
- 用户管理 / 客户经理 PC 端工作台
- 企微: 催办/公告/定时提醒 / 时区修正
- Docker 部署配置

Co-Authored-By: Claude <noreply@anthropic.com>

backend/app/services/minio_client.py

@@ -0,0 +1,43 @@
+from datetime import timedelta
+from minio import Minio
+from app.config import settings
+
+_client: Minio | None = None
+
+
+def get_minio_client() -> Minio:
+    global _client
+    if _client is None:
+        _client = Minio(
+            settings.MINIO_ENDPOINT,
+            access_key=settings.MINIO_ACCESS_KEY,
+            secret_key=settings.MINIO_SECRET_KEY,
+            secure=settings.MINIO_SECURE,
+        )
+        # Ensure bucket exists
+        if not _client.bucket_exists(settings.MINIO_BUCKET):
+            _client.make_bucket(settings.MINIO_BUCKET)
+    return _client
+
+
+def generate_presigned_upload_url(object_key: str, expires: int = 600) -> str:
+    """Generate a presigned PUT URL for direct upload to MinIO."""
+    client = get_minio_client()
+    return client.presigned_put_object(settings.MINIO_BUCKET, object_key, expires=timedelta(seconds=expires))
+
+
+def generate_presigned_download_url(object_key: str, expires: int = 3600) -> str:
+    """Generate a presigned GET URL for viewing/downloading an object."""
+    client = get_minio_client()
+    return client.presigned_get_object(settings.MINIO_BUCKET, object_key, expires=timedelta(seconds=expires))
+
+
+def delete_objects(object_keys: list[str]) -> None:
+    """Delete multiple objects from MinIO."""
+    if not object_keys:
+        return
+    client = get_minio_client()
+    from minio.deleteobjects import DeleteObject
+    errors = client.remove_objects(settings.MINIO_BUCKET, [DeleteObject(k) for k in object_keys])
+    for err in errors:
+        pass  # Log errors in production