Cited sources in the care app: every target, reminder and stage links to a trusted reference (extension and peer-reviewed first); a Learn page per plant #626

shipped merged trevatoowner opened this 17d ago smithcrew has it

trevatoowner opened this 17d ago

Owner, 2026-10-27: "i want cited sources in the app. like these things that i need to learn should have references so I can read and learn more from trusted sources."

Every piece of guidance the app shows carries its source: each target range, each reminder's "why", each stage's timeline and each problem's signs. A footnote marker links to a reference the owner can open and read. This is also what makes it a kit people can trust.

Model: the plant profile (#585) is data. Each value gets sources: [{id, claim}], and one references table holds {id, title, publisher, url, kind: "extension" | "peer-reviewed" | "grower" | "vendor", accessed}. A value with no source is labelled "grower consensus (unsourced)" in the UI, never shown as fact.

UI:

A small superscript on every value (e.g. "pH 5.5–6.5 ¹"). Tap shows the source title, publisher and kind, a "Read" link (new tab), and the exact claim it supports.
A "Learn" page per plant: the sources grouped by topic (light, nutrients, climate, timeline, problems), each with one line on what it covers. Extension and peer-reviewed sources come first.
Reminders say why, with the source: "Top off every 2–3 days: small reservoirs drift¹".

Verified sources for spinach (from the steward's research, 2026-10-26; use these ids):

id	reference	kind	supports
cornell-cea-spinach	Cornell CEA, Spinach final report — https://cea.cals.cornell.edu/files/2019/07/Spinachfinal-report.pdf	extension	DLI 17 mol/m²/d (baby leaf); air 20–25 °C; solution cooled to 20 °C vs Pythium; respace ~day 9; second cutting benefit; 1500 plants/m² baby-leaf density
cornell-gpn-2016	Cornell CEA / GPN Oct 2016, Leafy greens — https://cea.cals.cornell.edu/files/2019/06/GPNOctober2016_LeafyGreens.pdf	extension	germination ~3 days at ≤25 °C; seedling DLI (lettuce-based)
osa-spinach-manual	Organic Seed Alliance, Spinach seed production manual — https://projects.sare.org/wp-content/uploads/1626spinach_seed_manual.pdf	grower (research-based)	long-day plant; older lines bolt at ≥14 h, modern lines at about 16 h
uaf-spinach	Univ. of Alaska Fairbanks, It Grows in Alaska (citing Parlevliet) — https://itgrowsinalaska.community.uaf.edu/?p=1246	extension	photoperiod and bolting response
mdpi-agronomy-2020	Agronomy 2020, 10(8):1082 — https://www.mdpi.com/2073-4395/10/8/1082	peer-reviewed	DLI 11.5–20.2 tested for spinach
hydrobuilder-spinach	Hydrobuilder, Hydroponic spinach — https://learn.hydrobuilder.com/hydroponic-spinach/	vendor	pH 5.5–6.5; 10–14 h light; germination vs temperature (Colorado State figure)
rise-spinach	Rise Gardens, Hydroponic spinach tips — https://risegardens.com/blogs/communitygarden/hydroponic-spinach-growing-tips-and-tricks	vendor	practical tips

Unsourced today (label them until the steward's follow-up research adds sources): top-off and change cadence, night temperature, humidity, the rockwool/germination EC, the heat-mat guidance, and sensor prices.

Done when:

The profile carries sources for every value, and an unsourced value renders the "grower consensus" label.
Superscripts plus a tap card, and the Learn page.
Reminders show their why and its source.
Tests: every spinach value either has a source id that resolves in references or carries the unsourced label; every reference URL is https; the Learn page lists extension and peer-reviewed sources first.

Files: the care profile data, Software/so101/src (care rendering), tests

trevatoowner commented 17d ago

More sources (steward research, 2026-10-27; each one opened and read), plus corrections to unsourced advice. Add these to references:

id	reference	kind	supports
cornell-gpn-2016	Mattson (Cornell CEA), Growing Hydroponic Leafy Greens, GPN Oct 2016: https://cea.cals.cornell.edu/files/2019/06/GPNOctober2016_LeafyGreens.pdf	extension	seeds surface-sown in rockwool, sub-irrigated ("overhead watering may retard germination"); seedlings fed from day 0 at 100–150 ppm N; ≥50 µmol/m²/s (DLI ≥4) during germination against stretching; seedling DLI 22; 24/19 °C day/night; RH 50–70%; transplant at 3–4 true leaves (about day 11 in high light); baby-leaf spinach "much more susceptible to Pythium root rot". Lettuce data unless noted.
uky-hydro-lettuce	Kaiser & Ernst, Hydroponic Lettuce, CCD-CP-63, Univ. of Kentucky Extension, 2016: https://publications.ca.uky.edu/sites/publications.ca.uky.edu/files/hydrolettuce.pdf	extension	hydrate and stabilize rockwool at pH 5.5–5.8 before seeding; seedlings 2–3 weeks; NFT a constant film at about 1–2 L/min per channel and a 1–3% slope. Lettuce.
osu-root-zone	Gillespie, Root Zone Management of Hydroponic Leafy Greens, Ohio State CFAES / UA CEAC, 2019: https://bpb-us-w2.wpmucdn.com/u.osu.edu/dist/7/65051/files/2020/07/Root-Zone-Management-Handout-2019.pdf	extension	leafy greens EC 1.0–2.5 dS/m, pH 5.5–6.5; measure pH, EC and DO daily, calibrate weekly; solution 20–22 °C; night RH above 95% helps against tip burn but raises disease risk
uga-c1304	UGA Circular 1304, Greenhouse Spinach … Using Hydroponics: https://fieldreport.caes.uga.edu/publications/C1304/how-to-grow-greenhouse-spinach-during-georgia-summers-using-hydroponics/	extension, spinach	germination optimum 18–21 °C, growth 15–25 °C; transplant 2–3 weeks after sowing; DWC at 150 ppm N
kaska-2024	Kaşka & Kaymak, Turk. J. Agric. For. 48(2), 2024: https://journals.tubitak.gov.tr/agriculture/vol48/iss2/3	peer-reviewed, spinach	best germination at 20 °C across 9 cultivars, falling above 20 °C, near-stopped at 35 °C
vonrosen-2022	von Rosen, SLU thesis, 2022: https://stud.epsilon.slu.se/18237/	thesis, spinach	best germination at 12 °C; inhibition from about 21 °C, worse at 27 °C

Corrections to the profile and reminders (my earlier advice was unsourced; replace it):

Germination nutrients: Cornell feeds lettuce seedlings from day 0 (100–150 ppm N). Drop "plain water only until true leaves"; show the Cornell practice, tagged lettuce data.
Light after sowing: sprouts need light right away (≥50 µmol/m²/s) or they stretch. Drop "no light needed before emergence" (unsourced for spinach).
Heat mat: no source says to use one for spinach. The germination data (optimum 12–21 °C, decline above about 20 °C) point to room temperature. Say exactly that.
Pump: extension sources describe continuous flow for NFT. The "15 on / 15 off" cycle is unsourced: label it, and make the schedule's default "continuous".
Top-off / full-change cadence: unsourced (Ohio State: measure daily, discard when problems arise), so label it grower consensus.
Label lettuce-derived values as "lettuce data" wherever spinach data is missing. Spinach extension literature is thin.

Still to read: the Cornell spinach final report (220 pp.), a HortScience 60(7):1208 paper on intermittent NFT flow, and ISHS 515_25 (spinach photoperiod and bolting).

trevatoowner commented 17d ago

The Learn page's "Fundamentals" path (owner: "i even want to get the biology. from first principles"). Each URL was fetched and confirmed by the steward's researcher on 2026-10-27; times are estimates. Render it as an ordered path, week one first.

Week one (about 3.5 h):

OpenStax Biology 2e 8.1 and 8.3, photosynthesis: https://openstax.org/books/biology-2e/pages/8-1-overview-of-photosynthesis · https://openstax.org/books/biology-2e/pages/8-3-using-light-energy-to-make-organic-molecules (textbook, about 1 h)
OpenStax 31.1, plant nutrition: https://openstax.org/books/biology-2e/pages/31-1-nutritional-requirements-of-plants (textbook, 30 min)
Bugbee (Utah State), Turning photons into food, slides: https://www.energy.gov/sites/prod/files/2017/02/f34/bugbee_agriculture_longbeach2017_0.pdf, and the 32-min video via UGA HortLAMP: https://hortlamp.uga.edu/outreach/outreach-instructional-videos (talk, about 50 min)
Spinach bolting: Chun et al., Acta Hort. 515: https://ishs.org/ishs-article/515_25/ (peer-reviewed abstract), and UAF: https://itgrowsinalaska.community.uaf.edu/?p=1246 (extension) (20 min)
Cornell CEA Hydroponic Lettuce Handbook (nutrients, pH, light, germination): https://cpb-us-e1.wpmucdn.com/blogs.cornell.edu/dist/8/8824/files/2019/06/Cornell-CEA-Lettuce-Handbook-.pdf (extension, 45 min skim)
Sutton et al. 2006, Pythium root rot in hydroponic crops (oxygen, temperature): https://www.scielo.br/j/sp/a/cGCh3FGRRzGLVFJf577mypy/?lang=en (peer-reviewed, 20 min skim)
Hort Americas on VPD: https://hortamericas.com/blog/science/understanding-vapor-pressure-deficit-vpd and calcium: https://hortamericas.com/blog/science/how-to-avoid-calcium-deficiency-in-controlled-environment-food-crops/ (vendor, 20 min)

Week two: OpenStax 30.5 (water transport): https://openstax.org/books/biology-2e/pages/30-5-transport-of-water-and-solutes-in-plants · 30.6 (light signals and photoperiod): https://openstax.org/books/biology-2e/pages/30-6-plant-sensory-systems-and-responses · Missouri/SARE nutrient-solutions deck: https://projects.sare.org/media/pdf/N/u/t/Nutrient-solutions-Class-2.pdf · UF/IFAS HS1279 leafy greens: https://edis.ifas.ufl.edu/publication/HS1279/pdf · UGA C1304 spinach: https://fieldreport.caes.uga.edu/publications/C1304/ · Bugbee, Nutrient management in recirculating hydroponics: https://ishs.org/ishs-article/648_12/

Unverified, so don't link them as verified: the Michigan State (Runkle) DLI and VPD pages (their site blocked the fetcher), and the books (Resh, Hydroponic Food Production; Taiz & Zeiger, Plant Physiology and Development). They can be listed as "optional, not checked".