Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

Karavang-Accounting

Professional yet simple sales management and accounting system for emergencies. Suitable for small and medium businesses. سیستم مدیریت فروش و حسابداری حرفه ای و در عین حال ساده برای شرایط اضطراری. مناسب برای کسب و کارهای کوچک و متوسط. این سامانه نیازی به نصب روی سیستم نداره و تنها حاوی یک فایل html ساده هستش و تمامی کارها روی مرورگر سیستم یا گوشی شما انجام میشه. و این امکان هم براتون فراهم شده تا بتونید بصورت روزانه پیشتیبان تهیه کنید. یکی از قابلیت های خیلی خاص در این سیستم حسابداری فروش، ثبت فاکتور خرید سفارش، بلافاصله بعد از ثبت فاکتور فروش هستش. یعنی شما طرف حساب ها رو تعریف میکنید (مشتریان، تأمین کنندگان و همکاران) در زمان ثبت فاکتور فروش مرجع خرید و تأمین اقلام فاکتور هم قید میشه. همینطور بازاریاب و یا طراح رو هم میتونید مشخص کنید. بعد از انتخاب شماره کارت و روش پرداخت و ثبت فاکتور، بلافاصله فاکتور خرید هم ثبت میشه که شما میتونید پرداختش رو انجام بدید و بصورت خودکار در سند هزینه ها ثبت میشه. گزارشات سود و زیان به سادگی ساخته میشه، گزارشات متنوعی از میزان فروش و وضعیت فاکتور ها هم میتونید دریافت کنید. فاکتورها به صورت حرفه ای آماده میشن و امکان ارسال در شبکه های اجتماعی هم براش فراهم شده. ما در حال بروزرسانی این نرم افزار ساده و در عین حال حرفه ای برای تمامی صاحبین مشاغل هستیم.

🧾 کارآونگ | سیستم حسابداری فروش آفلاین

سیستم جامع حسابداری فروش، مدیریت فاکتور و پرداخت‌ها — بدون نیاز به اینترنت نسخه دموی آنلاین · گزارش باگ · درخواست قابلیت · مستندات

📋 فهرست مطالب

معرفی
ویژگی‌های کلیدی
تصاویر و پیش‌نمایش
تکنولوژی‌های استفاده‌شده
نصب و راه‌اندازی
ساختار پروژه
ماژول‌های سیستم
راهنمای استفاده
پشتیبان‌گیری و بازیابی
امنیت و حریم خصوصی
نقشه راه توسعه
مشارکت در پروژه
مجوز
تماس با ما

معرفی کارآونگ یک سیستم حسابداری فروش کامل و آفلاین است که به‌صورت یک فایل HTML مستقل طراحی شده و برای شرایط بحرانی (قطعی اینترنت، شرایط اضطراری، محیط‌های بدون دسترسی به سرور) بهینه‌سازی شده است. این سیستم به‌عنوان یک لایه تداوم عملیات (Business Continuity Layer) در کنار ERP اصلی سازمان کار می‌کند. 🎯 چرا کارآونگ؟

✅ بدون نیاز به اینترنت: تمام عملیات به‌صورت محلی در مرورگر انجام می‌شود
✅ بدون نیاز به نصب: فقط با باز کردن یک فایل HTML در مرورگر اجرا می‌شود
✅ بدون سرور و دیتابیس خارجی: از IndexedDB مرورگر استفاده می‌کند
✅ قابل حمل: یک فایل = کل سیستم
✅ رایگان و متن‌باز: تحت مجوز MIT

⚡ ویژگی‌های کلیدی 📊 مدیریت طرف‌های حساب

سه نوع طرف حساب: مشتریان (طلبکار)، همکاران (پورسانت‌دار)، تأمین‌کنندگان (بدهکار)
پشتیبانی از شخصیت حقوقی و حقیقی
فیلدهای کامل: شناسه ملی، کد اقتصادی، شماره ثبت، آدرس، توضیحات
محاسبه خودکار مانده حساب با در نظر گرفتن مانده قبلی

🧾 صدور فاکتور فروش

شماره‌گذاری خودکار به فرمت YYYYMMDDXXX
انتخاب خریدار، همکار/کارشناس فروش و تأمین‌کننده
اقلام نامحدود با فیلدهای: نام، تعداد، واحد، فی فروش، فی خرید
سیستم تخفیف ترکیبی (درصد + مبلغ)
محاسبه خودکار ارزش افزوده 10%
نمایش سود ناخالص هر فاکتور در لحظه
ایجاد خودکار فاکتور خرید و سند هزینه مرتبط

💳 مدیریت پرداخت‌ها

پرداخت نقدی، انتقال وجه، کارت به کارت، شبا
مدیریت کامل چک‌ها با چرخه عمر (در انتظار → وصول شده → برگشتی)
ثبت شماره پیگیری و شرح پرداخت
تسویه حساب با تأمین‌کنندگان

📈 گزارشات و نمودارها

نمودار میله‌ای SVG خالص (بدون وابستگی خارجی)
فیلتر گزارش بر اساس بازه تاریخ شمسی و خریدار
شاخص‌های کلیدی: فروش، هزینه، سود، درصد سود، دریافتی خالص
چک‌لیست انتقال به ERP

🖨️ خروجی و چاپ

قالب چاپ استاندارد A4 با CSS Print Media
خروجی PDF از طریق مرورگر
اسکرین‌شات از فاکتور برای ارسال در شبکه‌های اجتماعی (با html2canvas)
بهینه‌سازی نمایش فاکتور برای موبایل

🎨 رابط کاربری

طراحی Glassmorphism با backdrop-filter
پس‌زمینه متحرک با Canvas API (نقاط نوری رنگی)
فونت حرفه‌ای Vazir با پشتیبانی از ارقام فارسی (xFaNuM)
کاملاً راست‌چین (RTL) و فارسی
Responsive و سازگار با موبایل

🖼️ تصاویر و پیش‌نمایش داشبورد

فاکتور فروش

گزارشات

️ تکنولوژی‌های استفاده‌شده تکنولوژی

کاربرد HTML5

ساختار اصلی برنامه CSS3

استایل‌دهی، Glassmorphism، انیمیشن، Print Media Vanilla JavaScript

منطق برنامه (بدون فریم‌ورک) IndexedDB

ذخیره‌سازی داده‌ها در مرورگر Canvas API

پس‌زمینه متحرک SVG

نمودارهای گزارشات html2canvas

اسکرین‌شات از فاکتور Vazir Font

تایپوگرافی فارسی Jalaali Algorithm

محاسبات تاریخ شمسی 🚀 نصب و راه‌اندازی روش ۱: اجرای مستقیم (ساده‌ترین روش)

bash 1 2 3

روش ۲: کلون از GitHub

bash 1 2 3

روش ۳: اجرای با سرور محلی (اختیاری)

bash 1 2 3 4 5 6 7

⚙️ پیش‌نیازها

مرورگر مدرن (Chrome 80+، Firefox 75+، Edge 80+)
پشتیبانی از IndexedDB
JavaScript فعال

ساختار پروژه

1 2 3 4 5 6 7 8 9

🧩 ماژول‌های سیستم 1️⃣ داشبورد (Dashboard)

نمایش خلاصه وضعیت مالی
مجموع فروش، هزینه، سود ناخالص (مبلغ و درصد)
تعداد فاکتورهای تسویه‌نشده
لیست آخرین فاکتورها

2️⃣ طرف‌های حساب (Parties)

مدیریت مشتریان، همکاران و تأمین‌کنندگان
ثبت مانده حساب قبلی
محاسبه خودکار مانده فعلی
فیلد پورسانت برای همکاران

3️⃣ صدور فاکتور (New Invoice)

فرم کامل صدور فاکتور فروش
انتخاب همکار و تأمین‌کننده
اقلام نامحدود
تخفیف و ارزش افزوده
ثبت پرداخت و چک

4️⃣ فاکتورهای فروش (Sales Invoices)

لیست کامل فاکتورها
فیلتر بر اساس وضعیت
ویرایش و حذف
مشاهده و چاپ

5️⃣ فاکتورهای خرید (Purchase Invoices)

ایجاد خودکار از فاکتور فروش
ثبت پرداخت به تأمین‌کننده
محاسبه مانده بدهی

6️⃣ اسناد هزینه (Expenses)

ایجاد خودکار از فاکتور فروش
نمایش هزینه تمام‌شده هر فاکتور

7️⃣ پرداخت‌ها و چک‌ها (Payments & Checks)

دریافتی‌ها از مشتریان
پرداختی‌ها به تأمین‌کنندگان
مدیریت چک‌ها با وضعیت‌های مختلف

8️ گزارشات (Reports)

نمودار فروش، هزینه و سود
فیلتر تاریخ شمسی و خریدار
جدول جزئیات فاکتورها

9️⃣ تنظیمات (Settings)

اطلاعات شرکت
حساب‌های بانکی (کارت، شبا، حساب)
پشتیبان‌گیری و بازیابی JSON

📖 راهنمای استفاده شروع سریع

ثبت اطلاعات شرکت: از منوی تنظیمات > اطلاعات شرکت
افزودن حساب بانکی: از منوی تنظیمات > حساب‌های بانکی
ثبت مشتریان: از منوی طرف‌های حساب > مشتریان
ثبت همکاران: از منوی طرف‌های حساب > همکاران
ثبت تأمین‌کنندگان: از منوی طرف‌های حساب > تأمین‌کنندگان
صدور فاکتور: از منوی صدور فاکتور

فرآیند صدور فاکتور

1 2 3 4 5 6 7 8 9 10 11

چاپ و ارسال فاکتور

چاپ A4: دکمه «چاپ / PDF» → انتخاب Save as PDF
اسکرین‌شات: دکمه «اسکرین‌شات برای شبکه‌های اجتماعی» → دانلود PNG
ارسال: فایل PNG را در واتساپ، تلگرام، اینستاگرام و... ارسال کنید

💾 پشتیبان‌گیری و بازیابی روش‌های پشتیبان‌گیری

  1. دانلود JSON (همه مرورگرها)

1

فایل با نام karavang_backup_YYYY-MM-DD.json دانلود می‌شود. 2. ذخیره مستقیم روی دیسک (فقط Chrome/Edge دسکتاپ)

1

با استفاده از File System Access API، پوشه پیش‌فرض انتخاب می‌شود. 3. اشتراک‌گذاری (موبایل)

1

سپس از منوی اشتراک‌گذاری مرورگر، فایل را به Google Drive، تلگرام و... بفرستید. بازیابی اطلاعات

1

فایل JSON پشتیبان را انتخاب کنید. تمام داده‌ها بازیابی می‌شوند. پشتیبان‌گیری خودکار سیستم به‌صورت خودکار هر روز یک‌بار یادآوری پشتیبان‌گیری نمایش می‌دهد. 🔒 امنیت و حریم خصوصی ✅ مزایای امنیتی

بدون ارسال داده به سرور: تمام داده‌ها در مرورگر شما باقی می‌مانند
بدون ردیابی: هیچ Analytics یا Tracking وجود ندارد
کنترل کامل: شما مالک تمام داده‌های خود هستید

️ محدودیت‌های امنیتی

داده‌ها در IndexedDB مرورگر ذخیره می‌شوند (قابل دسترسی با Inspect Element)
در صورت پاک‌سازی کش مرورگر، داده‌ها حذف می‌شوند (مگر پشتیبان گرفته باشید)
برای داده‌های حساس، رمزنگاری سمت کلاینت پیشنهاد می‌شود

🛡️ توصیه‌های امنیتی

هر روز پشتیبان بگیرید
فایل پشتیبان را در مکان امن (رمزگذاری‌شده) نگهداری کنید
از مرورگرهای به‌روز استفاده کنید
در دستگاه‌های عمومی از سیستم استفاده نکنید

🗺️ نقشه راه توسعه نسخه 2.1 (فعلی) ✅

سیستم کامل حسابداری فروش
مدیریت طرف‌های حساب
فاکتور خرید و سند هزینه خودکار
مدیریت چک‌ها
گزارشات با نمودار
پشتیبان‌گیری JSON
اسکرین‌شات فاکتور
بهینه‌سازی موبایل

نسخه 2.2 (برنامه‌ریزی‌شده) 🚧

رمزنگاری داده‌ها با AES
پشتیبانی از PWA (نصب روی موبایل)
همگام‌سازی با ERP اصلی (Perfex)
گزارشات پیشرفته‌تر
مدیریت انبار ساده

نسخه 3.0 (آینده) 🔮

نسخه چندکاربره با Backend
API برای یکپارچگی با سایر سیستم‌ها
اپلیکیشن موبایل native
ماژول حقوق و دستمزد
ماژول انبارداری کامل

🤝 مشارکت در پروژه ما از مشارکت شما استقبال می‌کنیم! برای مشارکت:

Fork کنید
Branch جدید بسازید (git checkout -b feature/AmazingFeature)
Commit کنید (git commit -m 'Add some AmazingFeature')
Push کنید (git push origin feature/AmazingFeature)
Pull Request باز کنید

گزارش باگ اگر باگی پیدا کردید، لطفاً در بخش Issues گزارش دهید با:

توضیح مشکل
مراحل بازتولید
اسکرین‌شات (در صورت امکان)
نسخه مرورگر و سیستم‌عامل

📄 مجوز این پروژه تحت مجوز MIT License منتشر شده است. برای جزئیات بیشتر فایل LICENSE را مشاهده کنید.

1 2 3 4 5 6 7

📞 تماس با ما

🌐 وب‌سایت: karavang.ir
📧 ایمیل: info@karavang.ir
لینکدین: linkedin.com/company/karavang
توییتر: @karavang

🙏 قدردانی این پروژه با الهام از نیاز واقعی کسب‌وکارهای ایرانی در شرایط تحریم و قطعی اینترنت طراحی شده است. ساخته‌شده با ❤️ در ایران

⭐ اگر این پروژه برایتان مفید بود، لطفاً یک ستاره بدهید!

About

سامانه حسابداری کارآمد و بسیار ساده مناسب کسب و کارهای سطح کوچک تا متوسط بدون نیاز به نصب

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages