پرش به محتوای اصلی

2 پست با برچسب "open-source"

مشاهده همه برچسب‌ها

Transform Your Financial Data into Beautiful Visualizations

· 4 دقیقه مطالعه
Mike Thrift
Mike Thrift
Marketing Manager

We're excited to announce a major enhancement to the Beancount.io ecosystem: the official integration of beancount-dashboard. This powerful new feature brings a suite of rich, interactive visualizations directly into Fava, allowing you to see your financial story in a clear, compelling, and actionable way.

Beancount Dashboard Overview


What is beancount-dashboard?

beancount-dashboard is an open-source plugin for Fava, the web interface for Beancount. It transforms your plain-text financial data into dynamic and insightful dashboards, making it easier than ever to understand your financial health and make informed decisions.

The plugin provides a wide range of powerful visualizations:

  • 📊 Comprehensive Asset Views: Track your wealth with a Net Worth Line Chart, monitor performance with detailed Portfolio Tracking, and visualize your distribution with Asset Allocation pie charts.
  • 💰 Income & Expenses Analytics: Understand your cash flow with precision. Analyze Monthly Averages, break down spending by Category, and see how your habits have changed with Year-over-Year Analysis.
  • ✈️ Travel Cost Management: Track annual travel costs and analyze spending patterns by destination to budget more effectively for future trips.
  • 🔄 Sankey Diagrams: Visualize the flow of your money with interactive charts that show how funds move between income sources, accounts, and expense categories.
  • 📈 Financial Projections: Plan for the future by using your historical data to set goals and project your financial trajectory.

Financial Analytics Dashboard


Why We Integrated beancount-dashboard

This integration is a game-changer for the Beancount community, offering four key benefits:

1. Enhanced User Experience

Beancount is built on a robust foundation of double-entry bookkeeping, but raw data can be overwhelming. The beancount-dashboard plugin transforms complex ledgers into intuitive visualizations, making financial management accessible and engaging for everyone.

2. Better Financial Decision Making

Visual dashboards empower you to make smarter financial choices. They help you identify trends, optimize budgets, track goals, and plan ahead with confidence by presenting your data in an easy-to-digest format.

3. Professional-Grade Analytics

This integration brings enterprise-grade analytical power to your fingertips. Powered by Apache ECharts, the dashboards offer interactive charts, custom views, and real-time updates that reflect your latest transactions. Its responsive design ensures a seamless experience on any device.

4. Open-Source Excellence

Both Beancount and beancount-dashboard are committed to open-source principles. This means you get complete transparency in how your data is handled, the assurance of privacy (since your data stays on your own infrastructure), and the support of an active and innovative community.

Advanced Portfolio Tracking


Real-World Benefits

This integration provides immediate and tangible benefits for various users:

For Personal Finance:

  • Budgeting: See exactly where your money goes each month.
  • Savings Goals: Visualize your progress toward an emergency fund, a vacation, or retirement.
  • Investment Monitoring: Keep a close eye on your portfolio performance and asset allocation.

For Small Businesses:

  • Cash Flow Management: Monitor business liquidity and understand cash flow patterns.
  • Expense Analysis: Analyze business costs by department, project, or vendor.
  • Financial Planning: Use historical data for more accurate budgeting and forecasting.

For Financial Advisors:

  • Client Presentations: Create professional, easy-to-understand financial reports.
  • Portfolio Analysis: Conduct comprehensive asset allocation and performance tracking.
  • Compliance: Maintain detailed and accessible records for auditing and reporting.

Ready to Transform Your Financial Life?

Your journey to better financial management starts now. With the power of beancount-dashboard, you have all the tools you need to take control of your finances.

  1. Visit beancount.io
  2. Create your free account to access the complete Beancount ecosystem.
  3. Join thousands of users already managing their finances with confidence.

We Want Your Feedback

Your insights are invaluable as we continue to refine our platform. Help us improve by sharing your dashboard success stories, feature requests, and any bug reports you encounter. You can connect with the Beancount.io team through our Community Forums, GitHub Issues, or on social media.

Join a Thriving Community

Connect with fellow Beancount users to share dashboard configurations, learn from experts, and contribute your own knowledge. Stay updated on new features and help shape the future of financial management.

This integration represents a significant step forward. By combining Beancount's robust accounting engine with the powerful visualizations of beancount-dashboard, we are providing enterprise-grade analytics in an open-source, privacy-focused package.

Ready to revolutionize your financial tracking? Register at beancount.io today, experience the power of beancount-dashboard, and help us build the future of financial management together!

مبانی حسابداری با Beancount: مسیری ساده با متن خام برای حساب‌های دقیق

· 8 دقیقه مطالعه
Mike Thrift
Mike Thrift
Marketing Manager

اگر نمی‌دانید پول کجا می‌رود، نمی‌توانید کسب‌وکار را هدایت کنید. حساب‌های دقیق، حدس و گمان را به بینش تبدیل می‌کنند. (Investopedia)

هر صاحب کسب‌وکار، فریلنسر یا بنیانگذار استارت‌آپ در نهایت با واقعیت یکسانی روبرو می‌شود: هرج‌ومرج مالی، قاتل رشد است. بدون تصویر واضحی از جریان نقدی خود، کورکورانه پرواز می‌کنید. اما اگر می‌توانستید امور مالی خود را با همان دقت و کنترلی که برای کد خود اعمال می‌کنید، مدیریت کنید، چه؟ Beancount را وارد کنید، یک سیستم حسابداری قدرتمند و متن‌باز که بر روی فایل‌های متنی ساده اجرا می‌شود.

2019-03-24-bookkeeping-basics

این راهنما شما را در اصول حسابداری راهنمایی می‌کند و به شما نشان می‌دهد که چگونه یک گردش کار مالی قوی، سبک و شفاف را با استفاده از Beancount ایجاد کنید.

حسابداری چیست؟

در هسته خود، حسابداری ثبت سیستماتیک و مداوم هر تراکنش مالی است که یک کسب‌وکار انجام می‌دهد. این نظم روزانه پیگیری درآمد، هزینه‌ها، دارایی‌ها (آنچه که دارید) و بدهی‌ها (آنچه که بدهکار هستید) است.

در دنیای Beancount، این سوابق در نرم‌افزار اختصاصی قفل نمی‌شوند. آن‌ها در فایل‌های متنی ساده و قابل خواندن توسط انسان زندگی می‌کنند. این رویکرد به شما امکان می‌دهد تاریخچه مالی خود را با ابزارهایی مانند Git، درست مانند یک پروژه نرم‌افزاری، کنترل نسخه کنید. هر ورودی توسط قانون توازن دوطرفه اداره می‌شود، یک سیستم زیبا که به طور خودکار کار شما را بررسی می‌کند و تضمین می‌کند که حساب‌های شما همیشه صحیح هستند. (beancount)

چرا اهمیت دارد؟

حسابداری دقیق فقط مربوط به مرتب بودن اداری نیست. این یک مزیت استراتژیک است.

  • اطمینان مالیاتی: وقتی فصل مالیات فرا می‌رسد، سوابق دقیق بهترین دوست شما هستند. اداره مالیات نیاز به مستندات واضح برای درآمد و کسورات دارد. یک دفتر کل به‌روز به این معنی است که می‌توانید با اطمینان خاطر پرونده تشکیل دهید و هرگونه حسابرسی احتمالی را به طور چشمگیری کوتاه کنید. (IRS)
  • تصمیم‌گیری‌های دقیق‌تر: آیا قیمت‌های شما به اندازه کافی بالا هستند؟ آیا یک قرارداد خدمات خاص واقعاً سودآور است؟ آیا هزینه‌های اشتراک از کنترل خارج می‌شوند؟ صورت‌های مالی مانند صورت سود و زیان و ترازنامه، نشتی‌های قیمت‌گذاری، هزینه‌های بی‌رویه و چاله‌های جریان نقدی را آشکار می‌کنند و به مدیران و سرمایه‌گذاران داده‌های لازم برای تصمیم‌گیری‌های هوشمندانه را می‌دهند. (Investopedia)
  • تأمین مالی آسان‌تر: وام‌دهندگان و سرمایه‌گذاران بر اساس احساسات تصمیم نمی‌گیرند. قبل از انتقال وجه، آن‌ها صورت‌های مالی را درخواست می‌کنند. حساب‌های خوب به شما این امکان را می‌دهند که در عرض چند ثانیه ترازنامه یا صورت سود و زیان ایجاد کنید و حرفه‌ای بودن و سلامت مالی را نشان دهید. (Investopedia)
  • هشدارهای تقلب و خطا: تطبیق معمول حساب‌های شما با صورت‌حساب‌های بانکی، اولین خط دفاعی شما در برابر اشتباهات است. این عادت ساده به شما کمک می‌کند تا هزینه‌های تکراری، خطاهای بانکی یا فعالیت‌های کلاهبرداری را به سرعت، قبل از اینکه به مشکلات قابل توجهی تبدیل شوند، تشخیص دهید. (IRS)

یک طرح هفت مرحله‌ای با متن ساده

آماده شروع هستید؟ در اینجا نحوه ساخت سیستم حسابداری Beancount خود از پایه آورده شده است.

۱. حساب‌های تجاری و شخصی را جدا کنید

این اولین قدم غیرقابل مذاکره است. یک حساب جاری تجاری اختصاصی و در صورت لزوم، یک کارت اعتباری تجاری باز کنید. ترکیب وجوه، کابوسی برای حسابداری ایجاد می‌کند و می‌تواند مرزهای مسئولیت بین شما و کسب‌وکارتان را محو کند. جداسازی دقیق برای کسورات دقیق و حمایت قانونی ضروری است. (Small Business Administration)

در Beancount، شما وجود این حساب‌ها را با دستور open اعلام می‌کنید:

; موجودی اولیه برای حساب‌های شما
2025-07-22 open Assets:Bank:Business USD
2025-07-22 open Assets:Bank:Personal USD

۲. یک سیستم حسابداری انتخاب کنید

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

۳. در مورد روش حسابداری تصمیم بگیرید

شما در اینجا دو انتخاب اصلی دارید:

  • مبنای نقدی: شما درآمد را هنگام دریافت پول و هزینه‌ها را هنگام پرداخت آن‌ها ثبت می‌کنید. ساده‌تر است و جریان نقدی شما را مستقیماً منعکس می‌کند.
  • مبنای تعهدی: شما درآمد را هنگام کسب آن (مثلاً هنگام ارسال فاکتور) و هزینه‌ها را هنگام تحمل آن‌ها (مثلاً هنگام دریافت صورت‌حساب) ثبت می‌کنید. این روش تصویر واقعی‌تری از سلامت و عملکرد مالی یک شرکت، به ویژه برای شرکت‌های در حال رشد، ارائه می‌دهد. (Investopedia)

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

; مثال تعهدی: فاکتور صادر شده، پرداخت بعداً
2025-07-22 * "فاکتور طراحی #101"
Assets:AccountsReceivable 3000.00 USD
Income:Design

2025-08-15 * "مشتری فاکتور #101 را پرداخت می‌کند"
Assets:Bank:Business 3000.00 USD
Assets:AccountsReceivable

۴. ابزارهای خود را جمع‌آوری کنید

زیبایی Beancount در ماهیت مینیمالیستی و ماژولار آن است. ابزارهای اصلی شما عبارتند از:

  • ویرایشگر + Git: ویرایشگر متن مورد علاقه شما برای ثبت تراکنش‌ها و Git برای کنترل نسخه، به شما یک تاریخچه کامل و قابل حسابرسی از هر تغییر می‌دهد.
  • bean-report / bean-balance / Fava: ابزارهای خط فرمان مانند bean-report و رابط وب خیره‌کننده Fava به شما صورت‌های مالی فوری، داشبوردها و قابلیت‌های فیلتر قدرتمند می‌دهند.
  • واردکنندگان: یک اکوسیستم غنی از واردکنندگان ساخته شده توسط جامعه می‌تواند از طریق CSV، Plaid یا API برای سرویس‌هایی مانند Stripe و PayPal به فیدهای بانکی شما متصل شود و بسیاری از ورودی داده‌ها را خودکار کند.

۵. هر تراکنش را دسته‌بندی کنید

یک "چارت حساب" منظم، ستون فقرات گزارش‌دهی دقیق است. دسته‌هایی را تعریف کنید که برای کسب‌وکار شما منطقی باشد و از حساب‌های سلسله مراتبی برای جزئیات استفاده کنید. سپس، هنگام ثبت تراکنش‌ها، آن‌ها را با دقت دسته‌بندی کنید.

2025-07-30 * "صورت‌حساب ماهانه AWS"
Expenses:Hosting:AWS 124.50 USD
Assets:Bank:Business
tag: "ops"

در این مثال، هزینه به وضوح در زیر Expenses:Hosting:AWS ثبت شده است. استفاده از tag: "ops" همچنین امکان گزارش‌های متقاطع، مانند مشاهده همه هزینه‌های عملیاتی صرف نظر از دسته اصلی آن‌ها را فراهم می‌کند. (IRS)

۶. اسناد منبع را با خیال راحت ذخیره کنید

اداره مالیات با کمال میل کپی‌های دیجیتالی رسیدها و فاکتورها را می‌پذیرد. رسیدهای کاغذی را اسکن کنید یا فاکتورهای ایمیل را به یک پوشه اختصاصی در فضای ذخیره‌سازی ابری (مانند Google Drive یا Dropbox) ارسال کنید. سپس، با استفاده از ابرداده، مستقیماً به فایل در ورودی Beancount خود پیوند دهید. این یک رکورد خودکفا و بدون نقص ایجاد می‌کند.

; تصویر رسید به عنوان ابرداده پیوند داده شده است
2025-07-18 * "ناهار تیمی"
Expenses:Meals 85.10 USD
Assets:Bank:Business
receipt: "receipts/2025-07-18-team-lunch.jpg"

۷. حسابداری را به یک عادت تبدیل کنید

ثبات کلید است. تعلل، حسابداری را به یک کار استرس‌زا و وقت‌گیر تبدیل می‌کند. یک بلوک زمانی تکراری - یک "روز-Bean" هفتگی یا ماهانه - برای وارد کردن تراکنش‌ها، تطبیق حساب‌ها و بررسی گزارش‌های مالی خود کنار بگذارید. این روال ساده، حسابداری را از یک تلاش فصلی به یک بررسی سلامت سریع و توانمندکننده کسب‌وکار تبدیل می‌کند. (IRS)

خودتان انجام دهید در مقابل کمک حرفه‌ای

  • خودتان انجام دهید: برای فریلنسرها یا مشاغل کوچک با حجم تراکنش قابل پیش‌بینی، یک رویکرد خودتان انجام دهید با Beancount فوق‌العاده مؤثر است. همچنان عاقلانه است که یک مشاوره مختصر و یک‌باره با یک حسابدار رسمی داشته باشید تا چارت حساب‌های شما را تأیید کند و مطمئن شوید که در مسیر درستی هستید.
  • بررسی حرفه‌ای: با گسترش کسب‌وکار شما، پیچیده‌تر شدن تراکنش‌ها یا افزایش ریسک انطباق، استفاده از یک حسابدار یا حسابدار حرفه‌ای برای بررسی‌های دوره‌ای بسیار ارزشمند است. می‌توانید به استفاده از Beancount به عنوان منبع اصلی حقیقت خود ادامه دهید و به سادگی گزارش‌های مورد نیاز آن‌ها را صادر کنید.

چک لیست شروع سریع

  • حساب‌های بانکی تجاری جداگانه باز کنید.
  • مخزن شروع Beancount را کلون کنید و حساب‌های خود را در accounts.bean تعریف کنید.
  • نقدی یا تعهدی را انتخاب کنید و به آن پایبند باشید.
  • واردکنندگان را برای خودکارسازی ورود داده از بانک (CSV)، Stripe، PayPal و غیره تنظیم کنید.
  • برای هر تراکنش برچسب بزنید و توضیحات واضح بنویسید.
  • دفتر کل خود را هفتگی یا ماهانه با صورت‌حساب‌های بانکی تطبیق دهید.
  • با استفاده از Fava یا bean-report گزارش‌های ماهانه درآمد، ترازنامه و جریان نقدی ایجاد کنید.
  • به طور منظم از فایل‌های .bean خود نسخه پشتیبان تهیه کنید (Git + ذخیره‌سازی خارج از سایت).

مطالعه بیشتر

آماده شروع هستید؟ Beancount را نصب کنید، اولین ورودی خود را ثبت کنید و مه صفحات گسترده را با شفافیت متن ساده عوض کنید. حسابداری مبارک!