arc/guide/persons_guide.html

<!doctype html>
<html lang="fa" dir="rtl">
<head>
  <meta charset="utf-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <title>راهنمای جامع بخش اشخاص (لیست، افزودن، ویرایش)</title>
  <style>
    :root{color-scheme:light dark}
    body{font-family:Tahoma, "Vazirmatn", "IRANSans", Arial, sans-serif; line-height:1.9; margin:0; padding:24px; max-width:980px; }
    h1,h2,h3{line-height:1.4}
    h1{margin:0 0 16px}
    h2{margin:28px 0 10px; padding-top:10px; border-top:1px solid rgba(127,127,127,.25)}
    h3{margin:16px 0 8px}
    .card{border:1px solid rgba(127,127,127,.25); border-radius:12px; padding:16px 18px; margin:14px 0}
    .note{background:rgba(127,127,127,.10)}
    .quick{background:rgba(46,125,50,.10)}
    .warn{background:rgba(245,124,0,.12)}
    ul{margin:8px 0 8px 0; padding:0 22px 0 0}
    li{margin:6px 0}
    .kbd{display:inline-block; padding:0 8px; border:1px solid rgba(127,127,127,.35); border-bottom-width:2px; border-radius:8px; background:rgba(127,127,127,.08)}
    table{width:100%; border-collapse:collapse; margin:10px 0}
    th,td{border:1px solid rgba(127,127,127,.25); padding:10px 10px; vertical-align:top}
    th{background:rgba(127,127,127,.10); text-align:right}
  </style>
</head>
<body>
  <h1>راهنمای جامع «اشخاص» (لیست، افزودن، ویرایش)</h1>

  <div class="card note">
    <p>
      «اشخاص» یکی از مهم‌ترین بخش‌های حسابداری/فروش است؛ چون تقریباً همه‌ی عملیات‌ها (فاکتور، دریافت/پرداخت، گزارش‌ها و کارت حساب) به یک شخص وصل می‌شوند.
      در این سیستم «شخص» می‌تواند همزمان چند نقش داشته باشد (مثلاً <strong>مشتری</strong> + <strong>تامین‌کننده</strong> + <strong>فروشنده</strong>).
    </p>
  </div>

  <h2>1) این راهنما برای چه کسانی است؟</h2>
  <div class="card note">
    <p>
      این راهنما مخصوص افراد تازه‌وارد است و هدفش فقط این است که <strong>بتوانید با خیال راحت با بخش اشخاص کار کنید</strong>:
      لیست را ببینید، شخص جدید اضافه کنید، اطلاعات را ویرایش کنید، و اگر خطایی دیدید بدانید معمولاً چه باید کرد.
    </p>
  </div>

  <h2>2) کاربرد بخش اشخاص در نرم‌افزار</h2>
  <h3>کارهایی که معمولاً با «اشخاص» انجام می‌دهید</h3>
  <ul>
    <li><strong>تعریف و نگهداری لیست مشتری/تامین‌کننده/کارمند/بازاریاب/…</strong> برای استفاده در اسناد و گزارش‌ها</li>
    <li><strong>مشاهده تراز و وضعیت مالی</strong> هر شخص (بستانکار/بدهکار/بالانس/بدون تراکنش)</li>
    <li><strong>رفتن به کاردکس</strong> (کارت حساب/تراکنش‌ها) از طریق لیست یا جزئیات شخص</li>
    <li><strong>گروه‌بندی با «نوع شخص»</strong> برای گزارش‌گیری و فیلترهای سریع</li>
    <li><strong>ثبت حساب‌های بانکی</strong> جهت استفاده در پرداخت‌ها، قراردادها یا اطلاعات مرجع</li>
    <li><strong>تنظیم پورسانت</strong> برای نقش‌های «بازاریاب/فروشنده»</li>
    <li><strong>تنظیم سقف اعتبار و سیاست کنترل اعتبار</strong> برای کنترل ریسک فروش</li>
  </ul>

  <h2>3) اگر بعضی دکمه‌ها را نمی‌بینم چه؟</h2>
  <div class="card note">
    <p>
      اگر برخی دکمه‌ها مثل «افزودن»، «حذف گروهی» یا حتی کل صفحه را نمی‌بینید، علت معمولاً این است که <strong>سطح دسترسی شما</strong> برای این بخش فعال نیست.
      در این حالت باید از مدیر سیستم/پشتیبانی بخواهید دسترسی «اشخاص» را برایتان فعال کند.
    </p>
  </div>
  <ul>
    <li><strong>مشاهده لیست اشخاص</strong>: اگر اجازه نداشته باشید، پیام «شما دسترسی لازم برای مشاهده لیست اشخاص را ندارید» نمایش داده می‌شود.</li>
    <li><strong>افزودن شخص</strong>: دکمه <span class="kbd">+</span> فقط با اجازه افزودن نمایش/فعال می‌شود.</li>
    <li><strong>حذف تکی/گروهی</strong>: دکمه‌های حذف فقط برای کاربرانی که اجازه حذف دارند نمایش داده می‌شود.</li>
  </ul>

  <h2>4) صفحه «لیست اشخاص» — صفر تا صد استفاده</h2>
  <h3>4-1) امکانات اصلی جدول</h3>
  <ul>
    <li><strong>جستجو</strong>: روی چند فیلد مثل کد، نام مستعار، نام/نام خانوادگی، نام شرکت، موبایل، ایمیل و…</li>
    <li><strong>فیلتر</strong>: مخصوصاً روی «نوع شخص»، کشور، استان و همچنین وضعیت/تراز</li>
    <li><strong>مرتب‌سازی</strong>: روی ستون‌ها (از جمله «کد»، «نام مستعار»، «تراز»، «وضعیت»)</li>
    <li><strong>انتخاب چند سطر</strong>: برای عملیات‌هایی مثل حذف گروهی یا خروجی گرفتن از سطرهای انتخاب‌شده</li>
    <li><strong>خروجی اکسل / پی‌دی‌اف</strong>: خروجی گرفتن با رعایت فیلترها و ترتیب ستون‌ها</li>
  </ul>

  <h3>4-2) ستون‌های مهم و معنای آن‌ها</h3>
  <table>
    <thead>
      <tr>
        <th>ستون</th>
        <th>معنی/کاربرد</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><strong>کد</strong></td>
        <td>شناسه عددی یکتا برای هر شخص در همان کسب‌وکار. برای ارجاع سریع، مرتب‌سازی و گزارش‌ها کاربرد دارد.</td>
      </tr>
      <tr>
        <td><strong>نام مستعار</strong></td>
        <td>فیلد اصلیِ نمایشی شخص (الزامی). بهتر است کوتاه، یکتا در ذهن کاربر و قابل جستجو باشد.</td>
      </tr>
      <tr>
        <td><strong>نوع شخص</strong></td>
        <td>چندانتخابی: شخص می‌تواند همزمان چند نقش داشته باشد (مثلاً مشتری و تامین‌کننده).</td>
      </tr>
      <tr>
        <td><strong>تراز</strong></td>
        <td>
          تراز مالی شخص (به صورت کلی <strong>بستانکار - بدهکار</strong>).
          رنگ‌بندی معمولاً: سبز (مثبت)، قرمز (منفی)، خاکستری (صفر).
        </td>
      </tr>
      <tr>
        <td><strong>وضعیت</strong></td>
        <td>
          بر اساس تراز: <strong>بستانکار</strong> / <strong>بدهکار</strong> / <strong>بالانس</strong> / <strong>بدون تراکنش</strong>.
          این ستون هم قابل فیلتر است.
        </td>
      </tr>
    </tbody>
  </table>

  <div class="card warn">
    <h3>نکته مهم درباره «تراز» و «سال مالی»</h3>
    <p>
      تراز/وضعیت بر اساس <strong>سال مالی جاری</strong> محاسبه می‌شود.
      اگر سال مالی را عوض کنید، طبیعی است که ترازهای نمایش داده‌شده هم تغییر کند.
    </p>
  </div>

  <h3>4-3) میانبرهای کاربردی داخل لیست</h3>
  <ul>
    <li><strong>رفتن به کاردکس از روی کد</strong>: روی شماره «کد» کلیک کنید؛ مستقیم به گزارش کاردکس همان شخص می‌روید.</li>
    <li><strong>مشاهده جزئیات</strong>: با کلیک روی خود ردیف، پنجره جزئیات شخص باز می‌شود (اطلاعات شخص + کارت حساب + فایل‌ها + اشتراک‌گذاری و…)</li>
    <li><strong>ویرایش</strong>: از ستون عملیات، گزینه ویرایش را بزنید.</li>
    <li><strong>حذف تکی</strong>: از ستون عملیات، گزینه حذف را بزنید و تأیید کنید.</li>
    <li><strong>حذف گروهی</strong>: چند ردیف را انتخاب کنید و آیکون «حذف گروهی» را بزنید.</li>
    <li><strong>ورود از فایل اکسل</strong>: آیکون «آپلود» برای وارد کردن لیست اشخاص از فایل اکسل استفاده می‌شود.</li>
  </ul>

  <div class="card note">
    <h3>اگر مرتب‌سازی/فیلتر روی «تراز» کند شد</h3>
    <p>
      وقتی مرتب‌سازی یا فیلتر روی «تراز» یا «وضعیت» فعال باشد، سیستم برای دقتِ نتیجه ممکن است تراز همه اشخاص را محاسبه کند و بعد صفحه‌بندی انجام دهد؛
      این طبیعی است که کمی زمان‌برتر از مرتب‌سازی روی «کد» یا «نام» باشد.
    </p>
  </div>

  <h2>5) افزودن شخص</h2>
  <h3>5-1) از کجا شروع کنم؟</h3>
  <ul>
    <li>در لیست اشخاص روی دکمه <span class="kbd">+</span> بزنید.</li>
    <li>فرم «افزودن شخص» باز می‌شود و چند تب دارد.</li>
  </ul>

  <h3>5-2) تب‌های فرم و اینکه هر کدام چه می‌کند</h3>
  <ul>
    <li><strong>اطلاعات پایه</strong>: کد، نام مستعار (اجباری)، نوع(ها)ی شخص (اجباری)، نام/نام خانوادگی، نام شرکت، شناسه پرداخت، سهام (در صورت سهامدار بودن)</li>
    <li><strong>اطلاعات ثبتی/اقتصادی</strong>: کد/شناسه ملی، شماره ثبت، شناسه اقتصادی</li>
    <li><strong>اطلاعات تماس</strong>: کشور/استان/شهر، آدرس، کدپستی، تلفن، موبایل، فکس، ایمیل، وب‌سایت</li>
    <li><strong>اطلاعات بانکی</strong>: اضافه/حذف حساب بانکی و ثبت بانک/شماره حساب/کارت/شبا</li>
    <li><strong>اعتبار</strong>: سقف اعتبار و سیاست کنترل اعتبار (فعال/غیرفعال/تبعیت از تنظیمات کسب‌وکار)</li>
    <li><strong>پورسانت</strong>: فقط وقتی نمایش داده می‌شود که نوع شخص «بازاریاب» یا «فروشنده» انتخاب شده باشد.</li>
  </ul>

  <h3>5-3) فیلدهای اجباری و قوانین مهم</h3>
  <ul>
    <li><strong>نام مستعار</strong>: اجباری است. اگر خالی باشد فرم ذخیره نمی‌شود.</li>
    <li><strong>نوع شخص</strong>: حداقل یک نوع باید انتخاب شود؛ در غیر این صورت پیام خطا نمایش داده می‌شود.</li>
    <li><strong>کد شخص</strong>:
      <ul>
        <li>می‌توانید روی حالت <strong>اتوماتیک</strong> بگذارید تا سیستم خودش کد بعدی را بسازد.</li>
        <li>در حالت <strong>دستی</strong>، کد باید عددی باشد و <strong>در همان کسب‌وکار یکتا</strong> باشد؛ در غیر این صورت «کد تکراری است» می‌گیرید.</li>
      </ul>
    </li>
    <li><strong>سهامدار</strong>: اگر نوع «سهامدار» را انتخاب کنید، <strong>تعداد سهام</strong> اجباری و باید عدد صحیح بزرگتر از صفر باشد.</li>
    <li><strong>پورسانت</strong>: اگر «بازاریاب/فروشنده» باشد، تب پورسانت فعال می‌شود؛ درصدها باید بین ۰ تا ۱۰۰ باشند و مبالغ باید عدد مثبت باشند.</li>
  </ul>

  <div class="card note">
    <h3>نکته تایپی: اعداد را به شکل 0 تا 9 وارد کنید</h3>
    <p>
      برای جلوگیری از خطاهای عددی (کد، سهام، درصد)، بهتر است اعداد را به شکل 0 تا 9 وارد کنید.
    </p>
  </div>

  <h3>5-4) ذخیره</h3>
  <ul>
    <li>بعد از تکمیل، دکمه <strong>افزودن</strong> را بزنید.</li>
    <li>اگر عملیات موفق باشد، پیام موفقیت نمایش داده می‌شود و جدول لیست به‌روزرسانی می‌شود.</li>
  </ul>

  <h2>6) ویرایش شخص</h2>
  <p>
    برای ویرایش، از ستون «عملیات» روی <strong>ویرایش</strong> بزنید.
    فرم همان فرم افزودن است، با این تفاوت که مقادیر قبلی از قبل پر شده‌اند.
  </p>
  <h3>نکته‌های مهم در ویرایش</h3>
  <ul>
    <li><strong>تغییر کد</strong>: اگر کد را دستی تغییر دهید، باید یکتا باشد؛ در غیر این صورت با خطای «کد تکراری» مواجه می‌شوید.</li>
    <li><strong>اضافه کردن نوع «سهامدار»</strong>: اگر در ویرایش، نوع سهامدار را اضافه کنید، حتماً تعداد سهام را هم وارد کنید.</li>
    <li><strong>حذف نوع «بازاریاب/فروشنده»</strong>: اگر این نوع‌ها را بردارید، سیستم عملاً پورسانت را برای این شخص بی‌اثر می‌کند (تب پورسانت هم دیگر نمایش داده نمی‌شود).</li>
    <li><strong>اعتبار</strong>: می‌توانید سیاست کنترل اعتبار را روی «تبعیت از تنظیمات کسب‌وکار» بگذارید یا به صورت اختصاصی فعال/غیرفعال کنید و سقف اعتبار بدهید.</li>
  </ul>

  <h2>7) خطاهای احتمالی و روش حل</h2>
  <div class="card">
    <h3>خطاهای رایج هنگام افزودن/ویرایش</h3>
    <ul>
      <li><strong>نوع شخص انتخاب نشده</strong>: حداقل یک نوع انتخاب کنید (مثلاً «مشتری»).</li>
      <li><strong>کد تکراری است</strong>: یک کد دیگر انتخاب کنید یا حالت کد را روی «اتوماتیک» بگذارید.</li>
      <li><strong>سهامدار بدون تعداد سهام</strong>: اگر «سهامدار» را زده‌اید، تعداد سهام را وارد کنید (عدد صحیح &gt; 0).</li>
      <li><strong>درصد پورسانت نامعتبر</strong>: مقدار باید بین ۰ تا ۱۰۰ باشد.</li>
      <li><strong>عدد واردشده نامعتبر است</strong>: عدد را فقط با رقم‌های 0 تا 9 وارد کنید و از نوشتن حروف/علائم اضافی پرهیز کنید.</li>
    </ul>
  </div>

  <div class="card">
    <h3>خطاهای رایج هنگام حذف</h3>
    <ul>
      <li><strong>عدم امکان حذف به علت اسناد مرتبط</strong>: اگر این شخص در اسناد قطعی (مثل فاکتور، دریافت/پرداخت، سند دستی و…) استفاده شده باشد، حذف نمی‌شود. راه‌حل: ابتدا اسناد مرتبط را بررسی/اصلاح کنید یا به جای حذف، از روش‌های آرشیو/غیرفعال‌سازی (در صورت وجود در نسخه شما) استفاده کنید.</li>
      <li><strong>عدم دسترسی حذف</strong>: اگر دکمه حذف را نمی‌بینید یا خطای دسترسی می‌گیرید، باید سطح دسترسی شما برای ماژول «اشخاص» اصلاح شود.</li>
    </ul>
  </div>

  <div class="card note">
    <h3>اگر خطا «خطا: …» خیلی کلی بود</h3>
    <p>
      بعضی خطاها به خاطر اینترنت/اتصال یا سطح دسترسی رخ می‌دهند و پیام دقیق به شما نشان داده نمی‌شود.
      در این حالت معمولاً این موارد را چک کنید: اتصال اینترنت، خروج و ورود دوباره، و فعال بودن دسترسی شما برای بخش اشخاص.
    </p>
  </div>

  <h2>8) چند نکته برای اینکه کارتان راحت‌تر شود</h2>
  <ul>
    <li><strong>یک استاندارد نام‌گذاری</strong> برای «نام مستعار» تعریف کنید (مثلاً «نام + نام خانوادگی» برای افراد و «نام شرکت» برای سازمان‌ها).</li>
    <li><strong>کدها را منظم انتخاب کنید</strong> (به‌خصوص اگر از فایل اکسل وارد می‌کنید).</li>
    <li><strong>نوع شخص را دقیق انتخاب کنید</strong> تا گزارش‌ها (مشتریان/تامین‌کنندگان/بازاریاب‌ها) درست دربیاید.</li>
    <li><strong>برای بازاریاب/فروشنده</strong> فقط در صورت نیاز پورسانت را تنظیم کنید و درصدها را منطقی نگه دارید.</li>
    <li><strong>سقف اعتبار</strong> را برای مشتریان ریسکی فعال کنید تا از فروش‌های پرریسک جلوگیری شود.</li>
    <li><strong>قبل از حذف</strong> همیشه کارت حساب را بررسی کنید؛ اگر سند قطعی دارید، حذف ممکن نیست.</li>
  </ul>

  <div class="card quick">
    <h2 style="border:none; padding-top:0; margin-top:0;">جمع‌بندی خیلی سریع</h2>
    <ul>
      <li><strong>برای ساخت شخص جدید</strong> → نام مستعار + حداقل یک نوع شخص را حتماً وارد کنید.</li>
      <li><strong>برای سهامدار</strong> → تعداد سهام اجباری است.</li>
      <li><strong>برای کاردکس</strong> → روی «کد» کلیک کنید یا ردیف را باز کنید و تب کارت حساب را ببینید.</li>
      <li><strong>برای حذف</strong> → اگر سند قطعی مرتبط وجود داشته باشد حذف انجام نمی‌شود.</li>
    </ul>
  </div>
</body>
</html>