المزارع والبيوت المحمية والخطوط والدورات

يحفظ السجل مواقعك في تسلسل ثابت. يرتبط كل سجل بدورة زراعية واحدة، وينتمي كل مستوى إلى مؤسسة واحدة.

مخطط التسلسل: المؤسسة، وتضم مفاتيح API، ثم المزرعة، ثم البيت المحمي بنوعه وموقعه ومنطقته الزمنية، ثم الخط بمساحته، ثم الدورة الزراعية بصنفها وتاريخ زراعتها. وتحت الدورة الزراعية: الجولات والحصاد والري والقراءات والطقس وأوزان الثمار والتوقعات المحفوظة. — المؤسسة ← المزرعة ← البيت المحمي ← الخط ← الدورة الزراعية.

المستويات

المزرعة: اسم. تجمع البيوت المحمية.
البيت المحمي: اسم، ونوع البيت المحمي (بلاستيكي، أو مظلّل، أو مبرَّد، أو مغلق مكيَّف)، وخط عرض وخط طول اختياريان للطقس، ومنطقة زمنية اختيارية وفق IANA. تحدد المنطقة الزمنية كيف تُقرأ الأوقات التي لا تحمل فارقًا زمنيًا في ملفات المناخ. ومن دون منطقة تُقرأ بتوقيت UTC. ويأتي التوقيت الصيفي وسائر تغييرات الساعة من بيانات المناطق الزمنية IANA في النظام.
الخط: اسم ومساحة بالمتر المربع، وكلاهما اختياري.
الدورة الزراعية: الصنف وتاريخ الزراعة وعدد النباتات في المتر المربع والمساحة، وكلها اختيارية. وتنتمي الجولات والحصاد والري والقراءات والطقس وأوزان الثمار والملخصات الأسبوعية والتوقعات المحفوظة كلها إلى دورة.

تعديل الأسماء والتفاصيل

صفحة الإعداد مع لوحة تعديل البيت المحمي مفتوحة على اليمين. تحتفظ اللوحة بالمعرّف demo-house وفيها حقول الاسم ونوع البيت المحمي والمنطقة الزمنية وخط العرض وخط الطول، مع زرّي حفظ التغييرات وإلغاء. — تعديل بيت محمي في صفحة الإعداد. يُفتح التعديل في لوحة، ويبقى المعرّف كما هو.

في صفحة الإعداد (/app/setup)، تعرض شجرة المؤسسة كل المزارع والبيوت المحمية والخطوط والدورات الزراعية. يفتح تعديل على أي مستوى لوحة بتفاصيله، وعبر واجهة API أرسل طلب PATCH إلى مسار المستوى. تحتفظ الحقول التي لا ترسلها بقيمتها. وحقل الدورة المرسل بقيمة null يُمسح.

يمكنك تغيير الأسماء والتفاصيل: نوع البيت المحمي، والموقع، والمنطقة الزمنية، والمساحة، والصنف، وتاريخ الزراعة، والكثافة.
لا يمكن تغيير المعرّفات. لتغيير معرّف، أنشئ المستوى الجديد وانقل البيانات بإعادة تسجيلها.
لا يؤدي تغيير المنطقة الزمنية للبيت المحمي إلى تحريك القراءات المحفوظة، إذ تحتفظ بأوقاتها بتوقيت UTC.
يُضبط خط العرض وخط الطول معًا، أو يُمسحان معًا.

استيراد قائمة البيوت المحمية

لإعداد عدد كبير من البيوت المحمية دفعة واحدة، افتح الإعداد → استيراد البيوت المحمية (/app/setup/import) وارفع ملف CSV فيه سطر لكل بيت. نزّل القالب من الصفحة؛ أعمدته هي farm, greenhouse, house_type, area_m2, rows, row_length_m, fruit_type, planting_date, cycle_name.

احفظه بترميز UTF-8، مع ; أو , بين الأعمدة. يحمل الملف 500 بيت و1 MB كحد أقصى.
تعرض المعاينة ما سيُنشأ وكل سطر يحتاج إلى تصحيح. لا يُحفظ شيء قبل الضغط على تطبيق.
يحصل كل بيت على خطوطه ودورة زراعة واحدة لكل خط. المزرعة أو البيت أو الخط أو الدورة الموجودة بالاسم نفسه تُتخطّى، فإعادة استيراد الملف نفسه لا تنشئ شيئًا جديدًا.

حذف مستوى

يُرفض الحذف ما دام المستوى يحتوي على أي شيء. ويكون الرد 409 مع قائمة بما يحتويه. ولرؤية هذه الأعداد نفسها مسبقًا، اقرأ GET …/contents، الذي يعيد البيوت المحمية والخطوط والدورات والجولات والقراءات والحصاد وإدخالات الري والتوقعات المحفوظة والملخصات الأسبوعية وإعدادات أوزان الثمار تحت ذلك المستوى.

أرسل ?cascade=true لحذف المستوى مع كل ما تحته. وفي التطبيق، يفتح حذف نافذة تأكيد تعرض ما سيُحذف مع المستوى، ولا يُحذف شيء حتى تختار حذف الكل.

صفحة الإعداد مع نافذة تأكيد حذف مفتوحة للخط demo-row. تعرض أعداد ما سيُحذف معه، مع زرّي إلغاء وحذف الكل. — يعرض الحذف في صفحة الإعداد أولًا ما سيُحذف مع المستوى.

الجولات المحفوظة يُفك ارتباطها ولا تُمحى. ويظل بالإمكان فتح الجولة المحلَّلة بمعرّفها لفترة، لكنها لم تعد تُحتسب في أي توقعات.
تُحذف التوقعات المحفوظة تحت المستوى معه.
لا يمكن التراجع عن الحذف. صدّر الدورة بصيغة CSV أولًا إن كنت قد تحتاج إلى الأرقام.