5.1 KiB
سپیدار فانزون — سیستم حسابداری (FunZone Accounting)
یک سیستم حسابداری یکپارچه با الهام از نرمافزار سپیدار، طراحیشده برای مجموعه FunZone. رابط کاربری کاملاً فارسی و راستبهچپ (RTL) با تجربه کاربری مدرن و ساده.
امکانات (ماژولها)
مطابق ساختار «سیستم»های سپیدار:
| ماژول | توضیح |
|---|---|
| داشبورد | شاخصهای کلیدی، نمودار روند فروش/خرید، هشدار موجودی، ترازنامه فشرده |
| حسابها (کدینگ) | کدینگ استاندارد حسابها (دارایی، بدهی، سرمایه، درآمد، هزینه) با گروه و معین |
| اسناد حسابداری | ثبت سند دوطرفه با کنترل تراز بدهکار/بستانکار و وضعیت پیشنویس/قطعی |
| مشتریان و فروش | مدیریت مشتریان و صدور فاکتور فروش با محاسبه تخفیف و مالیات |
| تأمینکنندگان و خرید | مدیریت تأمینکنندگان و ثبت فاکتور خرید |
| انبارداری | تعریف کالا، قیمتگذاری، کنترل موجودی و تعدیل انبار |
| دریافت و پرداخت | خزانهداری نقدی، بانکی و چک |
| حقوق و دستمزد | مدیریت کارکنان و صدور فیش حقوقی |
| مالکان مجموعهها | اطلاعات مالی واقعی صاحبان مجموعهها (از اپ مالکان): موجودی کیف پول، گردش حساب، برداشتها |
| کاربران | اطلاعات مالی واقعی مشتریان (از اپ مشتریان): موجودی، پرداختها و بازپرداختها |
| گزارشها | تراز آزمایشی، دفتر کل، صورت سود و زیان، ترازنامه |
| تنظیمات | اطلاعات شرکت، سال مالی، نرخ مالیات، اتصال به سرور |
اتصال به دادههای واقعی (بکاند فانزون)
دو بخش «مالکان مجموعهها» و «کاربران» دادهها را بهصورت زنده از بکاند funzone-backend میخوانند
(از همان APIهای مدیریتی پنل ادمین). برای اتصال:
- مطمئن شوید بکاند Django در حال اجراست (مثلاً روی
http://localhost:8000). - در برنامه به تنظیمات ← اتصال به سرور فانزون بروید.
- آدرس سرور (پیشفرض
http://localhost:8000/api) و نام کاربری/رمز عبور مدیر (admin) را وارد و «اتصال» را بزنید.
بهصورت اختیاری میتوانید آدرس سرور را در فایل .env نیز تنظیم کنید:
VITE_API_BASE_URL=http://localhost:8000/api
توکن دسترسی و آدرس سرور در مرورگر ذخیره میشوند. APIهای مورد استفاده فقط خواندنی هستند (لیست مالکان/کاربران، تراکنشها، پرداختها و برداشتها) و نیاز به دسترسی مدیر دارند.
پشته فناوری
- React 18 + TypeScript (strict)
- Vite 5
- Tailwind CSS 3
- React Router 6
- ذخیرهسازی محلی (localStorage) — بدون نیاز به بکاند
اجرا
npm install
npm run dev
برنامه روی پورت 5176 اجرا میشود: http://localhost:5176
دستورهای دیگر:
npm run build # بیلد تولیدی
npm run preview # پیشنمایش بیلد روی پورت 5176
npm run lint # بررسی نوعها (type-check)
Docker
docker compose up -d --build
The container serves the production build on http://localhost:3006.
Build-time API URLs (FunZone backend + accounting service):
VITE_API_BASE_URL=http://localhost:8001/api \
VITE_ACCOUNTING_BASE_URL=http://localhost:8010/api \
docker compose up -d --build
معماری
src/types— مدلهای دامنه با تایپ قویsrc/data— لایه ذخیرهسازی و دادههای نمونهsrc/store— مدیریت وضعیت سراسری (Context) با CRUD تایپشده و ذخیره خودکارsrc/utils— محاسبات حسابداری (تراز، دفتر کل، سود و زیان)، قالببندی اعداد و تاریخ شمسیsrc/components/ui— کیت رابط کاربری قابل استفاده مجددsrc/components/layout— چیدمان، نوار کناری و نوار بالاsrc/components/business— ماژول مشترک فروش/خریدsrc/pages— صفحات هر ماژول
دادهها در مرورگر ذخیره میشوند. برای بازگشت به دادههای نمونه از «تنظیمات ← بازنشانی» استفاده کنید.