مفاهیم سیستم
نمای کلی
سیستم کاما یک پلتفرم مدیریت سازمانی (ERP) است که برای مدیریت پروژهها، مشتریان، وظایف، تیکتها، صورتحسابها و سایر فرآیندهای کسبوکار طراحی شده است.
موجودیتهای اصلی
User (کاربر)
کاربران سیستم به دو دسته اصلی تقسیم میشوند:
- staff: کارمندان/مدیران سیستم
- client: مشتریانی که به سیستم دسترسی دارند
Client (مشتری)
مشتریان سازمانها یا افرادی هستند که با کسبوکار شما در ارتباط هستند. هر مشتری میتواند چندین مخاطب (contact) داشته باشد.
Project (پروژه)
پروژهها برای سازماندهی کارها در قالب یک ساختار مشخص استفاده میشوند. هر پروژه به یک مشتری وابسته است.
Task (وظیفه)
وظایف، آیتمهای کاری قابل انتساب به کاربران هستند. میتوانند مستقل یا در قالب یک پروژه تعریف شوند.
Ticket (تیکت)
تیکتها برای پیگیری درخواستهای پشتیبانی استفاده میشوند. هر تیکت میتواند به یک پروژه یا مشتری متصل باشد.
Invoice (صورتحساب)
صورتحسابها برای صدور فاکتور برای مشتریان استفاده میشوند. شامل آیتمها، مالیات، تخفیف و وضعیتهای پرداخت هستند.
Estimate (پیشفاکتور)
پیشفاکتورها قبل از صدور صورتحساب نهایی برای تأیید مشتری ارسال میشوند.
Contract (قرارداد)
قراردادها اسناد حقوقی بین سازمان و مشتری هستند که میتوانند الگو داشته باشند.
Announcement (اعلان)
اعلانها برای اطلاعرسانی به کاربران سیستم استفاده میشوند.
Attendance (حضور و غیاب)
مدیریت زمان ورود و خروج کاربران، ثبت ساعت کاری و گزارشهای مرتبط.
ساختار API
تمامی endpointهای API تحت پیشوند /api قرار دارند. APIها به دو دسته تقسیم میشوند:
- عمومی (Public): نیاز به احراز هویت ندارند (مانند لاگین، ثبتنام)
- خصوصی (Authenticated): نیاز به توکن احراز هویت دارند