about summary refs log tree commit diff
path: root/docs
diff options
context:
space:
mode:
authorFrederick Muriuki Muriithi <fredmanglis@gmail.com>2026-11-06 20:53:58 +0000
committerFrederick Muriuki Muriithi <fredmanglis@gmail.com>2026-11-06 14:57:55 -0600
commit21c0919a67f55baf4063487621709f94905463ee (patch)
tree4b4de173521c8aab5006f6e6288e13ef5c06a221 /docs
parent5874283dcef47b25e2bbacf77260ebfb142edd15 (diff)
downloadgn-uploader-21c0919a67f55baf4063487621709f94905463ee.tar.gz
docs: record collector error exit and pending normalisation/error handlers
Co-authored-by: pi coding agent <pi@pi.dev>
Diffstat (limited to 'docs')
-rw-r--r--docs/WIP/geno-uploads-implementation-notes.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/WIP/geno-uploads-implementation-notes.md b/docs/WIP/geno-uploads-implementation-notes.md
index 89bda61..1b9c1bd 100644
--- a/docs/WIP/geno-uploads-implementation-notes.md
+++ b/docs/WIP/geno-uploads-implementation-notes.md
@@ -182,10 +182,22 @@ collector job, runs the checks and exits non-zero on errors. On Stage 02 save,
 the QC job is scheduled and its id recorded in the collector job metadata
 (`stage03_job_id`) so re-submitting does not schedule it again.
 
+The collector exits with `SysExit.GENERALERROR` when `FileStats.errors` is
+non-empty, so malformed files stop the chain before Stage 02.
+
 `uploader.genotypes.qc.sort_markers` is a placeholder ordering helper
 (chromosome, cM, Mb) that emits a warning until the appropriate ordering is
 established.
 
+### Pending: normalisation, comment scoping and error handlers
+
+- Stage 03 will untranspose transposed files first, producing a canonical
+  `work_file` for QC and later stages.
+- The collector will only feed comments before the data matrix into
+  `description`.
+- Each stage will register an `error_handler` (FileStats errors shown like the
+  phenotypes job status page; other failures reported with recovery guidance).
+
 ## Relationship to the background-jobs system
 
 The current job model is effectively "one script == one job". The genotype