refactor service.py to be more clear

[garland3]

better separation of concerns.
refactor other parts as needed.
this will be a lot of work.

[garland3]

This is a plan. docs/service-refactor-plan.md on how to do this.