Architecture¶
bijux-proteomics-core architecture is where the repository's governing domain
rules become explicit. This section should help a reader see how protein
programs, lifecycle checks, assays, reviews, and execution contracts fit
together before runtime or intelligence packages act on them.
flowchart LR
targets["targets and sequences"]
programs["program specs<br/>programs, context"]
assays["assays and criteria"]
reviews["reviews and liabilities"]
lifecycle["lifecycle and validation"]
execution["execution contracts"]
adapters["runtime adapter<br/>repository seams"]
targets --> programs
assays --> lifecycle
programs --> lifecycle
reviews --> lifecycle
lifecycle --> execution --> adapters
Architectural Promise¶
- program meaning is decided here before orchestration starts
- lifecycle progression should be explainable from explicit contracts, not from incidental runtime behavior
- downstream packages may consume these rules, but they should not have to reinvent them
Start With¶
- open Execution Model when the question is how program state becomes execution readiness without collapsing into runtime orchestration
- open Module Map when you need the owning domain files for a concrete noun such as review, assay, program, or target
- open Integration Seams when a change seems to pull runtime control or recommendation logic inward
Read This Section To Answer¶
- where stage progression authority actually lives: Lifecycle and Validation
- how domain structures stay legible: State and Persistence and Code Navigation
- what can be safely extended: Extensibility Model and Architecture Risks
First Proof Check¶
src/bijux_proteomics/program_spec.py,programs.py, andtargets.pyfor durable contractssrc/bijux_proteomics/lifecycle.py,validation.py, andexecution_contracts.pyfor readiness and execution rulessrc/bijux_proteomics/biology/,domain/, andruntime_adapter.pyfor structural seams to neighboring concerns
Boundary Test¶
If a rule changes who may advance a program or what counts as ready, the answer should be obvious in this package before any runtime workflow is consulted.