رضا.
← بازگشت به پروژه‌ها

01 / CEO DEPARTMENT SUITE

داشبورد صورت جلسات

این پروژه از کنار هم قرار دادن دو ابزار واقعی شکل گرفت: یکی برای ساخت اسناد رسمی هیئت‌مدیره و دیگری برای پیدا کردن تصمیم‌ها و موضوعات داخل آرشیو صورت‌جلسات. هدفم این بود که کاربر به‌جای گشتن بین پوشه‌ها و برنامه‌های جدا، از یک نقطه وارد شود و هر ابزار را مستقل و قابل‌اعتماد اجرا کند.

PythonPywebviewManifest DiscoveryPortable Desktop
رابط داشبورد صورت جلسات

مسئله از کجا شروع شد؟

ابزارهای اداری معمولاً آرام‌آرام رشد می‌کنند: یک برنامه برای ساخت صورت‌جلسه، یک پوشه برای الگوهای Word و ابزار دیگری برای جست‌وجوی آرشیو. هرکدام به‌تنهایی کار می‌کنند، اما جابه‌جایی‌شان سخت است، منابع تکرار می‌شوند و خرابی یک مسیر ثابت می‌تواند کل کار را متوقف کند.

راه‌حل من یک معماری Hub-and-Modules بود؛ Dashboard فقط ماژول‌ها را کشف و اجرا می‌کند و وارد منطق داخلی آن‌ها نمی‌شود. به این ترتیب ابزارها یک تجربهٔ مشترک دارند، ولی استقلال فنی‌شان حفظ می‌شود.

کشف به‌جای Hardcode

هر ماژول با فایل app.json خودش را معرفی می‌کند. Dashboard پوشهٔ Apps را می‌خواند، Manifest را اعتبارسنجی می‌کند و کارت و فرمان اجرا را از همان قرارداد می‌سازد.

Process مستقل

ماژول‌ها با subprocess.Popen جدا اجرا می‌شوند. بنابراین توقف یا خطای یک ابزار، پنجرهٔ اصلی یا ابزار دیگر را از کار نمی‌اندازد.

دادهٔ واقعاً پرتابل

فایل‌های داخل Bundle فقط‌خواندنی فرض می‌شوند و تنظیمات، کش و وضعیت ماندگار در portable-data قرار می‌گیرند.

منابع مشترک، مرز روشن

فونت، UI، مسیرها و Skillها در Shared قرار دارند؛ اما ماژول‌ها کد داخلی یکدیگر را import نمی‌کنند.

ماژول اول: Board Document Manager

این بخش داده‌های تأییدشده را به سند رسمی Word تبدیل می‌کند. استخراج سریع متن و metadata از ساختار ZIP/XML فایل DOCX انجام می‌شود و تولید نهایی سند به یک Skill مستقل سپرده می‌شود تا Style، جدول، Header و Footer الگوی رسمی حفظ شوند.

  • تولید صورت‌جلسه و تبدیل چند صورت‌جلسه به دستور جلسه
  • پیشنهاد شمارهٔ بعدی سند بر اساس آرشیو موجود
  • اجرای تولید سند در Child Process و دریافت نتیجه از report.json
  • حفظ فایل منبع و Template؛ بدون بازنویسی پنهان

ماژول دوم: Board Minutes Report

این ماژول آرشیو Word را به یک نمایهٔ قابل جست‌وجو تبدیل می‌کند. فقط فایل‌های جدید یا تغییریافته پردازش می‌شوند، متن پاراگراف‌ها و جدول‌ها به‌صورت موازی استخراج می‌شود و کش با روش اتمیک ذخیره می‌شود تا توقف ناگهانی نسخهٔ سالم قبلی را خراب نکند.

  • اسکن افزایشی و پردازش با ThreadPoolExecutor
  • پاک‌سازی عبارت‌های تکراری و بخش‌های غیرمفید برای جست‌وجو
  • بازکردن مستقیم سند اصلی و ساخت گزارش HTML آفلاین
  • نگهداری مسیرهای نسبی یا قابل بازنگاشت برای انتقال آرشیو
محدودیت فعلی: این مجموعه برای ویندوز طراحی شده و کیفیت تولید Word به سلامت Templateها وابسته است. دسترسی به آرشیو شبکه‌ای هم همچنان تابع مجوز و اتصال ویندوز است. مرحلهٔ بعدی برای من، عمیق‌ترکردن Self-Test و آزمایش Build روی یک سیستم تمیز است.

جریان کلی سیستم

CEO SUITE / HUB + MODULES2 MODULES READY
معماری هاب و دو ماژول داشبورد صورت جلساتLauncher داشبورد را اجرا می‌کند، داشبورد فایل‌های app.json را کشف می‌کند و سپس دو فرایند مستقل مدیریت سند و گزارش صورت‌جلسات را راه می‌اندازد.
run.ps1 / EXELAUNCHER.PY
Dashboard مرکزیDISCOVER app.json
Board Document ManagerCHILD PROCESS A
  1. ورودی جلسه و مصوبات
  2. اعتبارسنجی و جلوگیری از بازنویسی
  3. اجرای Skill در Process جدا
  4. تکمیل Template رسمی Word
  5. خواندن report.json
خروجیصورت‌جلسه یا دستور جلسهٔ Word
Board Minutes ReportCHILD PROCESS B
  1. انتخاب ریشهٔ محلی یا شبکه‌ای
  2. تشخیص فایل جدید یا تغییریافته
  3. استخراج موازی و پالایش متن
  4. ذخیره در کش اتمیک
  5. جست‌وجو یا ساخت گزارش مستقل
خروجینتیجهٔ جست‌وجو یا گزارش HTML آفلاین
کشف و اجرای ماژول مستقلهاب Manifest و جداسازی Process