Managing, organising and publishing APT repositories became a nightmare for us as well. That's why OpenAPT is alive.
It moves APT management from script paradigm to state description paradigm. Indeed with OpenAPT, you don't have to write command lines anymore but instead you describe the state you want to achieve. Just like Ansible does.
Btw, it's a brand-new project. If documentation is lacking, feel free to open issue(s). We will be happy to help you.