هر آنچه برای نصب، پیکربندی و استفاده از OpenConstructionERP برای برآورد حرفهای هزینه ساختوساز لازم دارید.
آنبوردینگ → پروژه جدید → BoQ → پیوند BIM → DWG → متره PDF → برآورد کامل → کارها → Data Explorer → برآورد هوش مصنوعی → پورتفولیو.
زیرنویس، فصلها و پخش 1.5× در همان پخشکننده بالا تعبیه شدهاند. ترجیح میدهید مستقیم در YouTube ببینید؟ ▶ باز کردن در YouTube · اشتراک در کانال برای دیدن مرورهای نسخههای جدید.
هر بلوک زیر یک GIF کوتاه بریدهشده از مرور کامل بالاست - همان ترتیب ویدیو، تا بتوانید مستقیم به هر روال کاری که مهمتر است بروید. یک جریان پیوسته میخواهید؟ ▶ مرور 12 دقیقهای را در YouTube تماشا کنید.
OpenConstructionERP یک پلتفرم کامل برآورد هزینه ساختوساز و مدیریت پروژه است که کاملاً روی دستگاه خودتان اجرا میشود. این پلتفرم مجموعههای گرانقیمت برآورد تجاری را با یک جایگزین باز و خودمیزبان جایگزین میکند. پلتفرم کل چرخه عمر ساختوساز را پوشش میدهد - از مطالعات امکانسنجی اولیه و متره مقادیر تا تهیه تفصیلی BOQ، مناقصهگزاری، مقایسه پیشنهادها، اجرای پروژه، مدیریت کیفیت و کنترل مالی. همه دادههای شما روی سرور خودتان میماند. بدون وابستگی به ابر، بدون اشتراک، بدون هزینه بهازای کاربر.
نکات برجسته v18.5.0: بیش از 190 ماژول که کل چرخه عمر ساختوساز را پوشش میدهند: دفتر مخاطبان، وظایف با Kanban، پیگیری RFI، مالی (صورتحساب، بودجه، EVM)، تدارکات، ایمنی، جلسات، بازرسی کیفیت، NCR، submittals، مکاتبات، CDE (ISO 19650)، transmittals، BIM Hub، ثبت دارایی با خروجی COBie، گزارشدهی & داشبورد KPI، markups (PDF↔DWG↔hub)، تجسمهای pivot & انتخابگر ستون نمودار، سرویس ایمیل افزونهپذیر، مخاطبان چندمستاجری، گزارشهای زمانبندیشده، Regional Packs و درونریزی/برونبری کامل.


فهرست مقادیر سلسلهمراتبی با بخشها، ردیفها، منابع، اسمبلیها و اضافهبهاهای خودکار.
پایگاههای هزینه از 9 منبع ملی، منتشرشده در 48 نسخه بازار با ارز و زبان محلی، همراه با 36 پایگاهداده منطقهای آماده برای درونریزی.
از متن، عکس، PDF، اکسل یا مدلهای CAD/BIM با استفاده از هر ارائهدهنده LLM، BOQ بسازید.
مقادیر را از RVT، IFC، DWG، DGN از طریق مبدلهای DDC استخراج کنید.
زمانبندی گانت با CPM، مدیریت ارزش کسبشده، منحنی S و شبیهسازی مونتکارلو.
مالی، ایمنی، کیفیت، CDE، هاب BIM، تدارکات، RFI، کارها، جلسات و موارد دیگر. فقط آنچه را نیاز دارید فعال کنید.
پس از نصب OpenConstructionERP، این مراحل را دنبال کنید تا اولین پروژه خود را راهاندازی و اولین برآورد هزینه خود را ایجاد کنید. کل فرایند حدود 10 دقیقه طول میکشد.
مرورگرتان را باز کنید و به http://localhost:5173 (توسعه محلی) یا http://localhost:8080 (Docker) بروید. صفحه ورود را با پنل «دسترسی نمایشی» میبینید. برای ورود آنی با حساب نمایشی روی Admin کلیک کنید، یا اگر یک حساب جدید ثبت کردهاید، اطلاعات ورود خودتان را وارد کنید.
در اولین ورود، ویزارد آنبوردینگ شما را در تنظیمات اولیه راهنمایی میکند:
روی پروژه جدید در داشبورد کلیک کنید یا به پروژهها بروید. اینها را پر کنید:
پس از ساخت پروژه، به صفحه جزئیات پروژه هدایت میشوید که در آن میتوانید افزودن BOQها را شروع کنید.
از صفحه پروژه، روی برآورد جدید کلیک کنید. یک نام برای آن بگذارید (مثلاً «برآورد هزینه v1») و در صورت تمایل یک قالب انتخاب کنید. ویرایشگر BOQ با یک جدول خالی و آماده برای اولین ردیف شما باز میشود.
در ویرایشگر BOQ، روی افزودن ردیف کلیک کنید یا در یک ردیف خالی کلید Enter را بزنید. موارد زیر را پر کنید:
ستون جمع کل بهطور خودکار محاسبه میشود (مقدار × نرخ واحد). همچنین میتوانید با کلیک روی نماد پایگاهداده کنار هر ردیف، در پایگاهداده هزینه جستوجو کنید تا نرخی را از میان بیش از 120 هزار قلم هزینه فهرستشده پیدا و اعمال کنید.
OpenConstructionERP طوری طراحی شده که نصب آن صرفنظر از سطح فنی شما آسان باشد. روشی را انتخاب کنید که با پیکربندی شما همخوان است - همه گزینهها کمتر از 5 دقیقه طول میکشند. برنامه بهطور پیشفرض از یک PostgreSQL توکار استفاده میکند (بدون Docker، بدون سرور پایگاهداده جداگانه، بدون هیچ راهاندازی)، بنابراین همهچیز از همان ابتدا کار میکند. برای مسیرهای pip و نصب یکخطی Python 3.12+ لازم است.
pip install --upgrade openconstructionerp
openconstructionerpبکاند + فرانتاند از پیش ساختهشده React را در یک wheel نصب میکند. با رابط کاربری کامل در http://localhost:8080 باز میشود. PostgreSQL داخلی، بدون پیکربندی. اگر چیزی درست به نظر نمیرسد، openconstructionerp doctor را اجرا کنید.
در اوبونتو 23.04 به بعد (از جمله اوبونتو 26) و دبیان 12 به بعد، اجرای مستقیم pip install روی Python سیستمی با خطای error: externally-managed-environment (PEP 668) شکست میخورد. در عوض از یک محیط مجازی استفاده کنید:
# Ubuntu 26 - install Python 3.12 explicitly if needed
sudo apt install -y python3.12 python3.12-venv
# Create and activate a venv, then install
python3.12 -m venv ~/ocerp-venv
source ~/ocerp-venv/bin/activate
pip install --upgrade openconstructionerp
openconstructionerpاگر pip به ساخت از سورس بازگردد، هدرها را نصب کنید: sudo apt install -y build-essential libpq-dev libjpeg-dev zlib1g-dev libgeos-dev. راهنمای کامل لینوکس همراه با رفع اشکال: docs/INSTALL_LINUX.md.
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.ps1 | iexاگر Docker نصب باشد آن را انتخاب میکند، در غیر این صورت uv و در غیر این صورت pip. در http://localhost:8080 اجرا میشود.
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstartدر http://localhost:8080 باز میشود (اولین ساخت حدود 2 دقیقه طول میکشد).
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
# Backend (embedded PostgreSQL, zero config)
cd backend && pip install -r requirements.txt
uvicorn app.main:create_app --factory --reload --port 8000
# Frontend (new terminal)
cd frontend && npm install && npm run devبکاند: http://localhost:8000 / فرانتاند: http://localhost:5173
| حساب | ایمیل | گذرواژه | نقش |
|---|---|---|---|
| Admin | demo@openconstructionerp.com | DemoPass1234! | دسترسی کامل |
| Estimator | estimator@openconstructionerp.com | DemoPass1234! | برآوردگر |
| Manager | manager@openconstructionerp.com | DemoPass1234! | مدیر |
5 پروژه نمایشی (برلین، لندن، نیویورک، پاریس، دبی) با BOQهای کامل، زمانبندیها و مدلهای هزینه.
ویرایشگر فهرست مقادیر جایی است که بیشترین زمان خود را در آن میگذرانید. این ویرایشگر رابط کاربری حرفهای و شبیه صفحهگستردهای را با قدرت AG Grid ارائه میدهد که امکانات مخصوص ساختوساز در آن تعبیه شده - بخشهای سلسلهمراتبی، پیوند منابع، دستورالعملهای اسمبلی و محاسبه خودکار اضافهبها. هر تغییری با پشتیبانی کامل از واگرد/ازنو ردیابی میشود. 42 قاعده اعتبارسنجی بهطور خودکار در پسزمینه اجرا میشوند و خطاهایی مانند مقادیر ازقلمافتاده، قیمتهای صفر، ردیفهای تکراری و مسائل انطباق طبقهبندی را پیش از آنکه به مشکل تبدیل شوند، شناسایی میکنند.
🎬 ویرایشگر BOQ را در عمل در یوتیوب ببینید - ویرایش با اولویت صفحهکلید، بیش از 120 هزار قلم قیمتگذاریشده، امتیاز کیفیت زنده.



بخشها BOQ شما را به گروههای منطقی سازماندهی میکنند (مثلاً «300 سازه»، «400 تهویه مطبوع»). برای ساخت یک بخش:
میتوانید بخشها را جمع/باز کنید تا روی رشتههای خاص تمرکز کنید. بخشها را بکشید تا کل ساختار BOQ را بازچینی کنید.
هر ردیف BOQ میتواند منابع پیوندخورده داشته باشد که نرخ واحد را به اجزا تجزیه میکنند:
برای افزودن منابع: ردیف موردنظر را باز کنید، روی «افزودن منبع» کلیک کنید، در کاتالوگ جستوجو کنید، ضریب مقدار را تنظیم کنید (مثلاً 120 کیلوگرم آرماتور به ازای هر متر مکعب بتن). نرخ واحد ردیف بهطور خودکار از مجموع منابع آن بهروزرسانی میشود.
اضافهبها پس از جمع خالص (مجموع همه ردیفها) اعمال میشود. اضافهبهاهای رایج عبارتاند از:
روی افزودن اضافهبها در نوار ابزار کلیک کنید. میتوانید پیشفرضهای منطقهای تنظیم کنید یا برای هر پروژه سفارشیسازی کنید. اضافهبها میتواند درصدی یا مبلغ ثابت باشد و به ترتیب روی هم اعمال میشود (ابتدا سربار، سپس سود روی مبلغ شامل سربار، سپس مالیات بر ارزشافزوده روی جمع کل).
برای اجرای اعتبارسنجی، کلیدهای Ctrl+Shift+V را بزنید یا روی نماد سپر در نوار ابزار کلیک کنید. سیستم BOQ شما را در برابر مجموعه قواعد انتخابشده بررسی میکند و نتایج را بهصورت درونخطی نشان میدهد:
ویرایشگر BOQ از درونریزی داده از چند منبع پشتیبانی میکند:
| میانبر | عملکرد |
|---|---|
Ctrl+K | پالت دستورها |
Ctrl+N | پروژه جدید |
Ctrl+Shift+V | اجرای اعتبارسنجی |
Ctrl+Z / Y | واگرد / ازنو |
به بزرگترین پایگاه داده متنباز هزینه ساختوساز در جهان دسترسی پیدا کنید: بیش از 120,000 ردیف هزینه در بیش از 40 منطقه. پایگاه جهانی CWICR بیش از 55,000 ردیف با توضیحات تا 9 زبان اضافه میکند که بر اساس رشته (خاکبرداری، بتن، بنایی، فولاد، بام، نما، تأسیسات مکانیکی، برق، لولهکشی، نازککاری، محوطهسازی) مرتب شدهاند. هر ردیف شامل واحد اندازهگیری، نرخ پایه برای منطقه مشخصشده، کدهای طبقهبندی (DIN 276، NRM، MasterFormat) و در صورت وجود، تفکیک مصالح، نیروی کار و تجهیزات است.


| منطقه | ارز | استاندارد | اقلام |
|---|---|---|---|
| آلمان (DACH) | EUR | DIN 276 | 55,719 |
| بریتانیا | GBP | NRM 1/2 | 55,719 |
| ایالات متحده | USD | MasterFormat | 55,719 |
| فرانسه | EUR | DPGF | 55,719 |
| روسیه | RUB | GESN | 55,719 |
| امارات متحده عربی | AED | محلی | 55,719 |
| چین | CNY | GB/T | 55,719 |
| هند | INR | CPWD | 55,719 |
پایگاهداده هزینه برای دو گردشکار اصلی طراحی شده است:
هر قلم هزینه شامل موارد زیر است:
جستوجوی معنایی را فعال کنید تا اقلام هزینه را بر اساس معنا پیدا کنید، نه صرفاً تطبیق دقیق کلیدواژه. وقتی «دیوار بتنی» را جستوجو میکنید، سیستم اقلامی مانند «پارتیشن مسلح C30/37، 24 سانتیمتر با قالببندی» را نیز مییابد - حتی اگر کلمات دقیق در آن نباشند. این قابلیت با کمک embeddingهای sentence-transformer کار میکند که شرحها را به بردارهای عددی تبدیل میکنند و نزدیکترین تطبیقها را در فضای چندبعدی مییابند. دو بکاند پایگاهداده برداری پشتیبانی میشود: LanceDB (تعبیهشده، درونفرایندی مانند SQLite، embeddingهای 384بعدی) و Qdrant (سرور تولیدی با نمونههای آماده 3072بعدی قابلدانلود از GitHub).
مقادیر را مستقیماً از نقشهها و مدلهای پروژه خود استخراج کنید - بدون نیاز به شمارش دستی. فایلهای RVT، IFC، DWG یا DGN را بارگذاری کنید و سیستم هر عنصر ساختمانی را با حجم، مساحت و طول استخراج میکند. برای نقشههای PDF، آنها را مستقیماً در مرورگر باز کنید و از ابزارهای اندازهگیری کالیبرهشده برای متره فاصله، مساحت و تعداد عناصر استفاده کنید. همه مقادیر استخراجشده را میتوان برای قیمتگذاری به یک BOQ منتقل کرد.
🎬 فصلهای پیوند دستهای BIM → BOQ، متره لایههای DWG و اندازهگیری PDF را در یوتیوب تماشا کنید.





| فرمت | نرمافزار | مبدل |
|---|---|---|
| .rvt / .rfa | BIM | DDC RvtExporter |
| .ifc | IFC (هر BIM) | DDC IfcExporter |
| .dwg / .dxf | CAD | DDC DwgExporter |
| .dgn | CAD | DDC DgnExporter |
هر ارائهدهنده LLM را متصل کنید تا از توضیحات متنی ساده، عکسهای ساختمان، PDFهای اسکنشده، صفحات Excel یا مدلهای CAD/BIM، برآورد هزینه ساختوساز تولید کنید. سیستم AI موقعیتهای کامل BOQ را با مقادیر و قیمتگذاری نرخ بازار میسازد. پس از تولید، میتوانید هر قلم را با پایگاهداده هزینه CWICR تطبیق دهید تا نرخهای برآوردشده توسط AI را با قیمتهای بازار منطقهای تأییدشده جایگزین کنید. قابلیتهای AI کاملاً اختیاریاند - پلتفرم بدون آنها هم بهطور کامل کار میکند.
🎬 «برآورد هوش مصنوعی از یک عکس» را در یوتیوب ببینید - یک عکس ساختوساز آپلود کنید و ظرف چند ثانیه یک BOQ محدودهبندیشده دریافت کنید.


| ارائهدهنده | مدلها | قابلیتها |
|---|---|---|
| Anthropic | Claude Sonnet / Opus | متن، تصویر، اسناد |
| OpenAI | GPT-4o | متن، تصویر، اسناد |
| Gemini Pro | متن، تصویر | |
| Mistral / Groq / DeepSeek | متنوع | متن |
پروژهتان را با متن ساده توضیح دهید و AI بین 15 تا 30 قلم BOQ با مقادیر و نرخهای بازار تولید میکند.
برآوردهای AI را با پایگاهداده CWICR تطبیق دهید تا نرخهای حدسی را با قیمتهای واقعی بازار جایگزین کنید.
با استفاده از پایگاهداده هزینه خودتان بهعنوان زمینه، با AI درباره هزینهها، مصالح و قیمتگذاری گفتگو کنید.

با ابزارهای یکپارچه برنامهریزی زمانی و مدلسازی مالی، جدول زمانی پروژه ساختوساز خود را برنامهریزی کنید و هزینهها را در طول زمان پیگیری کنید.
ماژول برنامهریزی یک نمودار گانت حرفهای برای مدیریت جدول زمانی ساختوساز شما ارائه میدهد. فعالیتها بسازید، مدتها را تنظیم کنید، وابستگیها را تعریف کنید و سیستم بهطور خودکار مسیر بحرانی را محاسبه میکند و نشان میدهد کدام فعالیتها نباید تأخیر بخورند.
مدل هزینه، داده BOQ شما را به جدول زمانی پروژه متصل میکند و یک نمای زمانبندیشده از هزینههای ساختوساز به همراه معیارهای مدیریت ارزش کسبشده به شما میدهد.
کل روال کاری تدارکات را از ساخت بستههای مناقصه تا مقایسه پیشنهادها و واگذاری قرارداد به پیمانکاران جزء مدیریت کنید.
به تدارکات بروید، یک پروژه انتخاب کنید و روی «ساخت بسته» کلیک کنید. نام بسته، توضیح دامنه کار، مهلت ارسال را مشخص کنید و انتخاب کنید کدام موقعیتهای BOQ شامل شوند. میتوانید چند بسته بهازای هر پروژه بسازید (مثلاً کارهای سازهای، MEP، تکمیلکاری).
پیشنهادهایی از پیمانکاران جزء با نام شرکت، جزئیات تماس و قیمتهای پیشنهادی برای هر موقعیت BOQ اضافه کنید. سیستم چند پیشنهاد بهازای هر بسته را برای مقایسه کنار هم پشتیبانی میکند.
آینه قیمت همه پیشنهادها را در یک جدول مقایسه با نرخ واحد و مجموعها بهازای هر موقعیت نشان میدهد. نشانگرهای بصری پایینترین و بالاترین پیشنهادها را برجسته میکنند. مقایسه را بهعنوان CSV برای بازبینی ذینفعان خروجی بگیرید.
پیشنهاد برنده را با دکمه واگذاری علامت بزنید و یادداشتهای توجیهی اضافه کنید. وضعیت بسته این مراحل را طی میکند: پیشنویس، صادرشده، در حال جمعآوری، در حال ارزیابی، واگذارشده، بستهشده.
با استفاده از ماتریس احتمال-تأثیر، ریسکهای پروژه را شناسایی، ارزیابی و مدیریت کنید. مواجهه ریسک را کمّی کنید و استراتژیهای کاهش را برای هر ریسک شناساییشده برنامهریزی کنید.
ماتریس همه ریسکها را روی یک شبکه احتمال (0.1 تا 0.9) در برابر تأثیر (کم/متوسط/زیاد/بحرانی) با کدگذاری رنگی نمایش میدهد. هر ریسک نمره مواجهه محاسبهشده خود را نشان میدهد (احتمال ضربدر هزینه تأثیر).
برای هر ریسک، مستند کنید: کد یکتا (R-001)، عنوان، دسته (فنی، مالی، زمانبندی، مقرراتی، محیطزیستی، ایمنی)، استراتژی کاهش، طرح احتیاطی، مالک ریسک، تأثیر هزینه و تأثیر زمانبندی به روز. وضعیت را از این مراحل پیگیری کنید: شناساییشده، ارزیابیشده، در حال کاهش، بستهشده یا رخداده.
تغییرات دامنه کار و تأثیرشان بر هزینه و زمانبندی پروژه را پیگیری کنید. دستورهای تغییر یک مسیر ممیزی از همه اصلاحات اعمالشده پس از برآورد اولیه ارائه میدهند.
یک دستور تغییر با کد (CO-001)، عنوان و دسته دلیل (درخواست مشتری، تغییر طراحی، شرایط پیشبینینشده، مقرراتی) بسازید. خطوطی که موقعیتهای BOQ متأثر را با مقادیر/نرخهای اصلی و جدید مشخص میکنند اضافه کنید. سیستم دلتای هزینه را بهطور خودکار محاسبه میکند. وضعیت این مراحل را طی میکند: پیشنویس، ارسالشده، در حال بازبینی، تأییدشده/ردشده.

بررسیهای کیفیت خودکار را روی BOQهای خود اجرا کنید تا خطاها را پیش از اینکه به مشکل تبدیل شوند، شناسایی کنید. موتور اعتبارسنجی 42 قانون قابلپیکربندی را روی داده برآورد شما اعمال میکند.
هر اعتبارسنجی یک نمره کیفیت (0 تا 100%) با یافتههای کدگذاریشده رنگی تولید میکند: خطاها (قرمز، باید رفع شود)، هشدارها (زرد، باید بررسی شود)، اطلاعات (آبی، پیشنهادها). روی هر یافته کلیک کنید تا مستقیم به موقعیت متأثر BOQ بروید.



برای ذینفعان، مشتریان و انطباق مقرراتی، اسناد حرفهای از داده پروژهتان تولید کنید.

همه اسناد پروژه را متمرکز کنید. نقشهها، قراردادها، مشخصات فنی و عکسها را با دستهبندی و جستجوی خودکار آپلود کنید.


عملکرد بودجه بینپروژهای را ببینید. داشبورد داده مالی همه پروژهها را تجمیع میکند تا روندها، انحرافات و بودجههای در معرض خطر را شناسایی کند.
همه ذینفعان پروژه را در یک فهرست متمرکز مدیریت کنید. مشتریان، پیمانکاران جزء، تأمینکنندگان، معماران و مشاوران را با جزئیات کامل تماس، پیوندهای شرکتی و دستهبندی بر اساس نقش پیگیری کنید. مخاطبان را به پروژهها، مناقصات، سفارشهای خرید و مکاتبات وصل کنید تا قابلیت ردیابی کامل داشته باشید.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/contacts/ | فهرست همه مخاطبان |
| POST | /api/v1/contacts/ | ساخت مخاطب |
| GET | /api/v1/contacts/{id} | دریافت جزئیات مخاطب |
| PUT | /api/v1/contacts/{id} | بهروزرسانی مخاطب |
| POST | /api/v1/contacts/import | درونریزی دستهای مخاطبان |
با یک طبقهبندی 5 نوعی وظیفه و تخته کانبان بصری، کار پروژه را سازماندهی کنید. وظایف را میتوان به اعضای تیم اختصاص داد، به موقعیتهای خاص BOQ، اسناد یا RFI وصل کرد و از مراحل روال کاری قابلسفارشیسازی پیگیری کرد. هر نوع وظیفه کدگذاری رنگی و فیلدهای پیشفرض خودش را دارد.

| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/tasks/ | فهرست وظایف (قابل فیلتر بر اساس پروژه، مسئول، وضعیت) |
| POST | /api/v1/tasks/ | ساخت وظیفه |
| PATCH | /api/v1/tasks/{id} | بهروزرسانی وظیفه (وضعیت، مسئول، اولویت) |
| GET | /api/v1/tasks/board/{project_id} | دریافت داده تخته کانبان |
درخواستهای رسمی اطلاعات میان طرفین پروژه را با تخصیص مسئولیت پیگیری کنید. RFIها از یک چرخه عمر ساختاریافته از پیشنویس تا بستهشدن عبور میکنند و تضمین میکنند هر سؤال یک پاسخ مستندشده دریافت کند. ردیابی مسئولیت نشان میدهد در هر لحظه چه کسی مالک اقدام است.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/rfis/ | فهرست RFIها |
| POST | /api/v1/rfis/ | ساخت RFI |
| POST | /api/v1/rfis/{id}/respond | ارسال پاسخ |
| PATCH | /api/v1/rfis/{id}/status | بهروزرسانی وضعیت / مسئولیت |
مدیریت کامل مالی پروژه شامل فاکتورها، بودجهها، پرداختها و مدیریت ارزش کسبشده (EVM). هزینههای برنامهریزیشده در برابر واقعی را پیگیری کنید، درخواستهای پرداخت بسازید و سلامت بودجه را با تحلیل انحراف بلادرنگ پایش کنید. با داده BOQ برای تولید خودکار خط پایه هزینه یکپارچه میشود.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/finance/invoices/ | فهرست فاکتورها |
| POST | /api/v1/finance/invoices/ | ساخت فاکتور |
| GET | /api/v1/finance/budgets/ | فهرست بودجهها |
| POST | /api/v1/finance/budgets/import | درونریزی بودجه از Excel |
| GET | /api/v1/finance/evm/{project_id} | دریافت معیارهای EVM |
| GET | /api/v1/finance/payments/ | فهرست پرداختها |
سفارشهای خرید و رسیدهای کالا را برای مصالح و خدمات ساختوساز مدیریت کنید. سفارشهای خرید متصل به موقعیتهای BOQ بسازید، وضعیت تحویل را پیگیری کنید و رسیدهای کالا را با تأیید مقدار ثبت کنید. با ماژول مخاطبان برای مدیریت تأمینکنندگان یکپارچه میشود.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/procurement/orders/ | فهرست سفارشهای خرید |
| POST | /api/v1/procurement/orders/ | ساخت سفارش خرید |
| POST | /api/v1/procurement/orders/{id}/receive | ثبت رسید کالا |
| GET | /api/v1/procurement/receipts/ | فهرست رسیدهای کالا |
با یک سیستم امتیازدهی ریسک، حوادث ایمنی، خطرات نزدیکبهوقوع و مشاهدات رفتاری را ثبت کنید. معیارهای عملکرد ایمنی را در سراسر پروژهها پیگیری کنید، روندها را شناسایی کنید و از انطباق با مقررات ایمنی و بهداشت شغلی اطمینان حاصل کنید.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/safety/incidents/ | فهرست حوادث |
| POST | /api/v1/safety/incidents/ | گزارش حادثه |
| GET | /api/v1/safety/observations/ | فهرست مشاهدات |
| POST | /api/v1/safety/observations/ | ثبت مشاهده |
| GET | /api/v1/safety/dashboard/{project_id} | دریافت KPIهای ایمنی |
صورتجلسات را با دستورکارهای ساختاریافته و اقدامات پیگیریشده مدیریت کنید. سریهای جلسه تکرارشونده بسازید (مثلاً جلسات هفتگی سایت)، حاضران را ثبت کنید، نکات بحث را بنویسید و بهطور خودکار اقداماتی بسازید که با ماژول وظایف یکپارچه میشوند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/meetings/ | فهرست جلسات |
| POST | /api/v1/meetings/ | ساخت جلسه |
| GET | /api/v1/meetings/{id}/minutes | دریافت صورتجلسه |
| POST | /api/v1/meetings/{id}/actions | افزودن اقدام |
با استفاده از چکلیستهای قابلپیکربندی، بازرسیهای کیفیت انجام دهید. قالبهای بازرسی را بهازای هر رشتهکار یا نوع فعالیت تعریف کنید، آنها را در محل پر کنید، عکس ضمیمه کنید و رفع نواقص را پیگیری کنید. نتایج بازرسی به نمره کیفیت پروژه و روال کاری NCR وارد میشوند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/inspections/ | فهرست بازرسیها |
| POST | /api/v1/inspections/ | ساخت بازرسی از قالب |
| GET | /api/v1/inspections/templates/ | فهرست قالبهای چکلیست |
| PATCH | /api/v1/inspections/{id}/items | بهروزرسانی نتایج اقلام چکلیست |
وقتی کار با مشخصات فنی مطابقت ندارد، عدم انطباقهای کیفیت را مستند و پیگیری کنید. NCRها یک چرخه عمر رسمی از شناسایی، از طریق تحلیل ریشهای، تا تأیید اقدام اصلاحی را طی میکنند و تضمین میکنند همه انحرافات کیفیت بهدرستی حل و مستند شوند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/ncr/ | فهرست NCRها |
| POST | /api/v1/ncr/ | ساخت NCR |
| PATCH | /api/v1/ncr/{id}/status | بهروزرسانی وضعیت NCR |
| POST | /api/v1/ncr/{id}/actions | افزودن اقدام اصلاحی |
فرایند بازبینی مدارک برای مصالح ساختمانی، نقشههای کارگاهی و داده محصول را مدیریت کنید. روالهای کاری بازبینی چندمرحلهای را پیگیری کنید که در آن مدارک پیش از تأیید نهایی از چند بازبین عبور میکنند. یک مسیر ممیزی کامل از همه چرخههای بازبینی و تاریخچه بازنگری نگهدارید.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/submittals/ | فهرست مدارک برای تأیید |
| POST | /api/v1/submittals/ | ساخت مدرک برای تأیید |
| POST | /api/v1/submittals/{id}/review | ارسال تصمیم بازبینی |
| POST | /api/v1/submittals/{id}/revise | آپلود بازنگری جدید |
یک ثبت رسمی ارتباطات برای همه مکاتبات پروژه نگهدارید. نامهها، ایمیلها، اطلاعیهها و دستورالعملها میان طرفین پروژه را با شمارههای مرجع یکتا، پیگیری پاسخ و جستجوی متن کامل پیگیری کنید. اطمینان میدهد ارتباطات قراردادی بهدرستی مستند و قابلردیابیاند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/correspondence/ | فهرست مکاتبات |
| POST | /api/v1/correspondence/ | ساخت رکورد مکاتبه |
| GET | /api/v1/correspondence/{id} | دریافت جزئیات با پیوستها |
| GET | /api/v1/correspondence/{id}/thread | دریافت زنجیره مکاتبات مرتبط |
یک محیط داده مشترک همراستا با روالهای کاری ISO 19650 برای مدیریت اطلاعات پروژه با گذارهای وضعیت کنترلشده. اسناد از وضعیتهای در حال کار (WIP)، اشتراکی، منتشرشده و بایگانیشده با دروازههای تأیید عبور میکنند. تضمین میدهد مدیریت اطلاعات از استانداردهای BIM برای تحویل مشارکتی پیروی میکند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/cde/documents/ | فهرست اسناد CDE (قابل فیلتر بر اساس وضعیت، مناسبت) |
| POST | /api/v1/cde/documents/ | آپلود سند به CDE |
| PATCH | /api/v1/cde/documents/{id}/status | تغییر وضعیت سند |
| GET | /api/v1/cde/documents/{id}/history | دریافت تاریخچه بازنگری |
اسناد را بهطور رسمی با پیگیری تحویل و تأیید دریافت به طرفین بیرونی توزیع کنید. بستههای نامه ارسال با چند سند بسازید، گیرندگان را مشخص کنید و پیگیری کنید که آیا هر گیرنده اسناد را دریافت و تأیید کرده است. یک رکورد قراردادی از تبادل اطلاعات ارائه میدهد.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/transmittals/ | فهرست نامههای ارسال |
| POST | /api/v1/transmittals/ | ساخت نامه ارسال |
| POST | /api/v1/transmittals/{id}/send | ارسال نامه به گیرندگان |
| PATCH | /api/v1/transmittals/{id}/acknowledge | ثبت تأیید دریافت گیرنده |
مرکز اصلی مدیریت مدلهای BIM با دسترسی داده در سطح عنصر و اتصال مستقیم BOQ. مدلهای IFC/RVT را آپلود کنید، عناصر ساختمان را با ویژگیها و مقادیرشان مرور کنید و عناصر را برای یکپارچگی هزینه 5D به موقعیتهای BOQ وصل کنید. پلی میان داده طراحی و برآورد هزینه فراهم میکند.
🎬 نمایش پیوند دستهای BIM را در یوتیوب ببینید - 100 دیوار BIM → یک خط BOQ با مساحت، حجم و طول تجمیعی.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/bim/models/ | فهرست مدلهای BIM |
| POST | /api/v1/bim/models/ | آپلود مدل BIM |
| GET | /api/v1/bim/models/{id}/elements | فهرست عناصر مدل |
| POST | /api/v1/bim/elements/{id}/link-boq | اتصال عنصر به موقعیت BOQ |
موتور گزارشدهی جامع با داشبورد KPI، قالبهای گزارش قابلسفارشیسازی و تولید گزارش زمانبندیشده. داده را در سراسر پروژهها برای بینش سطح پورتفولیو تجمیع کنید. قالبهای گزارش سفارشی بسازید که داده هر ماژول (BOQ، مالی، برنامه زمانی، ایمنی، کیفیت) را ترکیب کند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/reporting/kpi/{project_id} | دریافت KPIهای پروژه |
| GET | /api/v1/reporting/templates/ | فهرست قالبهای گزارش |
| POST | /api/v1/reporting/generate | تولید گزارش از قالب |
| GET | /api/v1/reporting/portfolio/ | دریافت داده داشبورد پورتفولیو |
سیستم اعلان درونبرنامهای که کاربران را از رویدادهای مرتبط با آنها آگاه نگه میدارد. اعلانها با اقدامات در سراسر همه ماژولها تحریک میشوند - تخصیص وظیفه، پاسخهای RFI، بازبینی مدارک، درخواستهای تأیید، اقلام معوق و بیشتر. کاربران ترجیحات اعلان خود را بهازای هر دسته کنترل میکنند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/notifications/ | فهرست اعلانها (اول خواندهنشدهها) |
| PATCH | /api/v1/notifications/{id}/read | علامتگذاری اعلان بهعنوان خواندهشده |
| POST | /api/v1/notifications/read-all | علامتگذاری همه بهعنوان خواندهشده |
| GET | /api/v1/notifications/preferences | دریافت ترجیحات اعلان |
نمودار گانت مبتنی بر SVG خالص برای تجسم برنامه زمانی ساختوساز. جدولهای زمانی، وابستگیها، نقاط عطف و مسیر بحرانی را مستقیم در مرورگر بدون کتابخانههای خارجی رندر میکند. از بزرگنمایی از سطح روز تا سطح سال پشتیبانی میکند و برای گزارشدهی به PDF/PNG خروجی میگیرد.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/schedule/gantt/{project_id} | دریافت داده نمودار گانت (فعالیتها، وابستگیها) |
| PATCH | /api/v1/schedule/activities/{id} | بهروزرسانی تاریخها/پیشرفت فعالیت |
| POST | /api/v1/schedule/dependencies/ | ساخت وابستگی |
منطقه زمانی، ارز، فرمت اعداد و ترجیحات فرمت تاریخ را بهازای هر کاربر و هر پروژه پیکربندی کنید. تنظیمات منطقهای از پیشفرضهای سیستم به بازنویسیهای سطح پروژه و سپس به ترجیحات سطح کاربر آبشاری میشوند و تضمین میکنند هر عضو تیم داده را در فرمت زبان محلی خودش ببیند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/settings/regional/ | دریافت تنظیمات منطقهای فعلی |
| PUT | /api/v1/settings/regional/ | بهروزرسانی تنظیمات منطقهای |
| GET | /api/v1/settings/regional/timezones | فهرست منطقههای زمانی موجود |
| GET | /api/v1/settings/regional/currencies | فهرست ارزهای پشتیبانیشده |
ماژولهای پلتفرم را فعال یا غیرفعال کنید تا OpenConstructionERP را برای روال کاری خودتان سفارشی کنید. هر ماژول را میتوان مستقل بدون تأثیر بر ماژولهای دیگر تغییر داد. ماژولهای غیرفعال از رابط کاربری پنهان میشوند، نقاط انتهایی API آنها 404 برمیگردانند و جدولهای پایگاهدادهشان برای فعالسازی مجدد دستنخورده باقی میمانند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/modules/ | فهرست همه ماژولها با وضعیت |
| PATCH | /api/v1/modules/{name}/toggle | فعال یا غیرفعال کردن یک ماژول |
| GET | /api/v1/modules/{name}/dependencies | بررسی وابستگیهای ماژول |
بستههای منطقهای از پیش پیکربندیشده که استانداردهای طبقهبندی، قوانین مالیاتی، پیشفرضهای پایگاهداده هزینه، قالبهای گزارش و قوانین انطباق مقرراتی را برای بازارهای خاص تنظیم میکنند. یک بسته منطقهای نصب کنید تا فوراً پلتفرم را برای کشور یا منطقه خود پیکربندی کنید.
| بسته | منطقه | استانداردها | ارز |
|---|---|---|---|
| US | ایالات متحده | MasterFormat, UniFormat, CSI | USD |
| DACH | آلمان، اتریش، سوئیس | DIN 276, GAEB, VOB, HOAI | EUR/CHF |
| UK | بریتانیا | NRM 1/2, RICS, JCT | GBP |
| Russia | روسیه، مشترکالمنافع | GESN, FER, TER, SNIP | RUB |
| خاورمیانه | امارات، عربستان سعودی، قطر | RICS, CESMM, FIDIC | AED/SAR/QAR |
| Asia-Pacific | چین، ژاپن، استرالیا | GB/T, AS 4000, JASS | CNY/AUD/JPY |
| India | هند | CPWD, IS standards, DSR | INR |
| LatAm | برزیل، مکزیک، کلمبیا | SINAPI, CMIC, local norms | BRL/MXN/COP |
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| GET | /api/v1/regional-packs/ | فهرست بستههای منطقهای موجود |
| POST | /api/v1/regional-packs/{name}/install | نصب بسته منطقهای |
| GET | /api/v1/regional-packs/{name}/details | دریافت محتوا و پیکربندی بسته |
قابلیتهای جامع درونریزی و برونریزی داده در سراسر همه ماژولها. مخاطبان، بودجهها، BOQها و پایگاههای هزینه را از فایلهای Excel و CSV با نگاشت هوشمند ستون درونریزی کنید. داده پروژه را با قالبهای قابلسفارشیسازی به Excel، PDF و CSV برونریزی کنید. همه خروجیها قالببندی را حفظ میکنند و سرصفحههای فراداده دارند.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| POST | /api/v1/import/contacts | درونریزی مخاطبان از فایل |
| POST | /api/v1/import/budget | درونریزی بودجه از Excel |
| POST | /api/v1/export/boq/{id} | خروجی BOQ (فرمت: excel، pdf، gaeb، csv) |
| POST | /api/v1/export/report | تولید و خروجی گزارش |



| متغیر | پیشفرض | توضیح |
|---|---|---|
DATABASE_URL | (تنظیمنشده = PostgreSQL توکار) | پایگاه داده (بهطور پیشفرض PostgreSQL توکار؛ برای PostgreSQL خارجی مقداردهی کنید). برای استفاده از PostgreSQL توکار آن را تنظیمنشده بگذارید، یا یک پایگاه داده خارجی تعیین کنید، مثلاً postgresql+asyncpg://oe:oe@localhost:5432/openestimate. |
JWT_SECRET | dev-key | راز JWT (در محیط تولید تغییر دهید!) |
SEED_DEMO | true | ساخت حسابهای نمایشی |
VECTOR_BACKEND | lancedb | بکاند جستجوی برداری |
OpenConstructionERP یک REST API جامع ارائه میدهد که فرانتاند را تغذیه میکند و میتوان از آن برای یکپارچهسازی، اتوماسیون و گردشکارهای سفارشی استفاده کرد. هر عملی که در رابط کاربری در دسترس است - ساخت پروژه، ویرایش BOQ، اجرای برآوردهای هوش مصنوعی، جستوجوی هزینه - بهصورت یک اندپوینت API نیز در دسترس است. مستندات تعاملی Swagger با دکمههای «امتحان کنید» هنگام اجرای بکاند در /api/docs در دسترس است.
| روش | نقطه انتهایی | توضیح |
|---|---|---|
| POST | /api/v1/users/auth/login | ورود |
| GET | /api/v1/projects/ | فهرست پروژهها |
| GET | /api/v1/boq/boqs/?project_id=... | فهرست BOQها |
| GET | /api/v1/costs/?q=concrete | جستجوی هزینهها |
| POST | /api/v1/ai/quick-estimate | برآورد AI |
| POST | /api/v1/takeoff/cad-extract | استخراج از CAD |
| GET | /api/health | بررسی سلامت |
| ماژول | پیشوند | توضیح |
|---|---|---|
| Contacts | /api/v1/contacts/ | CRUD فهرست مخاطبان، درونریزی |
| Tasks | /api/v1/tasks/ | مدیریت وظیفه، تخته کانبان |
| RFI | /api/v1/rfis/ | درخواستهای اطلاعات |
| Finance | /api/v1/finance/ | فاکتورها، بودجهها، پرداختها، EVM |
| Procurement | /api/v1/procurement/ | سفارشهای خرید، رسیدهای کالا |
| Safety | /api/v1/safety/ | حوادث، مشاهدات، امتیازدهی ریسک |
| Meetings | /api/v1/meetings/ | صورتجلسات، دستورکار، اقدامات |
| Inspections | /api/v1/inspections/ | بازرسیهای کیفیت، چکلیستها |
| NCR | /api/v1/ncr/ | گزارشهای عدم انطباق |
| Submittals | /api/v1/submittals/ | بازبینی چندمرحلهای مدارک |
| Correspondence | /api/v1/correspondence/ | ثبت ارتباطات |
| CDE | /api/v1/cde/ | محیط اسناد ISO 19650 |
| Transmittals | /api/v1/transmittals/ | توزیع اسناد |
| BIM Hub | /api/v1/bim/ | مدلهای BIM، عناصر، اتصال به BOQ |
| Reporting | /api/v1/reporting/ | داشبورد KPI، قالبهای گزارش |
| Notifications | /api/v1/notifications/ | سیستم اعلان درونبرنامهای |
| Comments | /api/v1/comments/ | نظرات رشتهای روی هر موجودیت |
| Gantt | /api/v1/schedule/gantt/ | تجسم برنامه زمانی SVG |
| Regional | /api/v1/settings/regional/ | منطقه زمانی، ارز، ترجیحات فرمت |
| Modules | /api/v1/modules/ | فعال/غیرفعال کردن ماژولها |
| Regional Packs | /api/v1/regional-packs/ | نصب پیکربندیهای منطقهای |
| Import/Export | /api/v1/import/ / /api/v1/export/ | درونریزی و برونریزی دستهای داده |
برای مستندات دقیق نقاط انتهایی با پارامترها و توضیحات، بخش هر ماژول را در بالا ببینید.
تحلیل پروژه با قدرت هوش مصنوعی که پروژه شما را در 9 حوزه وزندار امتیازدهی میکند و یک امتیاز کاملبودن از 0 تا 100 (نمرات A تا F) تولید میکند.
API: GET /api/v1/project_intelligence/score/?project_id=X - امتیاز کلی، امتیازهای هر حوزه، شکافهای بحرانی و دستاوردها را برمیگرداند.
اعضای تیم، نقشها و کنترل دسترسی بهازای هر ماژول را مدیریت کنید.
مدیران میتوانند نمایانبودن ماژول و سطوح دسترسی (هیچ، مشاهده، ویرایش، کامل) را به ازای هر کاربر از طریق صفحه /users پیکربندی کنند. میتوان نامهای نقش سفارشی تخصیص داد (مثلاً «مهندس کارگاه»، «مدیر هزینه»).
به مخزن ستاره بدهید تا به دیگران در کشف پروژه کمک کنید.
برای مرور نسخههای جدید و آموزشها مشترک شوید. با مرور 12 دقیقهای محصول شروع کنید.
در گیتهاب یک issue باز کنید.
برای پرسیدن سؤال، به جامعه تلگرام بپیوندید.
برای استقرار و آموزش با ما تماس بگیرید.
مجوز: AGPL-3.0. صدور مجوز تجاری: info@datadrivenconstruction.io
نظرات
سیستم نظرات رشتهای که میتواند به هر موجودیت در پلتفرم متصل شود - موقعیتهای BOQ، وظایف، RFIها، مدارک، اسناد، بازرسیها و بیشتر. از @اشارهها برای آگاهسازی اعضای تیم، پیوست فایل و پیگیری حلوفصل برای بحثهای عملگرا پشتیبانی میکند.
قابلیتهای کلیدی
نقاط انتهایی API
/api/v1/comments/?entity_type=task&entity_id=.../api/v1/comments//api/v1/comments/{id}/reply/api/v1/comments/{id}/resolve