**ساختمانِ هوشمند** یک سامانهی کامل و فارسی برای مدیریت ساختمانهای مسکونی و
تجاری است: **صدور و وصول شارژ، ثبت و پیگیری شکایات، رأیگیری عمومی، اعلان به
ساکنین، ارسال پیامک و پرداخت آنلاین** — همه در یک پنل امن، راستچین و با تقویم
شمسی.
این محصول برای **مدیران ساختمان، شرکتهای مدیریت املاک و اتحادیههای مالکان**
طراحی شده است؛ بدون نیاز به دانش فنی، روی هر هاست PHP نصب میشود و در همان
روز اول قابل استفاده است.
---
## چرا «ساختمانِ هوشمند»؟
مدیریت یک ساختمان بزرگتر از یک واحد، یعنی دهها کار تکراری: یادآوری شارژ
صورتحسابها، پاسخ به شکایات، برگزاری رأیگیری برای تصمیمات مشترک و اطلاعرسانی
به ساکنین. این کارها با کاغذ، گروههای پیامرسان یا اکسل، شفاف نمیمانند و
حقوق قانونی ساکنین و مدیران ضایع میشود.
ساختمانِ هوشمند همهی این فرایندها را **در یک جایگاه واحد و قانونی** گرد میآورد:
- شفافیت مالی کامل برای هر ساکن و مدیر
- حذف تماسهای تکراری با ساکنین برای مطالبات
- تصمیمگیری جمعیِ مستند با رأیگیری آنلاین
- دسترسی به تاریخچهی کامل تعاملات ساختمان
---
## ماژولهای اصلی
### ۱) شارژ ساختمان و مالی
- صدور **یکبارهی دورهای** شارژ برای همهی واحدها (مبلغ + دورهی شمسی + مهلت پرداخت)
- صورتحساب مستقل برای هر واحد با وضعیت «در انتظار / پرداختشده / معوق»
- پرداخت **آنلاین با درگاه زرینپال** یا **آپلود رسید توسط ساکن** و تأیید توسط مدیر
- چند کلید مرچنت (حساب بانکی) قابل ثبت برای یک ساختمان
- گزارش مالی دورهای: مبلغ صادرشده، وصولشده و باقیمانده
- محاسبهی خودکار تاریخ سررسید و علامتگذاری صورتحسابهای معوق
### ۲) شکایات و درخواستها
- ثبت شکایت توسط ساکن با اولویت (فوری / عادی / کماهمیت)
- پاسخگویی مدیر و ثبت مکالمه بهصورت نخ زمانی
- بستن شکایت پس از حل مشکل
- تاریخچهی کامل برای پیگیریهای قانونی
### ۳) رأیگیری عمومی
- ایجاد رأیگیری با چند گزینه و تاریخ پایان (شمسی)
- رأیگیری **یکبارمصرف** برای هر ساکن (کنترل در پایگاهداده)
- نمایش **نتایج زنده** و درصدی
- بستن رأیگیری پس از پایان و ثبت نتیجه
### ۴) اعلان عمومی
- اطلاعرسانی به همهی ساکنین (قطعی آب، جلسهی مجمع، تعطیلات…)
- اولویتگذاری و سنجاق کردن اعلان مهم
- تاریخ انقضای خودکار (شمسی)
### ۵) پیامک (اطلاعرسانی خودکار)
- اتصال به ارائهدهندههای پیامک ایرانی (**کاوهنگار، ملیپیامک، فراپیامک**)
- ارسال پیامک گروهی به همهی ساکنین یا یک واحد خاص
- **اطلاعرسانی خودکار هنگام صدور شارژ جدید**
- تاریخچهی کامل ارسالها با وضعیت موفق/ناموفق
---
## نقشها و سطوح دسترسی
| نقش | دسترسی |
|---|---|
| **ابرمدیر** | مدیریت همهی ساختمانها، انتصاب مدیر هر ساختمان، دیدن کل گزارشها |
| **مدیر ساختمان** | مدیریت واحدها و ساکنین ساختمان خود، صدور شارژ، تأیید پرداختها، پاسخ به شکایات، رأیگیری و اعلان |
| **ساکن** | مشاهدهی صورتحسابهای واحد خود، پرداخت آنلاین یا آپلود رسید، ثبت شکایت، رأی دادن و خواندن اعلانها |
هر ساکن فقط دادههای **واحد خودش** را میبیند و هر مدیر فقط **ساختمان خودش** را.
ابرمدیر میتواند بین ساختمانها جابجا شود و همهی بخشهای هر ساختمان را مدیریت کند.
---
## امنیت — استانداردهای بانکی
محصولی که روی آن **پول جابجا میشود** باید امن باشد. ساختمانِ هوشمند با این لایهها
ساخته شده است:
- **رمزهای عبور:** هش bcrypt با cost ۱۲ + الزامی بودن حداقل ۱۰ کاراکتر در اولین ورود
- **ضد درخواستهای خودکار:** کپچای عددی در صفحهی ورود + قفل حساب پس از ۵ تلاش ناموفق
- **تزریق SQL:** فقط عبارات آماده (prepared statements) در کل کد
- **XSS:** فیلتر کامل خروجی + سیاست امنیتی محتوای سخت (CSP `default-src 'self'`)
- **CSRF:** توکن یکتا برای همهی فرمها و درخواستهای AJAX
- **آپلود رسید:** بررسی امضای فایل (magic bytes)، تغییر نام تصادفی، ذخیرهی خارج از
دسترسی مستقیم وب و بررسی مالکیت هنگام دانلود
- **درگاه پرداخت:** تأیید دوبارهی تراکنش از سمت سرور با مبلغ خواندهشده از دیتابیس
(نه از مرورگر کاربر) — غیرقابل دستکاری
- **نشست امن:** HttpOnly + SameSite، انقضای ۳۰ دقیقه، بازتولید شناسهی نشست پس از ورود
---
## طراحی و تجربهی کاربری
- **کاملاً فارسی و راستچین** با اعداد فارسی، نیمفاصله و واحد پول تومان/ریال
- **تقویم شمسی** در همهی فرمها (هیچ تاریخ میلادیای به کاربر نشان داده نمیشود)
- **۷ تم رنگی** قابل انتخاب که به کل سایت اعمال میشود:
طلاییِ شب (پیشفرض) · کلاسیک · حرفهای · سهبعدی · نیمهشب · مرمرِ سبز · گلگون
- صفحهی فرم با **هیرو سهبعدی** (Three.js — با حالت کمرمز برای موبایل)
- سازگار با موبایل (طراحی واکنشگرا)، پشتیبانی از کاهش حرکت (accessibility)
- **صفر وابستگی خارجی:** همهی فونتها، اسکریپتها و تصاویر محلی بارگذاری میشوند
| جزء | جزئیات |
|---|---|
| زبان | PHP 8.2 (strict types) — بدون فریمورک سنگین |
| پایگاهداده | MySQL 5.7+ / MariaDB 10.3+ — ۱۷ جدول، charset utf8mb4_persian_ci |
| طراحی | HTML5 + CSS توکنی + JavaScript ماژولار (ES Modules) |
| رابط کاربری | واکنشگرا (RTL)، داشبورد مجزای مدیر و ساکن |
| حجم پروژه | کمتر از ۳ مگابایت (شامل فونتها و کتابخانهها) |
| مجوز استفاده | نسخهی کامل، قابل نصب روی **هر تعداد سایت** (پروژهی قابل فروش) |