Networks
Regional network management and coordination
15 stories across 4 personas | Coverage: 15/15 (100%)
Overview
Networks
Networks are regional organisations that groups can belong to. They provide a layer of coordination and oversight above individual groups -- for example, a national repair network might coordinate dozens of local repair groups.
What NetworkCoordinators can do
NetworkCoordinators manage their assigned networks. They can view their networks, see network details and statistics, edit network information and upload logos, and add groups to their network. They can also view network statistics via the API.
What Admins can do
Admins can view all networks on the platform and perform any action a NetworkCoordinator can across all networks.
What Guests can do
Guests can list all networks, view network details, and browse a network's groups and events via the public API.
What ThirdParties can do
External organisations can retrieve network listings, details, groups, and events via the public API to display on their own platforms.
Browse networks
| Persona | Story | Method | Tests |
|---|---|---|---|
| Admin | As an Admin, I can view all networks on the platform | NetworkController::index | ✅ Covered |
| Guest | As a Guest, I can list all networks via the API | NetworkController::getNetworksv2 | ✅ Covered |
| Guest | As a Guest, I can view network details via the API | NetworkController::getNetworkv2 | ✅ Covered |
| NetworkCoordinator | As a NetworkCoordinator, I can view the networks I coordinate | NetworkController::index | ✅ Covered |
| NetworkCoordinator | As a NetworkCoordinator, I can view my network's details and statistics | NetworkController::show | ✅ Covered |
| ThirdParty | As a ThirdParty, I can retrieve all networks to display on my platform | NetworkController::getNetworksv2 | ✅ Covered |
| ThirdParty | As a ThirdParty, I can retrieve network details via the API | NetworkController::getNetworkv2 | ✅ Covered |
Manage network details
| Persona | Story | Method | Tests |
|---|---|---|---|
| NetworkCoordinator | As a NetworkCoordinator, I can access the form to edit my network | NetworkController::edit | ✅ Covered |
| NetworkCoordinator | As a NetworkCoordinator, I can update my network's details and logo | NetworkController::update | ✅ Covered |
Network groups & events
| Persona | Story | Method | Tests |
|---|---|---|---|
| Guest | As a Guest, I can list events for a network via the API | NetworkController::getNetworkEventsv2 | ✅ Covered |
| Guest | As a Guest, I can list groups for a network via the API | NetworkController::getNetworkGroupsv2 | ✅ Covered |
| NetworkCoordinator | As a NetworkCoordinator, I can add groups to my network | NetworkController::associateGroup | ✅ Covered |
| ThirdParty | As a ThirdParty, I can retrieve events for a network to display on my platform | NetworkController::getNetworkEventsv2 | ✅ Covered |
| ThirdParty | As a ThirdParty, I can retrieve groups for a network to display on my platform | NetworkController::getNetworkGroupsv2 | ✅ Covered |
Network stats
| Persona | Story | Method | Tests |
|---|---|---|---|
| NetworkCoordinator | As a NetworkCoordinator, I can view my network's statistics via the API | NetworkController::stats | ✅ Covered |