Knowledge Adapter Service

Small Python 3.12/FastAPI adapter for Dify External Knowledge retrieval through an existing WeKnora deployment, with stable UUID image URLs backed by a Private Alibaba Cloud OSS bucket.

Status

Slices 1–8 provide implementation, automated tests, and prepared delivery artifacts. Production deployment is not authorized. Slice 9 must complete real test-environment Dify → Adapter → WeKnora → OSS E2E and produce an audit report before a production decision.

Documentation

• Architecture
• Security model
• Test deployment and rollback
• Key and credential rotation
• Slice 9 verification and E2E audit

Local validation

make check

Compose rendering requires an external non-secret env file:

make compose-config ENV_FILE=/absolute/path/to/adapter.env

Neither target starts containers. image-build is explicit and requires Docker access; no target deploys or modifies production.