knowledge-adapter-service/README.md

# 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](docs/architecture.md)
- [Security model](docs/security.md)
- [Test deployment and rollback](docs/deployment.md)
- [Key and credential rotation](docs/key-rotation.md)
- [Slice 9 verification and E2E audit](docs/audit-report-slice9.md)

## Local validation

```text
make check
```

Compose rendering requires an external non-secret env file:

```text
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.