GAJANAND GIS
सम्पूर्ण उपयोग एवं संचालन मार्गदर्शिका
Installation से लेकर User Management, Shapefile, Grouping, Map Purchase, TARMIM, Print/PDF, DGPS, Work Allotment, Reports और Software Update तक।
तैयार दिनांक: 23-08-2026 • Manual Version: 1.0
ऊपर के Print/PDF buttons browser print system का उपयोग करते हैं। PDF के लिए Destination में “Save as PDF” चुनें।
1. 🧭 परियोजना क्या करती है?
यह एक role-based GIS + भूमि नक्शा + ग्राहक खरीद + संशोधन (TARMIM) + DGPS field-work + company work-management system है।
2. 🔄 A–Z पूरा कार्य प्रवाह
3. 🏗️ नई Website पर Installation
तकनीकी पेज: install/index.php
- नया खाली MySQL Database बनाएँHosting panel में नया database और database user बनाएँ। Database में पहले से कोई application table नहीं होनी चाहिए; installer सुरक्षा के लिए non-empty database पर रुकता है।
- V3.1 ZIP Upload और Extract करेंCompany की नई website/folder में production ZIP extract करें। Folder structure न बदलें। पुराने server की
.env, logs, backups या installed.lock copy न करें। - Installer खोलेंBrowser में
https://DOMAIN/PATH/install/खोलें। Application URL में application केpublicfolder तक का URL दें। - Database व Company details भरेंDB Host, Port, Database Name, Username, Password; Main Branch Name; Director Name, Email और कम-से-कम 10 अक्षर का password भरें। Images/Documents/GEO storage paths भी निर्धारित करें।
- Install चलाएँInstaller current
core_schema.sql + fresh_baseline.phpसे database तैयार करता है, Main Branch और DIRECTOR account बनाता है तथा production.envतैयार करता है। - Install के बादDIRECTOR login test करें, फिर
/installfolder को delete/rename करें। Razorpay को पहले Test Mode में और WhatsApp/SMTP/Google credentials company के अपने account से configure करें।
/install folder delete/rename करें। पुराने server का .env नई company पर copy न करें।.../public
4. 🔐 Login, Roles और Company Hierarchy
Login के बाद system role के अनुसार अलग dashboard खोलता है। Main Director एक शीर्ष administrative role है; बाकी users hierarchy में create/assign होते हैं।
| Role | मुख्य उपयोग |
|---|---|
| DIRECTOR | सर्वोच्च settings, users, branches, fees, integrations, reports, software update। |
| GENERAL_MANAGER | Assigned hierarchy के managers/staff/users का management और monitoring। |
| MANAGER | Manager Type के अनुसार Data Preparation, Work, Marketing या अन्य operational work। |
| BRANCH_ADMIN | Branch purchase, users, DGPS booking review/assignment, reports और branch operations। |
| COMPANY_STAFF | Office Team या Field Team; assigned work, DGPS, upload/data preparation आदि। |
| ACCOUNTANT | Financial/account-oriented access जहाँ configure हो। |
| CUSTOMER / BRANCH_USER | Allowed customer/branch workflows और purchased/assigned data access। |
5. ⚙️ First-Time Master Settings
Data upload या sale शुरू करने से पहले masters को सही क्रम में तैयार करें।
6. 👥 Users कैसे Add / Recruit करें
मुख्य पेज: public/DESBOARD/GAJANAND/SETTING/users.php Recruitment Profile: public/DESBOARD/GAJANAND/SETTING/user_hr_profile.php
- Dashboard → USER SETTING खोलेंDIRECTOR/अधिकृत hierarchy role से User Setting खोलें और Recruit / Create Company User पर जाएँ।
- Personal DetailsName, Email, Password, Mobile, Address, Father/Guardian Name, DOB, Gender भरें।
- Role Based FormRole चुनें: GENERAL_MANAGER, MANAGER, BRANCH_ADMIN, COMPANY_STAFF, ACCOUNTANT, CUSTOMER या BRANCH_USER। Manager होने पर Manager Type; staff होने पर Office Team/Field Team चुनें।
- Company AssignmentReports To, Assigned Manager, Assigned Branch Admin, Branch, Department, Designation, Employment Type और Joining Date सही चुनें।
- Verification और DocumentsEmail/WhatsApp OTP verification करें। Profile Photo तथा recruitment/HR documents upload किए जा सकते हैं।
- Approval / Login StatusApproval status और Login Enable/Disable अलग controls हैं। Documents verify/reject और final approval के बाद user को आवश्यक permission दें। Role बदलना सामान्य Edit में नहीं किया जाता।
7. 🗺️ Shapefile कैसे Upload करें
मुख्य पेज: public/DESBOARD/GAJANAND/UPLOAD_MAP/UPLOAD_MANAGER.php
- Master Village पहले तैयार रखेंDistrict Type → District → Tehsil → Village तथा Map Type master सही होना चाहिए।
- UPLOAD MAP खोलेंLocation filters में District List Type, District, Tehsil, Village और Map Type चुनें।
- Shapefile ImportShapefile Import दबाएँ और ZIP चुनें। ZIP में सामान्यतः
.shp + .shx + .dbf + .prjहोने चाहिए। केवल Polygon/MultiPolygon data import होता है। - Projection/Zone चुनेंAuto (.prj/WGS84) सर्वोत्तम है; जरूरत पर UTM 42N EPSG:32642 या UTM 43N EPSG:32643 चुनें।
- Check Columns & ImportKHASRA required column है। Optional fields को DBF columns से map करें। गलत auto-mapping हो तो KHASRA column manually बदलें। KID_STATUS blank होने पर system default OK रख सकता है।
- Import के बाद जाँचMap और list में polygons, Khasra labels, KID status/remarks जाँचें। गलत polygon को Edit/Delete करें या Shape Editor से geometry सुधारें।
SettingsJSON ImportShapefile ImportShape EditorBulk Remove
8. ✏️ Shape Editor क्या करता है?
पेज: public/DESBOARD/GAJANAND/UPLOAD_MAP/SHAPE_EDITOR.php
Shape Editor advanced GIS workspace है जहाँ Polygon, Polyline और Point layers पर काम किया जा सकता है। Project create/load/save/transfer, Shapefile import/export, layer rename/delete, reports, duplicate Khasra checking, geometry correction और editing tools उपलब्ध हैं।
9. 🧩 Khasra Grouping कैसे करें
पेज: public/DESBOARD/GAJANAND/GROUPING/grouping.php
- GROUPING खोलेंDistrict List Type, District, Tehsil, Village चुनकर Apply & Load करें।
- Khasra चुनेंMain List या Map से required Khasra rows/polygons select करें। पहले से किसी group में शामिल plots locked/अलग highlight हो सकते हैं।
- Normal या Khata WiseNormal mode में direct selection करें। Khata Wise mode में KHASRA/KHATA CSV से grouping सहायता ली जा सकती है।
- Map पर verifySelected polygons का shape, KID Status, remarks और labels देख लें। जरूरत पर Hole Auto/Map Settings उपयोग करें।
- Group Name / RemarkGroup Name auto Khasra list से बन सकता है; setting के अनुसार edit किया जा सकता है। Khasra-wise remark existing plot remark से आता है।
- Save GroupSave करने पर group Saved Groups tab में आता है। वहाँ search/filter, Auto Group, note update और authorized bulk delete उपलब्ध हैं।
Save GroupClear
branch_id mandatory नहीं किया गया और branch filter जानबूझकर लागू नहीं किया गया है।10. 🖼️ GEO / JGW Image Upload
पेज: public/DESBOARD/GAJANAND/IMAGE_UPLOAD/all_geo_image.php
Georeferenced imagery को image + world/JGW reference के साथ manage किया जाता है। Status filter, area select, fit/clear, single/bulk upload, image/boundary display, EPSG/status search, pagination और authorized delete/bulk delete उपलब्ध हैं। ये images Super Imposed/Purchase Map workflows में overlay के रूप में उपयोग हो सकती हैं।
11. 💳 Map Purchase कैसे करें
पेज: public/DESBOARD/GAJANAND/PURCHASE_MAP/NEW_PURCHASE_MAP.php
- NEW MAP / PURCHASE MAP खोलेंAuthorized Branch Admin/Staff/Customer flow से नया map purchase page खोलें।
- Location चुनेंDistrict List Type, District, Tehsil और Village चुनें।
- Group खोजेंKhasra (Group) search popup से EXACT/CONTAINS search कर सही saved group चुनें और map preview verify करें।
- Party DetailsParty Name, Mobile, optional Party GST No और Notes भरें। GSTIN दिया जाए तो validation लागू होती है। अलग mobile होने पर WhatsApp OTP verification मांगी जा सकती है।
- Fee / PromoWork Type और branch/district-type fee settings से राशि निकलती है। Promo Code हो तो Apply करें और final payable amount देखें।
- Purchase Map / PaymentPurchase Map दबाएँ। Razorpay/allowed payment flow पूरा करें। Payment capture के बाद system entry save करता है और Purchase ID/Entry ID बनाता है। Payment capture हो जाए लेकिन save pending दिखे तो दोबारा payment न करें; recovery/recheck flow उपयोग करें।
Apply PromoPurchase Map / Pay
12. 🧾 Entry Dashboard — खरीद के बाद क्या मिलता है?
पेज: public/DESBOARD/GAJANAND/GAJANAND_GIS/entry_dashboard.php
Purchase के बाद Entry Dashboard पर Entry ID, Group ID, Purchase ID, Khasra, Branch/User और payment history दिखाई जाती है। Workspace cards से आगे के काम खोले जाते हैं।
13. 🧭 Purchased Map Viewer
पेज: public/DESBOARD/GAJANAND/GAJANAND_GIS/PURCHASE_MAP_VIEW.php
यह मुख्य cadastral map workspace है। इसमें MOOL/TARMIM layers, selection, distance/center text, map styles, geo imagery, coordinate/report और advanced geometry tools एक जगह मिलते हैं।
14. ✂️ TARMIM कैसे करें
- Purchased Map खोलेंEntry Dashboard → REVENUE MAP/Open Map से Purchase Map Viewer खोलें।
- MOOL / TARMIM खोलेंToolbar में MOOL / TARMIM button दबाएँ। MOOL base layer है; नई editing history के लिए TARMIM layer बनती है।
- नई TARMIM Layer+ / New Layer → Layer Name और Layer Color भरें। नई layer current MOOL polygons व visual settings की copy से शुरू होती है।
- Paymentभुगतान करके लेयर बनाएँ करें। TARMIM fee tier/cycle Work Type setting से आती है; Promo हो तो apply करें। Payment/valid zero-pay flow के बाद layer बनती है।
- Layer Active करेंजिस TARMIM पर काम करना है उसे active करें। Right Click से Rename, Copy/Duplicate, Settings और layer order controls उपलब्ध हैं।
- Geometry EditingActive layer पर Split, Merge, Shared Edge, Vertex/Geometry Select, Validator आदि tools से बदलाव करें। Feature editor में Part/Khasra, Party Name, Label, Color/Opacity जैसी जानकारी edit हो सकती है।
- Transaction SaveGeometry बदलने पर नीचे UNDO / SAVE / CANCEL bar आता है। Final check के बाद SAVE करें। Editing cycle समय समाप्त होने पर Split और TARMIM Settings lock हो सकते हैं, जबकि अन्य allowed actions उपलब्ध रह सकते हैं।
15. 🖨️ Map का Print / PDF कैसे निकालें
- Map तैयार करेंMOOL या desired TARMIM layer active रखें, labels/distance/geo image/settings final करें।
- Style चुनेंToolbar से STYLE1, STYLE2 या current/custom appearance चुनें। STYLE1 सामान्य white-map/distance style और STYLE2 GEO-image oriented preset के लिए है।
- Print PreviewPrinter icon / Print Preview Style खोलें। उपलब्ध role/settings के अनुसार A1/A2/A3/A4, Landscape/Portrait, fit/scale आदि चुनें।
- OutputPreview से Print, role-enabled PDF या SVG output लें। Coordinate/report areas में Map & List Print, PDF, CSV तथा relevant DXF export भी उपलब्ध हो सकते हैं।
- अंतिम जाँचPrint/PDF से पहले Purchase ID, Khasra, layer name, scale, distance, center text, logo और page orientation जाँचें।
16. 🛰️ DGPS — Booking से Field Completion तक
मुख्य pages: public/DESBOARD/GAJANAND/DGPS/DGPS_BOOKING/dgps_booking.php public/DESBOARD/GAJANAND/DGPS/DGPS_BOOKING/dgps_booking_list.php public/DESBOARD/GAJANAND/DGPS/DGPS_BOOKING/dgps_booking_my_list.php
- DGPS Fee पहले configure करेंDIRECTOR → WORK TYPE में DGPS Map Coordinate और Ground Coordinate की total fee/advance तथा संबंधित rates सेट करें।
- नई BookingDGPS BOOKING में Mode चुनें: MAP COORDINATE (Purchase ID आधारित) या GROUND COORDINATE (मौका/स्थान आधारित)।
- Booking FormName, Mobile, Date, Revenue Staff YES/NO, Time Slot, GPS Survey Type, Address/Notes भरें। Map mode में Purchase ID Load करने पर location/group details आ सकती हैं।
- Advance PaymentSAVE BOOKING & PAY ADVANCE करें। Advance required होने पर payment से पहले Branch Admin assignment/PROGRESS gate खुलता नहीं है।
- Branch Admin ReviewBooking List → View/Update. Final Date, enabled DGPS Field Staff और Status तय करें। PROGRESS के लिए आवश्यक advance और staff assignment चाहिए।
- Field Staff WorkAssigned staff → MY DGPS LIST. Ground visit, survey layer/GPS accuracy point तथा expense information complete करें।
- Completion GateFIELD COMPLETED के लिए full balance payment, applicable GPS Accuracy point (map/group booking में purchase center के 2000m भीतर कम-से-कम 1), कम-से-कम 1 Survey Layer और visit/travel expense record जैसी conditions लागू हो सकती हैं।
- Result / TransferGround points CSV/Shapefile/manual entry से save किए जा सकते हैं। जरूरत पर DGPS file layer को Purchase ID से TARMIM layer में transfer किया जा सकता है।
वास्तविक Project Screens
17. 📌 DGPS Ground Points / Saved Point Workspace
पेज: public/DESBOARD/GAJANAND/DGPS/DGPS_SAVE_POINT/GROUND_DGPS_POINT_UPLOAD.php
Ground coordinate data CSV, Shapefile ZIP/GeoJSON conversion या manual point entry से save किया जा सकता है। District Type, District, Tehsil, Village, file name/location के साथ dataset manage होता है। Manual Point में Point Type, Easting, Northing, Zone और Remark दिए जाते हैं।
18. 📋 Work Allotment + Staff Tracking
पेज: public/DESBOARD/GAJANAND/SETTING/staff_village_permission.php
Hierarchy के अनुसार office staff को Village Work assign किया जाता है। Village Work List से location चुनें → Assign Work → Staff/Note दें। Active Assignments tab वर्तमान काम दिखाता है और History tab हटाए/complete किए गए काम का record बनाए रखता है।
19. 📊 Reports, Mail, Jamabandi और अन्य Modules
20. ⬆️ भविष्य में Software Update कैसे करें
पेज: public/DESBOARD/GAJANAND/SETTING/software_update.php
- DIRECTOR → SOFTWARE UPDATEFresh installer दोबारा न चलाएँ। Existing company installation पर Software Update page उपयोग करें।
- Update ZIP चुनेंVersioned ZIP चुनकर पहले CHECK UPDATE करें। ZIP root में
update.jsonहोना चाहिए और private/runtime files नहीं होनी चाहिए। - Preflight देखेंFrom/Target version, compatibility, files/delete list, DB migration और SHA-256 जैसी information verify करें।
- DB Backupअगर update में migration है तो successful DB backup mandatory है। Backup fail होने पर production build update block करता है।
- Confirmationनिर्देशानुसार
INSTALLtype कर INSTALL UPDATE करें। Update के बीच browser बंद/refresh न करें। - Post UpdateVersion और critical modules test करें। Rollback केवल supported/latest non-DB-migration update पर उपलब्ध हो सकता है; DB migration वाले updates के लिए backup recovery plan रखें।
/install/ दोबारा न चलाएँ। Update ZIP में .env, runtime uploads, logs, cache, installed.lock या company data शामिल न करें।21. 🛡️ Backup, Security और Production नियम
- DIRECTOR और privileged accounts के मजबूत, अलग passwords रखें।
- Developer Login production में default OFF रखें; जरूरत होने पर controlled maintenance process अपनाएँ।
- Razorpay/WhatsApp/SMTP/Google credentials company-specific रखें और source ZIP में secrets न डालें।
- DB migration वाला update बिना successful DB backup न करें।
.env, storage uploads और database backup को company source delivery ZIP से अलग रखें।- Role/Branch/User permissions बदलने के बाद test user से वास्तविक access verify करें।
- Payment capture हो जाए पर entry save pending हो तो customer से दोबारा payment न कराएँ; recovery/recheck करें।
- Bulk delete, geometry edit, TARMIM split/merge और schema maintenance से पहले backup/verification करें।
22. 🎤 Company को Software Demo किस क्रम में दें?
1. Login करके DIRECTOR Dashboard और role-based structure दिखाएँ।
2. Branch → District Type → Village → Map Type → Work Type/Fee settings दिखाएँ।
3. एक sample User create flow और hierarchy/approval समझाएँ।
4. एक sample Shapefile ZIP import करके KHASRA mapping और map verification दिखाएँ।
5. 2–4 Khasra select करके Grouping save करें।
6. उसी group का New Map Purchase करें (demo/test payment environment में)।
7. Entry Dashboard से Revenue Map खोलकर MOOL → नई TARMIM → Split/Merge → Save समझाएँ।
8. Print Preview से A4/A3 style और PDF output दिखाएँ।
9. DGPS Booking → Advance → Branch Admin Staff Assignment → Field Staff → Ground Point → Completion flow समझाएँ।
10. Work Allotment, History, Reports, Mail और अंत में Software Update का CHECK/Backup/Install process दिखाएँ।
23. 🧑💻 प्रमुख PHP Pages — कौनसी file क्या करती है?
यह company/user manual है; API/helper files user सीधे नहीं खोलता। नीचे मुख्य user-facing pages दिए हैं।
| कार्य | मुख्य Page |
|---|---|
| Fresh Installation | install/index.php |
| Users / Recruitment | public/DESBOARD/GAJANAND/SETTING/users.php / public/DESBOARD/GAJANAND/SETTING/user_hr_profile.php |
| Branches | public/DESBOARD/GAJANAND/SETTING/branches.php |
| Master Village | public/DESBOARD/GAJANAND/SETTING/VILLAGE_LIST.php |
| Work Type / Fees | public/DESBOARD/GAJANAND/SETTING/WORK_TYPE.php |
| Shapefile / Upload Map | public/DESBOARD/GAJANAND/UPLOAD_MAP/UPLOAD_MANAGER.php |
| Shape Editor | public/DESBOARD/GAJANAND/UPLOAD_MAP/SHAPE_EDITOR.php |
| Grouping | public/DESBOARD/GAJANAND/GROUPING/grouping.php |
| Geo Image | public/DESBOARD/GAJANAND/IMAGE_UPLOAD/all_geo_image.php |
| New Map Purchase | public/DESBOARD/GAJANAND/PURCHASE_MAP/NEW_PURCHASE_MAP.php |
| Entry Dashboard | public/DESBOARD/GAJANAND/GAJANAND_GIS/entry_dashboard.php |
| Purchased Map Viewer | public/DESBOARD/GAJANAND/GAJANAND_GIS/PURCHASE_MAP_VIEW.php |
| Super Imposed Map | public/DESBOARD/GAJANAND/GAJANAND_GIS/SUPPER_IMPOSED_MAP.php |
| DGPS Booking | public/DESBOARD/GAJANAND/DGPS/DGPS_BOOKING/dgps_booking.php |
| DGPS Booking List | public/DESBOARD/GAJANAND/DGPS/DGPS_BOOKING/dgps_booking_list.php |
| Field Staff DGPS List | public/DESBOARD/GAJANAND/DGPS/DGPS_BOOKING/dgps_booking_my_list.php |
| Ground DGPS Points | public/DESBOARD/GAJANAND/DGPS/DGPS_SAVE_POINT/GROUND_DGPS_POINT_UPLOAD.php |
| DGPS → TARMIM Transfer | public/DESBOARD/GAJANAND/DGPS/DGPS_SAVE_POINT/DGPS_FILE_LAYERS_TRANSFER_TO_TARMIM.php |
| Village Work Allotment | public/DESBOARD/GAJANAND/SETTING/staff_village_permission.php |
| Internal Mail/Inquiry | public/DESBOARD/mail_box/mail.php |
| Software Update | public/DESBOARD/GAJANAND/SETTING/software_update.php |
24. 🧯 Common Problems — पहले क्या जाँचें?
| समस्या | पहली जाँच |
|---|---|
| User को button/module नहीं दिख रहा | Role, team type, hierarchy, branch assignment और relevant permission/settings जाँचें। |
| Shapefile गलत जगह आ रही | .prj/CRS, EPSG 32642/32643, source coordinate system और KHASRA mapping जाँचें। |
| Group में plot select नहीं हो रहा | Plot पहले से Saved Group में locked तो नहीं; filters/KID status/location check करें। |
| Purchase payment हो गई लेकिन entry नहीं दिखी | दूसरा payment न कराएँ; recovery/recheck/payment receipt/transaction ID से verify करें। |
| TARMIM layer नहीं बन रही | WORK TYPE में TARMIM fee/cycle config, payment/promo और user permission check करें। |
| DGPS PROGRESS नहीं हो रहा | Advance payment, enabled Field Staff assignment, final date/status gate check करें। |
| FIELD COMPLETED नहीं हो रहा | Full balance, GPS accuracy point, Survey Layer और expense record requirements देखें। |
| Print/PDF गलत | Active layer, STYLE preset, page size/orientation/scale, labels/distance/logo settings check करें। |
| Software Update रुक गया | update.json compatibility, current version, ZIP structure, checksum और DB backup status check करें। |