HPR/hpr_documentation
8
0
Fork 2
Code Issues 9 Pull Requests Actions Packages Projects Releases Wiki Activity

Update queue documentation

Browse Source
This commit is contained in:
Ken Fallon
2026-05-27 16:48:05 +02:00
parent aa3a681e5c
commit b9a461eb1b
2 changed files with 218 additions and 81 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
workflow/processing_a_show.md
View File

@@ -17,8 +17,8 @@ The files are downloaded by trusted Janitors that have the ability to `scp`/`rsy
The directory structure is based on a combination of fields separated by the underscore (`_`) delimiter.
- Upload date and time `UTC_TIMESTAMP()` at reservation time.
- The requested `episode number` or `9999` if the reserve queue is to be used.
- The requested `epidode date` or `1970-01-01` if the reserve queue is to be used.
- The requested `episode number` or `9999` if the reserve pool is to be used.
- The requested `epidode date` or `1970-01-01` if the reserve pool is to be used.
- The random unique key for this request.
```
@@ -30,9 +30,9 @@ The upload will produce at a minimum a `shownote.json` file. It may also include
Addition files and images may be provided by the host, eg: images, scripts, pdf documents etc.
Shows destined for the reserve queue are moved from the upload directory and placed in the reserve directory using the script [rename-reserve.bash](https://repo.anhonesthost.net/HPR/hpr-tools/src/branch/main/workflow/rename-reserve.bash).
Shows destined for the reserve pool are moved from the upload directory and placed in the reserve directory using the script [rename-reserve.bash](https://repo.anhonesthost.net/HPR/hpr-tools/src/branch/main/workflow/rename-reserve.bash).
This is run manually by the Janitors as it checks to see if a url to the show was provided, and attempts to download the linked file. When new hosts submit a show directly to the reserve queue, the Janitors will resubmit it to the first available slot in the normal queue. This is because new hosts need to have an entry created in the `hosts` table, but also because it gives the community an opportunity to welcome the new host.
This is run manually by the Janitors as it checks to see if a url to the show was provided, and attempts to download the linked file. When new hosts submit a show directly to the reserve pool, the Janitors will resubmit it to the first available slot in the normal queue. This is because new hosts need to have an entry created in the `hosts` table, but also because it gives the community an opportunity to welcome the new host.
It renames the directory structure based on a combination of fields separated by the underscore (`_`) delimiter.
@@ -45,7 +45,7 @@ It renames the directory structure based on a combination of fields separated by
```
2339680845_987_4bd713699e5bc0978d5fef85a60f09bc7f70ef3488624_Emperor_Ming_Top_tips_for_time_travel
```
Reserve shows are downloaded and submitted by the Janitors on behalf of the host. This follows the normal posting process where the host and Janitors are cc'd on the notification emails. The only difference is that the audio is edited to include a notification that the show is from the reserve queue, and that it is the Janitors that upload the show via the supplied link.
Reserve shows are downloaded and submitted by the Janitors on behalf of the host. This follows the normal posting process where the host and Janitors are cc'd on the notification emails. The only difference is that the audio is edited to include a notification that the show is from the reserve pool, and that it is the Janitors that upload the show via the supplied link.
## Adding the host to the `hosts` table