zeedOracle/soil-optimizer

AI soil optimization and crop recommendation engine MVP for Akko LGA, Gombe State. # AI Soil & Crop Optimizer — Akko LGA, Gombe State An MVP that recommends suitable crops and fertiliser guidance from soil input (lab-measured or observed), calibrated for smallholder farms in Akko LGA, Gombe State, Nigeria. Built for the 3MTT / DeepTech_Ready x WESOnline mentorship capstone and the African DeepTech Challenge (soil optimization track). ## ⚠️ Professional-use disclaimer This is a **mentorship capstone MVP**, not a validated agronomic tool. It uses a transparent, rule-based scoring engine built on documented agronomic reference ranges — **no qualified agronomist or extension officer has yet reviewed or signed off on the specific thresholds used.** Treat all recommendations as a starting-point suggestion, not professional agronomic advice, until that review has taken place. This tool does not replace an agricultural extension officer, a lab soil test, or professional judgement. ## Project documentation index | Document | Covers | |----------|--------| | `ARCHITECTURE.md` | System architecture diagram and component breakdown | | `FINAL_EVALUATION.md` | All measured metrics — test pass rates, boundary handling, invalid-input rejection | | `ERROR_ANALYSIS.md` | 5 documented failure cases with current mitigation status | | `EXPERT_VALIDATION.md` | Domain validation status (not yet completed) + ready-to-send validation package | | `USABILITY_TEST_PLAN.md` | Usability test protocol (not yet conducted) | | `EXPLAINABILITY.md` | How the system explains its own output to users | | `SAFETY.md` | Responsible-use boundaries, escalation triggers, data handling | | `PORTFOLIO_AND_REFLECTION.md` | Portfolio summary, CV bullet, final reflection | | `DEMO_SCRIPT.md` | Storyboard for the project demo video | | `DATA_SOURCES.md` / `DATA_DICTIONARY.md` / `MODEL_EXPLANATION.md` | Data provenance, schema, scoring formula | | `FAILURE_ANALYSIS.md` / `WEEK6_REPORT.md` / `BEFORE_AFTER_RESULTS.md` | Development history — the baseline→improvement story | ## Project purpose …