kobotoolbox / kpi / 12182498187

81%

master: 76%

push

github

feat(projectHistoryLogs): add endpoints for viewing project history logs TASK-973 (#5319)

### 📣 Summary
Add two new endpoints for viewing project history logs, one for all
logs, and one for logs for a given project.


### 📖 Description
Adds two new endpoints: `/api/v2/project-history-logs` (all project
history logs) and `/api/v2/assets/<uid>/history` (logs for the specific
project).
The former is only available to superusers, the latter is available to
anyone with the manage_asset permission for the project.
Both endpoints can be searched by a all fields, most importantly
`action`, `metadata__asset_uid`, and `username`. A full list of
available searchable fields is in the endpoint documentation.


### 👀 Preview steps


Feature/no-change template:
1. ℹ️ have two accounts, one super and one not. Have at least two
projects.
2. Change the name of both projects to generate some logs.
3. Log in as the superuser.
4. Go to `localhost/api/v2/project-history-logs`
5. 🟢 You should see logs for both projects
6. Grant the non-superuser the manage_project permission for one of the
projects (they will have this if they are the owner, or you can assign
it from Settings > Sharing)
7. Log out
8. 🟢 Go to `localhost/api/v2/project-history-logs`. You should get a
401.
9. Log in as the non-superuser.
10. 🟢 Go to `localhost/api/v2/project-history-logs`. You should get a
403.
11. Go to `localhost/api/v2/assets/<asset_uid>/history`
12. 🟢 You should see project history logs for just that project
13. Revoke the manage_project permission for the user. You can do this
by transferring ownership or just removing the singular permission (will
require you to log back in as the superuser).
14. 🟢 Reload `localhost/api/v2/assets/<asset_uid>/history`. You should
get a 403.

5751 of 9232 branches covered (62.29%)

42 of 42 new or added lines in 5 files covered. (100.0%)

21968 of 27329 relevant lines covered (80.38%)

0.8 hits per line