docs: add portal docs

docs: update architecture decision records and interface contracts to clarify edgeCloudProvider mapping and topology hiding rules