همسایه یک پلتفرم یکپارچه برای مدیریت ساختمان‌های مسکونی است: ارتباط شفاف بین ساکنان و مدیریت، شارژ ماهانه با رسید کارت‌به‌کارت، رأی‌گیری، تیکت پشتیبانی، و گفتگوی همگانی زنده.
| ماژول | توضیح |
|---|---|
| داشبورد | نمای کلی اعلان‌ها، تیکت‌ها، شارژ و اعلان‌های سیستمی |
| اعلانات | ارسال اعلان همگانی توسط مدیریت (جلسات، قطعی‌ها، اخبار مهم) |
| گفتگوی همگانی | چت گروهی زنده (SSE) با ویرایش، ایموجی، و ارسال عکس/فایل |
| تیکت پشتیبانی | درخواست رسمی ساکن ↔ مدیریت با وضعیت و پاسخ |
| اعضا | فهرست ساکنان و نقش‌ها |
| قوانین | آیین‌نامه ساختمان |
| رأی‌گیری | ایجاد نظرسنجی و رأی اعضا با نمودار نتیجه |
| شارژ ماهانه | صدور شارژ، شماره کارت مدیریت، آپلود رسید، OCR مبلغ، بررسی مقصد واریز، کیف پول برای مازاد |
| هزینه‌ها | ریز هزینه‌های مشاعات |
| نظافت | برنامه هفتگی نظافت مشاعات |
| تم تاریک/روشن | ذخیره در مرورگر |
| ساعت شمسی | تاریخ و ساعت جلالی زنده در هدر |
- مدیریت شماره کارت/حساب را تنظیم و شارژ ماه را صادر می‌کند
- ساکن مبلغ را کارت‌به‌کارت واریز می‌کند
- عکس رسید را آپلود می‌کند؛ مبلغ با OCR خوانده می‌شود
- مقصد واریز با حساب مدیریت تطبیق داده می‌شود
- سر به سر → پرداخت کامل · کمتر → کسری (قرمز) · بیشتر → مازاد به کیف پول (سبز)
- Next.js (App Router) + TypeScript + Tailwind CSS
- Prisma + SQLite
- احراز هویت مبتنی بر کوکی امضاشده (نقش مدیر / ساکن)
- OCR رسید با Tesseract.js (کلاینت)
- چت زنده با Server-Sent Events
npm install
npm run db:push
npm run db:seed
npm run devباز کنید: http://localhost:3000
| نقش | ایمیل | رمز |
|---|---|---|
| مدیر | manager@hamsaye.local |
123456 |
| ساکن | ali@hamsaye.local |
123456 |
فایل
.envرا کپی/تنظیم کنید (DATABASE_URL,SESSION_SECRET). دیتابیس SQLite محلی است و در گیت نیست.
src/app/(app)/ # صفحات پنل (داشبورد، شارژ، چت، …)
src/app/api/ # API routes
src/components/ # UI مشترک، تم، ساعت شمسی
src/lib/ # auth, prisma, OCR, wallet
prisma/ # schema + seed
public/illustrations/ # تصاویر وکتور برند
پروژه نمونه آموزشی/دمو. برای استفاده عملی، امنیت پرداخت و احراز هویت را مطابق نیاز خود سخت‌تر کنید.
ساخته‌شده برای مدیریت بهتر زندگی در ساختمان — همسایه