انشاء مساعد الشخصي الذكي

? متطلبات المرحلة الأولى – المساعد الشخصي الذكي (النسخة الفردية)

العميل: محمد "بورعي"

النطاق: استخدام شخصي فقط (مستخدم واحد).

إمكانية التوسّع لاحقًا، لكن غير مطلوبة الآن.

1️⃣ نظرة عامة

أحتاج إلى مساعد شخصي ذكي يعمل لي أنا فقط، ويقوم بشكل تلقائي بإدارة وتنظيم يومي وحياتي العملية من خلال:

قراءة الإيميلات وتلخيصها

إنشاء المهام والمواعيد تلقائيًا

إرسال تذكيرات قوية حتى لا أنسى شيئًا

معالجة أو تلخيص اجتماعاتي

تنفيذ أوامر صوتية بسيطة

إنشاء جدول يومي جاهز

العمل تلقائيًا بدون تدخل يدوي

هذه ليست منصة SaaS تجارية في هذه المرحلة.

هذه مرحلة 1: النسخة الشخصية فقط، لكن يُفضّل أن يكون الكود منظمًا ليسهل التوسع في المستقبل.

2️⃣ الخصائص الأساسية (النسخة الشخصية)

A. الذكاء الخاص بالإيميلات

ربط أكثر من حساب بريد (خاصة Gmail)

قراءة الإيميلات الجديدة تلقائيًا

لكل إيميل يجب:

توليد ملخص مختصر

استخراج المهام والمواعيد والطلبات

تحديد ما إذا كان مهمًا أم لا

يقوم النظام تلقائيًا بـ:

إنشاء المهام في TickTick أو Notion

إنشاء مسودة رد بأسلوبي الشخصي

إرسال تنبيه إذا لم يرد شخص على إيميلي خلال X أيام

B. إدارة المهام والتقويم

تكامل مع:

Google Calendar

TickTick أو Notion

وظائف مطلوبة:

إنشاء المهام من الإيميلات، الاجتماعات، أو الأوامر الصوتية

ربط كل مهمة بمصدرها (إيميل/اجتماع)

الجدول اليومي (Daily Agenda):

كل يوم الساعة 8 صباحًا (توقيت تورنتو)

إنشاء جدول اليوم تلقائيًا يشمل:

مواعيد اليوم

أهم المهام

إرساله عبر:

إيميل

اختياري: واتساب / تليجرام

C. الأوامر الصوتية (مرحلة 1)

باستخدام:

Whisper: لتحويل الصوت إلى نص

LLM (مثل GPT): لفهم نية الأمر الصوتي

الأوامر المطلوبة:

"عندي إيه النهارده؟"

"أضف مهمة…"

"أضف اجتماع…"

الردود يمكن أن تكون:

نص على الشاشة

أو صوت باستخدام ElevenLabs (اختياري)

D. الاجتماعات وتلخيصها

التكامل مع Fireflies.ai أو Otter.ai

بعد ظهور الملخص:

استقبال الملخص أو التفريغ عبر Webhook/API

تنظيف وتلخيص المحتوى باستخدام الذكاء الاصطناعي

استخراج:

القرارات

المهام

المواعيد

إنشاء المهام تلقائيًا في TickTick أو Notion

حفظ ملخص الاجتماع في Notion أو في قاعدة البيانات

E. نظام التنبيهات القوية (مهم جدًا)

أحتاج إلى تذكيرات قوية عبر عدة قنوات:

إيميل

واتساب أو تليجرام

إشعارات الهاتف (اختياري)

تذكيرات متكررة حتى يتم إنجاز المهمة

تنبيه قبل الاجتماعات بـ 10 دقائق (يفضّل أن يكون صوتيًا)

مثال:

“بورعي، عندك اجتماع بعد 10 دقائق في مسجد ___.”

3️⃣ متطلبات البنية التقنية

التقنيات المفضلة:

Backend: FastAPI (بايثون) أو Node.js

الاستضافة: Replit أو Render أو Vercel (تشغيل دائم 24/7)

الأتمتة: Make.com أو Zapier

الذكاء الاصطناعي:

OpenAI GPT

Whisper للصوت → نص

التخزين:

Notion Database

أو Firebase / PostgreSQL لو احتاجنا

التكاملات:

Gmail API

Google Calendar API

TickTick / Notion API

Fireflies Webhooks

واتساب / تليجرام (اختياري)

يجب توفير واجهات API أساسية مثل:

POST /email/ingest

POST /meetings/summary

POST /voice/command

GET /agenda/today

4️⃣ واجهة المستخدم (مرحلة 1)

أحتاج إلى لوحة بسيطة جدًا:

قسم: جدول اليوم

قسم: الإيميلات أو العناصر المهمة

قسم: آخر ملخصات الاجتماعات

زر ميكروفون لتسجيل الأوامر الصوتية (لو أمكن)

واجهة بسيطة تكفي – ليست تطبيقًا كاملاً.

5️⃣ متطلبات غير وظيفية

النظام لشخص واحد فقط – أنا

الكود يكون نظيفًا ومنظمًا

توثيق أساسي للتشغيل:

كيف أنشر

كيف أغير المفاتيح

كيف أضيف أوامر جديدة

اللغة:

يدعم العربية والإنجليزية

الصوت ممكن يكون إنجليزي حاليًا

6️⃣ المخرجات المطلوبة من المبرمج

نظام كامل يعمل 24/7

لوحة بسيطة على الويب

التكامل مع:

بريدي

تقويمي

نظام المهام

Fireflies

توثيق واضح (كتابة أو فيديو قصير) يشرح:

كيف أستخدم النظام

كيف يعمل كل جزء

7️⃣ إضافية

ردود صوتية باستخدام TTS

إرسال رسائل واتساب أو تليجرام

تقرير أسبوعي:

المهام المنجزة

المهام المتأخرة

ملخص الاجتماعات

Title: Phase 1 – Personal AI Assistant (Single User Version)

Client: Mohamed “Borai”

Scope: Personal use only (single user), future-ready for scaling later.

1. Overview

I need a personal AI assistant that runs for me only and helps me manage my daily life and work by:

Reading and summarizing my emails

Creating and managing tasks and calendar events

Sending me daily and real-time reminders (so I don’t forget anything)

Joining or processing meetings to generate summaries and action items

Allowing me to use voice commands for basic actions

This is NOT a SaaS product yet. It is a Phase 1 personal system for my own use.

However, the code should be clean and structured so that it can be extended to multi-user later.

2. Core Features (Phase 1 – Personal)

A. Email Intelligence (for my accounts)

Connect multiple email accounts (mainly Gmail, maybe others later).

For each new email:

Decide if it’s important or not (based on rules + AI).

Generate a short summary.

Extract tasks, dates, and deadlines if found.

Automatically:

Create tasks in my task system (TickTick or Notion).

Optionally generate a suggested reply (draft) I can copy/paste.

B. Tasks & Calendar

Integration with:

Google Calendar (for events)

TickTick OR Notion (for tasks)

The agent should:

Create tasks from emails, meetings, and voice commands.

Keep tasks linked to their source (email / meeting).

Daily Agenda:

Every morning at a fixed time (e.g. 8:00 AM Canada time), generate:

“Today’s Agenda”: meetings + top tasks.

Send it to me as:

An email

(Optional) WhatsApp or Telegram message

C. Voice Commands (Simple in Phase 1)

Support simple voice commands via:

Web interface (mic button) OR a simple mobile-friendly page.

Use:

Whisper (STT) to convert my voice to text

OpenAI / LLM for intent detection

Supported commands in Phase 1:

“What do I have today?” → read today’s agenda

“Add a task …” → create a new task

“Add a meeting …” → create calendar event

Response can be:

Text on screen

(Nice to have) voice reply using TTS (ElevenLabs or similar)

D. Meetings & Summaries

Use Fireflies.ai (or similar) to record and transcribe my meetings (Zoom/Google Meet).

The agent should:

Receive the transcript or summary via webhook/API.

Clean and condense it using AI.

Extract:

Key decisions

Action items (tasks)

Dates and follow-ups

Create tasks automatically in TickTick/Notion.

Store the final summary in Notion (or a database) for future reference.

E. Reminders & Anti-Forget Logic

Very important for me:

The system should send strong reminders for:

Important tasks

Upcoming meetings

Channels:

Email for sure

If possible: WhatsApp or Telegram via API

Logic example:

Important task due in 1 hour → send reminder

If still not done after X time → send another reminder

I don’t want to miss anything important.

3. Architecture / Tech Requirements

I prefer:

Backend: Python (FastAPI) or Node.js (Express/NestJS)

Host: Replit, Vercel, Render, or similar (always-on)

Automations: Can use Make.com/Zapier if it simplifies integrations

AI: OpenAI (GPT models) + Whisper for speech-to-text

Storage: Notion databases or a simple Postgres/Firestore DB

Integrations:

Gmail API

Google Calendar API

TickTick or Notion API

Fireflies.ai (meetings)

WhatsApp/Telegram (optional but nice)

The backend should expose endpoints such as:

POST /email/ingest – called by Make.com or webhook when new email arrives

POST /meetings/summary – called after a meeting summary is ready

POST /voice/command – handle voice commands

GET /agenda/today – return today’s agenda (for web or WhatsApp)

4. Simple User Interface (Phase 1)

I need a very simple web dashboard:

Section: “Today’s Agenda” (meetings + tasks)

Section: “Important Emails / Items”

Section: Last meeting summaries

A microphone button for voice commands (if feasible)

This can be a simple web page, not a full app.

5. Non-Functional Requirements

System is for one user only (me).

Clean, maintainable code with basic documentation:

How to deploy

How to change APIs / keys

How to add new commands later

Timezone: America/Toronto

Language: must support Arabic and English (at least in text, voice can be English first).

6. Deliverables

Fully working backend deployed and running 24/7

Basic web dashboard

Integration with:

My email

My calendar

My tasks system

Fireflies (meetings)

Documentation (text or short video) explaining:

How the system works

How I can use and test it day-to-day

7. Nice to Have

Voice output (TTS) for agenda and reminders

WhatsApp or Telegram connection for notifications

Weekly summary of:

Completed tasks

Missed tasks

Meetings and outcomes