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

مسئله از کجا شروع شد؟
ابزارهای اداری معمولاً آرامآرام رشد میکنند: یک برنامه برای ساخت صورتجلسه، یک پوشه برای الگوهای 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 آفلاین
- نگهداری مسیرهای نسبی یا قابل بازنگاشت برای انتقال آرشیو
جریان کلی سیستم
- ورودی جلسه و مصوبات
- اعتبارسنجی و جلوگیری از بازنویسی
- اجرای Skill در Process جدا
- تکمیل Template رسمی Word
- خواندن
report.json
- انتخاب ریشهٔ محلی یا شبکهای
- تشخیص فایل جدید یا تغییریافته
- استخراج موازی و پالایش متن
- ذخیره در کش اتمیک
- جستوجو یا ساخت گزارش مستقل