بازگشت به پیشخوان اصلی
معرفی پروژه «ترک اند سیو» (TracknSave)

سند جامع و یکپارچه معرفی پروژه TracknSave

بازنویسی و ادغام محتوای سه گزارش پیوست‌شده

تاریخ تهیه سند: ۲۶ ژوئن ۲۰۲۶

یادداشت انتشار: این سند، بازنویسی یکپارچه سه گزارش پیوست‌شده است[cite: 3]. در بعضی موارد میان گزارش‌ها اختلاف جزئی وجود داشت؛ برای همین متن حاضر تلاش می‌کند هم کامل باشد و هم از بیان ادعاهای قطعیِ غیرقابل تأیید پرهیز کند[cite: 3]. برای نمونه، تاریخ شروع دقیق پروژه از Git history به‌صورت قطعی در همه گزارش‌ها یکسان نیست؛ بنابراین می‌توان گفت نسخه فعلی پروژه حداقل از اواسط تا اواخر ماه مه ۲۰۲۶ در دسترس یا در حال توسعه بوده است[cite: 3].

فهرست مطالب

۱. نمای کلی پروژه

TracknSave یک وب‌اپلیکیشن مدیریت مالی شخصی و سبک است که برای ثبت، دسته‌بندی، پیگیری و مرور اطلاعات مالی روزمره طراحی شده است[cite: 3]. هدف اصلی برنامه این است که کاربر بدون نیاز به دانش حسابداری، وضعیت حساب‌ها، درآمدها، هزینه‌ها، بدهی‌ها، طلب‌ها، یادآورها و گزارش‌های ساده مالی خود را در یک محیط منظم و قابل جست‌وجو مدیریت کند[cite: 3].

عنوان شرح یکپارچه
نام پروژه TracknSave / تِرک اند سیو[cite: 3]
نوع محصول وب‌اپلیکیشن مدیریت مالی شخصی و ساده[cite: 3]
کاربر اصلی افراد عادی، خانواده‌ها، فریلنسرها و کسب‌وکارهای کوچک با نیازهای مالی ساده[cite: 3]
پلتفرم هدف مرورگر وب، قابل اجرا روی Localhost یا شبکه محلی LAN[cite: 3]
ماهیت برنامه ابزار مدیریت مالی شخصی؛ نه نرم‌افزار حسابداری شرکتی، ERP، حقوق و دستمزد یا سیستم مالیاتی[cite: 3]
وضعیت کلی ماژول‌های اصلی پیاده‌سازی شده‌اند و پروژه یک نسخه کاربردی از برنامه مالی شخصی را نشان می‌دهد[cite: 3].

۲. هدف و فلسفه طراحی پروژه

TracknSave برای حل یک مشکل ساده اما رایج ساخته شده است: بسیاری از کاربران می‌خواهند بدانند پولشان از کجا آمده، در کجا خرج شده، چه مقدار در حساب‌های مختلف باقی مانده، چه بدهی یا طلبی دارند و چه پرداخت‌هایی در آینده نزدیک باید انجام شود؛ اما نمی‌خواهند وارد پیچیدگی نرم‌افزارهای حسابداری سنگین شوند[cite: 3].

فلسفه برنامه بر پایه سادگی، سرعت ثبت اطلاعات، زبان قابل فهم برای افراد غیرحسابدار، نگهداری محلی داده‌ها و گزارش‌گیری کاربردی شکل گرفته است[cite: 3]. به همین دلیل در رابط کاربری تا حد امکان از مفاهیم سنگین حسابداری مانند دفتر کل، بدهکار و بستانکار، ترازنامه یا اسناد حسابداری رسمی استفاده نشده و تمرکز روی زبان روزمره کاربر قرار دارد[cite: 3].

۳. کاربران هدف

گروه کاربری نیاز اصلی
افراد عادی ثبت دخل‌وخرج، مشاهده مانده حساب‌ها و داشتن تصویر روشن از وضعیت مالی شخصی[cite: 3]
خانواده‌ها پیگیری هزینه‌های مشترک، یادآور قبوض و اقساط، مدیریت ساده پول‌های مشترک[cite: 3]
فریلنسرها ثبت درآمد و هزینه کاری بدون ورود به حسابداری رسمی و پیچیده[cite: 3]
کسب‌وکارهای کوچک نگهداری ساده تراکنش‌ها، اشخاص، طلب‌ها و بدهی‌ها در سطح سبک و غیرسازمانی[cite: 3]
کاربران حساس به حریم خصوصی نگهداری اطلاعات مالی روی سیستم شخصی یا شبکه محلی به جای سرویس‌های ابری[cite: 3]

۴. فناوری‌ها و بستر فنی

برنامه با ترکیب Laravel و Filament ساخته شده و از معماری رایج اپلیکیشن‌های لاراولی استفاده می‌کند[cite: 3]. گزارش‌ها در نام‌گذاری نسخه‌ها کمی اختلاف دارند، اما تصویر کلی فناوری‌ها روشن است: PHP 8.3، Laravel 13، Filament 4، Livewire، Blade و پایگاه داده MySQL در محیط محلی یا LAN[cite: 3].

لایه فناوری / ابزار
زبان بک‌اند PHP 8.3+[cite: 3]
فریم‌ورک وب Laravel 13.x[cite: 3]
پنل مدیریتی Filament 4.x همراه با Livewire[cite: 3]
لایه نمایش Blade، CSS، JavaScript و اجزای Filament[cite: 3]
پایگاه داده عملیاتی MySQL / MariaDB در محیط XAMPP یا مشابه آن[cite: 3]
تنظیمات پویا spatie/laravel-settings[cite: 3]
تاریخ جلالی morilog/jalali[cite: 3]
خروجی اکسل phpoffice/phpspreadsheet[cite: 3]
خروجی PDF barryvdh/laravel-dompdf[cite: 3]
ظاهر و استایل Filament UI، Tailwind CSS، Font Awesome محلی و CSS سفارشی برای RTL[cite: 3]

۵. ساختار کلی برنامه و مسیرهای مهم

TracknSave به‌صورت یک پنل وب مدیریتی اجرا می‌شود و مسیر اصلی کاربر معمولاً از پنل /admin آغاز می‌شود[cite: 3]. کاربر پس از ورود، با داشبورد اصلی روبه‌رو می‌شود و از آنجا بخش‌های زیر را مدیریت می‌کند:

۶. تنظیمات عمومی برنامه

این تنظیمات رفتار ظاهری، زبانی، تقویمی و مالی برنامه را کنترل می‌کنند و از یک مدیریت مرکزی تبعیت می‌نمایند:

۷. فضاهای مالی

فضاهای مالی برای تفکیک منطقی اطلاعات استفاده می‌شوند؛ برای مثال کاربر می‌تواند فضای شخصی، خانوادگی، کاری یا مسافرتی داشته باشد[cite: 3]. هر فضا می‌تواند حساب‌ها، تراکنش‌ها و داده‌های مرتبط خود را داشته باشد[cite: 3]. این تفکیک یک سیستم چندشرکتی یا چندکاربره سازمانی نیست؛ بلکه یک جداسازی ساده و کاربردی برای مدیریت مالی شخصی است[cite: 3].

۸. حساب‌ها و کیف پول‌ها

نوع حساب کاربرد عملیاتی
نقدی / Cash ثبت پول نقد یا صندوق شخصی[cite: 3]
حساب بانکی / Bank Account نگهداری حساب‌های بانکی همراه با اطلاعات بانک و شماره حساب[cite: 3]
کارت اعتباری / Credit Card پیگیری سقف اعتبار، اعتبار مصرف‌شده، مانده قابل استفاده، چرخه صورتحساب و سررسید پرداخت[cite: 3]
کیف پول دیجیتال / Digital Wallet مدیریت کیف پول‌ها یا حساب‌های دیجیتال[cite: 3]
پس‌انداز / Savings تفکیک حساب‌های پس‌انداز از حساب‌های روزمره[cite: 3]

قاعده موازنه: موجودی فعلی حساب‌ها بر اساس تراکنش‌ها محاسبه می‌شود[cite: 3]. برنامه موجودی را صرفاً به‌عنوان یک عدد دستی و جدا از تراکنش‌ها نگه نمی‌دارد، بلکه با ثبت درآمد، هزینه، انتقال و تعدیل، مانده حساب را به‌روزرسانی یا اعتبارسنجی می‌کند[cite: 3].

۹. بانک‌ها و ۱۰. دسته‌بندی‌ها

ماژول بانک‌ها اطلاعاتی نظیر نام فارسی، نام انگلیسی، کد SWIFT، کشور و لوگو را نگهداری می‌کند تا چیدمان حساب‌ها منظم‌تر باشد[cite: 3]. در بخش دسته‌بندی‌ها نیز ساختار از الگوی دو سطحی (والد و فرزند) به همراه آیکون‌های Font Awesome بهره می‌برد[cite: 3]. همچنین جهت محافظت از داده‌های تاریخی و گزارش‌های مالی گذشته، قابلیت Soft Delete برای دسته‌بندی‌ها و اشخاص استفاده شده است[cite: 3].

۱۱. تراکنش‌ها؛ هسته اصلی برنامه

تراکنش‌ها قلب TracknSave هستند[cite: 3]. هر ورودی مالی بر مانده حساب‌ها، گزارش‌ها، وضعیت اشخاص و تحلیل‌های ماهانه اثر می‌گذارد[cite: 3]. برنامه چهار نوع تراکنش اصلی دارد:

قاعده ثبات تراکنش: نوع تراکنش پس از ثبت قفل می‌شود؛ یعنی اگر تراکنشی به‌عنوان هزینه ثبت شد، در زمان ویرایش نوع آن به درآمد یا انتقال تغییر نمی‌کند[cite: 3]. این تصمیم برای جلوگیری از خراب شدن محاسبات مانده حساب‌ها در نظر گرفته شده است[cite: 3].

۱۲. اشخاص، ۱۳. بدهی‌ها و ۱۴. یادآورها

برنامه امکان اتصال تراکنش‌ها به اشخاص را فراهم می‌کند و برای هر شخص، گزارش تراکنش اختصاصی جهت پیگیری قرض‌ها و طلب‌ها ارائه می‌دهد[cite: 3]. در ماژول بدهی و وام، تاریخچه تسویه‌های مرحله‌به‌مرحله در جدول جداگانه‌ای ذخیره می‌شود[cite: 2, 3]. ماژول یادآورها نیز از الگوهای تکرار روزانه، هفتگی، ماهانه و سالانه پشتیبانی می‌کند و در داشبورد به نمایش در می‌آید[cite: 3].

۱۵. داشبورد V2 و تجربه استفاده روزمره

داشبورد نسخه دوم مرکز کنترل اصلی کاربر است و سرعت ثبت تراکنش‌ها را ارتقا می‌دهد:

۱۶. گزارش‌ها، خروجی‌ها و رسیدها

گزارش / خروجی کاربرد
گزارش ماهانه نمایش درآمد کل، هزینه کل، خالص ماه و تفکیک هزینه‌ها بر اساس دسته‌بندی[cite: 3]
گزارش تراکنش‌های شخص مرور همه تراکنش‌های مرتبط با یک شخص همراه با جمع‌های چهارگانه[cite: 3]
خروجی اکسل تراکنش‌ها دریافت فایل XLSX با فیلتر تاریخ و نوع تراکنش برای بررسی بیشتر[cite: 3]
رسید PDF تک تراکنش تولید رسید راست‌چین شامل جزئیات تراکنش، مبلغ، حساب، دسته‌بندی و شخص[cite: 3]

ملاحظه فنی: خروجی PDF عمومی برای فهرست تراکنش‌ها در رابط کاربری به‌صورت قطعی دیده نشده، اما رسید PDF تک تراکنش در لایه سرویس قابل تأیید است؛ بنابراین در معرفی محصول باید از «رسید PDF تراکنش» صحبت شود[cite: 3].

۱۷. پشتیبان‌گیری و بازیابی

۱۸. حریم خصوصی و امنیت

TracknSave برای اجرای محلی (Localhost) یا شبکه محلی (LAN) طراحی شده و فاقد وابستگی به سرویس‌های ابری خارجی است[cite: 3]. فرآیند احراز هویت و ورود به پنل از طریق سازوکارهای استاندارد لاراول و فیلامنت صورت پذیرفته و میان‌افزارهای متداول نظیر CSRF و Session کاملاً فعال هستند[cite: 3].

شفاف‌سازی محدوده امنیتی: شواهدی برای امنیت پیشرفته مانند احراز هویت دومرحله‌ای، قفل برنامه با پین‌کد مستقل، یا رمزگذاری فایلیِ پیوست‌ها در نسخه فعلی دیده نشده است؛ لذا ماهیت امنیتی برنامه بر پایه امنیت محیط محلی و فریم‌ورک لاراول تعریف می‌شود[cite: 3].

۱۹. بومی‌سازی و تجربه کاربری (RTL)

برنامه مجهز به فایل‌های ترجمه دوزبانه است. نمایش تاریخ‌ها، اعداد و قالب‌های مالی به‌صورت هماهنگ از تنظیمات مرکزی تبعیت می‌کنند[cite: 3]. بر اساس گزارش فنی، تبدیل اعداد به کاراکترهای فارسی با مکانیزم MutationObserver روی به‌روزرسانی‌های Livewire انجام می‌شود تا پس از تغییرات پویا نیز قالب ظاهری اعداد حفظ شود[cite: 3].

۲۱. داده‌های مدیریت‌شده و ۲۲. معماری فنی

اطلاعات به دسته‌های داده‌های پایه، داده‌های مالی (تراکنش‌ها و کارمزدها)، داده‌های کمکی (یادداشت‌ها و یادآورها)، تنظیمات و فایل‌های خروجی تقسیم می‌شوند[cite: 3]. جداول اصلی پایگاه داده از شناسه ساختار یافته UUID بهره می‌برند[cite: 3].

معماری پروژه از الگوی Laravel MVC + Filament Admin Panel پیروی می‌کند و منطق‌های تجاری مهم نظیر محاسبات مانده و خروجی‌ها در کلاس‌های سرویس (Services) و ابزارهای کمکی (Support Classes) تفکیک شده‌اند تا توسعه و تست برنامه آسان‌تر باشد[cite: 3].

۲۴. محدودیت‌ها و موارد خارج از دامنه

برای معرفی دقیق و قابل اعتماد، مرزهای پیاده‌سازی فعلی برنامه به شرح زیر مشخص می‌شوند:

۲۵. وضعیت قابلیت‌ها

ماژول / قابلیت وضعیت یکپارچه سیستم
تنظیمات مرکزی (زبان، تقویم، ارز و ظاهر) ✔ پیاده‌سازی شده[cite: 3]
فضاهای مالی و مدیریت حساب‌ها/کیف پول‌ها ✔ پیاده‌سازی شده[cite: 3]
تراکنش‌ها با چهار نوع اصلی و ثبت سریع در داشبورد V2 ✔ پیاده‌سازی شده[cite: 3]
اشخاص، مدیریت بدهی‌ها و یادآورهای دوره‌ای ✔ پیاده‌سازی شده[cite: 3]
گزارش ماهانه، خروجی اکسل و رسید PDF تراکنش ✔ پیاده‌سازی شده[cite: 3]
پشتیبان‌گیری و بازیابی محلی (با وابستگی عملیاتی به MySQL) ✔ پیاده‌سازی شده[cite: 3]
صندوق خانوادگی / Family Fund ✖ حذف‌شده از نسخه فعلی[cite: 3]
PIN Lock، بودجه‌بندی و نمودارهای پیشرفته ✖ ساخته نشده در نسخه فعلی[cite: 3]

۲۶. متن معرفی عمومی و بازاریابی پیشنهادی

TracknSave یک نرم‌افزار مدیریت مالی شخصی، ساده و سریع است که به شما کمک می‌کند حساب‌ها، درآمدها، هزینه‌ها، بدهی‌ها، طلب‌ها، یادآورها و یادداشت‌های مالی خود را در یک محیط منظم و قابل فهم مدیریت کنید[cite: 3]. این برنامه برای افرادی ساخته شده که می‌خواهند امور مالی روزمره خود را دقیق‌تر دنبال کنند، اما نمی‌خواهند وارد پیچیدگی نرم‌افزارهای حسابداری حرفه‌ای شوند[cite: 3].

با TracknSave می‌توانید در چند ثانیه تراکنش‌های خود را ثبت کنید، مانده حساب‌های مختلف را یکجا ببینید، پرداخت‌ها و سررسیدهای مهم را فراموش نکنید و گزارش‌های ساده ماهانه دریافت کنید[cite: 3]. پشتیبانی از زبان فارسی، تقویم جلالی، نمایش اعداد فارسی و اجرای محلی یا شبکه‌ای، این برنامه را به گزینه‌ای مناسب برای کاربرانی تبدیل می‌کند که هم به سادگی اهمیت می‌دهند و هم می‌خواهند داده‌های مالی‌شان در اختیار خودشان باقی بماند[cite: 3].

۲۷. جمع‌بندی نهایی

TracknSave در نسخه فعلی یک وب‌اپلیکیشن کاربردی برای مدیریت مالی شخصی و سبک است[cite: 3]. نقطه قوت اصلی آن، ترکیب ثبت سریع تراکنش‌ها، مدیریت چند نوع حساب، پیگیری اشخاص و بدهی‌ها، بومی‌سازی کامل فارسی و پشتیبان‌گیری محلی است[cite: 3]. برنامه باید با دامنه واقعی خود معرفی شود و نباید جایگزین سیستم‌های حسابداری شرکتی، رسمی یا نرم‌افزارهای مالیاتی تلقی گردد[cite: 3]. با تبیین شفاف این مرزها، معرفی پروژه قابل اعتمادتر و حرفه‌ای‌تر خواهد بود[cite: 3].