Repo audit: fix security issues, bugs, and prepare HF Space deployment

Add comprehensive README with architecture, API reference, and usage guide

Sprint 0: project foundation — structure, settings, FastAPI skeleton