docs: implement system architecture, API specs, deployment guide, enhance demo seed, and setup integration tests