pal-e-docs
Project not found.

Phase 25: MinIO API — FastAPI REST Service

phase-pal-e-platform-25-minio-api Phase

phase
Project
Goal: Expose the MinIO SDK as a FastAPI REST service, Dockerized and deployable to k3s, with credentials server-side.
Owner: Dev agent
Repo: forgejo_admin/minio-api (to be created)
Depends on: phase-pal-e-platform-24-minio-sdk (SDK must be published first)

Scope

  • FastAPI service wrapping all SDK operations as REST endpoints
  • JSON request/response (SDK handles XML-to-Python translation internally)
  • MinIO credentials stored server-side (env vars / k8s secrets) — never exposed to frontend
  • Presigned URL generation endpoint — frontend uses presigned URLs for direct upload/download
  • Dockerfile + Woodpecker CI pipeline
  • Harbor image registry integration
  • k8s deployment via pal-e-deployments (kustomize overlay)
  • Tailscale funnel for API access

API Design

Testing

  • API integration tests using httpx test client
  • Tests hit real MinIO via the SDK

Deliverables

  • Filled after completion
  • plan-pal-e-platform — parent plan
  • phase-pal-e-platform-24-minio-sdk — Phase 24, SDK this service wraps
  • phase-pal-e-platform-26-minio-playground — Phase 26, playground UI (parallel)
  • phase-pal-e-platform-27-minio-sveltekit — Phase 27, final integration