docs: refresh project README

[KariMuhammad]

Summary

• replace the oversized README with implementation-specific API documentation
• document the feature-based architecture, environment variables, setup, scripts, and route groups
• clarify the current implementation status and gaps

Validation

• checked the documentation against the repository source and configuration
• ran git diff --check

Documentation only; no application code changed.