أتمتة تقرير Notion للمهام المتأخرة قبل ما تتدفن

مستوى القارئ: متوسط

هتكسب تقرير يومي واضح للمهام المتأخرة في Notion بدل ما تبدأ صباحك بفتح قاعدة بيانات وفرز يدوي.

المشكلة باختصار

لو عندك فريق صغير بيستخدم Notion كـ task tracker، اللي بيحصل فعلاً إن المهام المتأخرة مش بتظهر في لحظة القرار. المدير يفتح Notion، يفلتر Due Date، يراجع Status، وبعدها يبعت رسالة للفريق. العملية دي ممكن تاخد 20 دقيقة يوميًا. مع 5 أيام عمل، أنت بتصرف حوالي 100 دقيقة في الأسبوع على متابعة قابلة للأتمتة.

الافتراض هنا إن عندك Data Source في Notion فيها خصائص: Name، Status، Due، وOwner. لو الأسماء مختلفة، هتغيرها في السكربت فقط.

الفكرة بمثال بسيط

ركز في المثال ده: عندك 120 مهمة مفتوحة. كل صباح فيه 9 إلى 15 مهمة متأخرة. بدل ما شخص يدخل ويعمل filter، سكربت Node.js يسأل Notion: هات المهام التي لم تنتهِ وحقل Due بتاعها قبل أو يساوي تاريخ اليوم. بعد كده يرتبها حسب المالك ويرسل بريد واحد للفريق.

المفهوم العلمي هنا بسيط: أنت لا تؤتمت القرار. أنت تؤتمت جمع الإشارات. القرار يفضل عند الإنسان، لكن البيانات بتوصله في وقت ثابت وبصيغة ثابتة. الـ trade-off هنا إن التقرير ممكن يزعج الفريق لو اتبعت لكل صغيرة. المكسب إن التأخير الحقيقي يظهر بدري.

السكربت التنفيذي

أفضل طريقة هنا هي سكربت صغير، مش workflow ضخم. استخدم Notion API لجلب البيانات، وResend لإرسال البريد. Notion يشرح Query Data Source والفلاتر في توثيقه الرسمي، وResend يوفر endpoint بسيط لإرسال Email API.

npm init -y
npm install @notionhq/client resend

# Linux/macOS
export NOTION_TOKEN="secret_xxx"
export NOTION_DATA_SOURCE_ID="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export RESEND_API_KEY="re_xxx"
export REPORT_TO="team@example.com"
export REPORT_FROM="ops@example.com"
node overdue-report.js

import { Client } from "@notionhq/client";
import { Resend } from "resend";

const notion = new Client({ auth: process.env.NOTION_TOKEN });
const resend = new Resend(process.env.RESEND_API_KEY);

const today = new Date().toISOString().slice(0, 10);
const response = await notion.dataSources.query({
  data_source_id: process.env.NOTION_DATA_SOURCE_ID,
  filter: {
    and: [
      { property: "Status", status: { does_not_equal: "Done" } },
      { property: "Due", date: { on_or_before: today } }
    ]
  },
  sorts: [{ property: "Due", direction: "ascending" }]
});

const rows = response.results.map((page) => {
  const p = page.properties;
  return {
    title: p.Name?.title?.[0]?.plain_text ?? "Untitled",
    due: p.Due?.date?.start ?? "no date",
    owner: p.Owner?.people?.[0]?.name ?? "Unassigned"
  };
});

const html = rows.length
  ? `
Overdue Notion tasks: ${rows.length}
` +
    rows.map((r) => `
${r.owner}: ${r.title} - due ${r.due}
`).join("") +
    `
`
  : `
No overdue tasks today.
`;

await resend.emails.send({
  from: process.env.REPORT_FROM,
  to: process.env.REPORT_TO,
  subject: `Notion overdue tasks - ${today}`,
  html
});

console.log(`sent ${rows.length} overdue tasks`);

تشغيله يوميًا بدون تعقيد

لو السيرفر Linux، استخدم cron. شغله الساعة 8:30 صباحًا قبل standup. لو بتشتغل على Windows، استخدم Task Scheduler بنفس الفكرة. المهم إن السكربت يشتغل مرة واحدة فقط يوميًا، وإلا هتبعت تقرير مكرر.

# crontab -e
30 8 * * 1-5 cd /opt/notion-report && /usr/bin/node overdue-report.js >> run.log 2>&1

في سيناريو واقعي لفريق 12 شخص، المراجعة اليدوية كانت 22 دقيقة في اليوم. بعد التقرير اليومي، بقيت 3 دقائق: فتح البريد، مراجعة أصحاب المهام، واتخاذ قرار. الرقم ده مش وعد عام؛ هو نموذج قياس. قيس عندك قبل وبعد لمدة أسبوع.

ما يجب الانتباه له

• الصلاحيات: خلي Integration في Notion يقرأ Data Source المطلوب فقط. لا تعطيه Workspace كامل لو مش محتاج.
• الحدود: Notion API له rate limits. التقرير اليومي الخفيف غالبًا آمن، لكن لا تشغله كل دقيقة على آلاف الصفحات.
• الخصوصية: لا تبعت وصف المهمة كامل لو فيه بيانات عملاء. ابعت العنوان والمالك والتاريخ فقط.
• الضجيج: لو التقرير طويل جدًا، اجمعه حسب المالك أو ابعت أول 20 مهمة فقط.

الـ trade-off هنا واضح: سكربت بسيط يوفر وقت متابعة ويثبت الإيقاع، مقابل اعتماد إضافي على Notion API وخدمة بريد خارجية. لو Resend وقع، التقرير مش هيوصل. لذلك احتفظ بـ run.log، وخلي السكربت يطبع عدد المهام المرسلة.

متى لا تستخدم هذه الطريقة

لا تستخدمها لو Notion عندك مجرد مساحة ملاحظات غير منظمة. الأتمتة هنا تحتاج خصائص ثابتة. لا تستخدمها أيضًا لو المهام تحتوي بيانات قانونية أو طبية أو مالية حساسة وترسلها لبريد عام. في الحالة دي ابعت رقم إجمالي فقط، وخلي التفاصيل داخل Notion بصلاحياته.

مصادر

• Notion API filter object reference
• Notion API request limits
• Resend Send Email API
• crontab manual

الخطوة التالية

افتح Notion وحدد Data Source واحدة للمهام. لو فيها Status وDue وOwner، شغل السكربت على بريدك أنت فقط لمدة يومين، وبعدها ابعته للفريق.