Jasnath Hostel Girls & Boys PG - V45 COMPLETE USER MANUAL V45 IMPORTANT UPDATE - HAR PAGE PAR HINDI HELP ---------------------------------------------- 1. Website ke har operational page par bottom-right “? हिन्दी मदद” button hai. 2. Button current page/section ke hisab se contextual Hindi instructions dikhata hai. 3. /help/ par searchable Complete Hindi Manual available hai. 4. Android App ke top headers par “?” Help button hai; Payment, Admission, Student, Bed, Device aur Ludo screens par context-specific Hindi guide milti hai. 5. V44 ke A/C Number global search/display aur branch-wise manual Bed Number features retained hain. ================================================= 1. SYSTEM STRUCTURE ------------------- Public Website, Common Admin, Staff Panel, Student Portal, Attendance Kiosk, MySQL Database और Local Device Agent एक integrated system हैं. Royal Ludo website में नहीं है; इसे Android App-only रखा जाएगा. 2. PUBLIC WEBSITE ----------------- Public website पर hostel information, Boys/Girls vacant seats, facilities, gallery, admission/contact details दिखाई देते हैं. Admin Settings से heading, phone, email, address, text और public images edit की जा सकती हैं. Public page पर Active Student list नहीं दिखाई जाती. 3. MASTER STUDENT DATABASE -------------------------- Boys Hostel, Girls Hostel और Bus students एक Master Student Database use करते हैं. एक student Hostel + Bus दोनों services ले सकता है. Search: A/C No., Name, Bed No./renamed Bed. 4. NEW ADMISSION ---------------- Student Student Portal के New Admission Form से अपनी details स्वयं भरता है. Hostel student Branch और currently vacant Bed Number चुनता है. Save पर internal Student Code बनता है. Student Portal login Registered Student Mobile + Password से होता है. पहली बार student Create Password से अपना password खुद बनाता है. Admin/authorised Staff details verify/edit करके admission approve/reject करता है. 5. BRANCH & BED SYSTEM ---------------------- Admin Main Office / Branch 1 / Branch 2 आदि Hostel Branches add/edit/delete कर सकता है. हर Branch में Boys/Girls bed quantity अलग रखी जा सकती है. हर Bed को individually rename किया जा सकता है. Same Branch + same Bed दो active students को allot नहीं हो सकता. 6. LIBRARY ---------- Admin Library Branches add/delete कर सकता है. Allocation = Library Branch + Seat + Shift. Same Library Branch + Seat + Shift duplicate allot नहीं हो सकता. 7. BUS ------ Admin Bus 1 / Bus 2 / Bus 3 आदि Bus Units add/delete कर सकता है. Bus service, route, pickup/drop और independent Bus fee Master Student ID से linked रहती है. 8. BILLING ---------- Billing Center में Due Payment, Over Due और Max Over Due अलग categories/pages हैं. इन categories के pending-month thresholds Admin Settings में editable हैं. Payment Reminder Scheduler केवल Billing/Payment system से नियंत्रित होता है. Payment clear होने पर reminder call नहीं जानी चाहिए. Slot 1 permanently: PAYMENT REMINDER ONLY. No Answer / Not Reachable पर configured next-day retry हो सकता है. Repeated no-connect threshold cross होने पर number Number Check List में pause होता है. 9. ATTENDANCE KIOSK ------------------- URL: /attendance-kiosk हर Kiosk किसी Hostel Branch से assigned होता है. Types: Morning Attendance, Night Attendance, OUT, IN. OUT पर reason जरूरी है. Student Portal में attendance + movement history दिखाई देती है. Scanner न होने पर Student ID fallback उपलब्ध है. 10. FINGERPRINT DEVICE ---------------------- Fingerprint SDK hosting website में install नहीं होगा. Hostel PC पर JASNATH Device Agent + scanner का official Windows Driver/SDK/adapter चलेगा. Raw fingerprint image website/MySQL में भेजने की जरूरत नहीं है. Local scanner adapter match के बाद केवल Student Code website को भेजता है. Scanner बदलने पर केवल adapter/SDK बदलना होगा; website/student database वही रहेगा. 11. CALLING CENTER / GVT ------------------------ Calling Center Admin + selected Staff permissions से चलता है. Features: Direct Call, Auto Dialer, Voice Broadcast Slot 0-9, DTMF, Incoming Routing, reports, schedules. Website direct COM9 access नहीं करती. Hostel Windows PC पर JASNATH Device Agent GVT USB/COM hardware control करता है. V45 में हर Calling/Fingerprint Agent को Admin Device Manager के one-time pairing code से unique AGENT_ID + private AGENT_TOKEN मिलता है. 12. AUTO DIALER --------------- Authorised/consented list import करें. Invalid/duplicate numbers filter होते हैं. Manual-talk mode में prerecorded audio नहीं बजता. Call FREE होने और configured delay (default 3 seconds) के बाद next number process होता है. 13. IVR / VOICE BROADCAST ------------------------- Audio Slot 0-9 manage हो सकते हैं. Slot 1 Payment Reminder reserved है. Generic IVR campaigns में Slot 0 या 2-9 select करें. GVT audio upload/IVR call actual hardware पर Local Device Agent करता है. 14. INCOMING ROUTING -------------------- Routing Numbers 1-9, Default Routing और related settings Calling Center से queue होती हैं. Device Agent hardware में settings लिखता है. Confirmed hardware behaviour के अनुसार saved routing GVT.exe बंद होने पर भी hardware में चल सकती है. 15. STAFF & PERMISSIONS ----------------------- Admin Staff ID create करता है और selected modules/actions permissions देता है. Staff को केवल assigned Branch/data और granted actions दिखाई देने चाहिए. 16. STUDENT PORTAL ------------------ Student Profile, Fees/Receipts, Attendance/OUT-IN, Notices, Complaints, Mess, Study Tools और Leave/Resignation देख/submit कर सकता है. Royal Ludo website से हटाया गया है और Android App version में रखा जाएगा. 17. LEAVE / RESIGNATION ----------------------- Student Leave Hostel, Leave Bus या Full Resignation request भेज सकता है. Admin/authorised Staff verify/reject/schedule करता है. Effective date पर relevant Bed/Library/Bus allocation release होता है; historical payment/attendance/request data सुरक्षित रहता है. 18. MYSQL --------- Operational data MySQL ONLY है. Setup: npm install -> .env -> npm run mysql:setup -> npm run mysql:status -> node server.js. 19. PERFORMANCE V45 ------------------ Royal Ludo/Socket.IO website से हटाया गया. GVT/Fingerprint hardware code अलग Device Agent में गया. Static HTML/CSS/JS gzip + ETag caching enabled है. Public images Admin upload के समय browser-side WebP resize/compress होती हैं. No packaged Test Student SQL snapshot. 20. LOCAL DEVICE AGENT ---------------------- GVT PC पर Admin Settings में उपलब्ध current JASNATH GVT Agent ZIP और हर Fingerprint Branch PC पर Admin Settings में उपलब्ध current JASNATH Fingerprint Agent ZIP download/extract करें. PAIR_AGENT.bat चलाएँ; live SERVER_URL और Admin से मिला 15-minute pairing code enter करें. AGENT_ID/AGENT_TOKEN config.env में automatic save होंगे. GVT driver installed रखें; Direct Agent calls के समय original GVT.exe बंद रखें. START_DEVICE_AGENT.bat चलाएँ. Fingerprint scanner आने तक FINGERPRINT_ENABLED=0 रखें. ============================================================ V45 - BRANCH-WISE SECURE DEVICE AGENT PAIRING ============================================================ 1. Common Admin -> Admin Settings -> Branches & Attendance -> Open Device Agent Manager. 2. Fingerprint ke liye pehle Branch Manager me us branch ka Attendance Kiosk create karein. 3. Device Agent Manager me Agent Type select karein: - Fingerprint Agent: Branch + Kiosk mandatory. - GVT Calling Agent: Main Office/Calling PC ke liye. 4. Generate Pairing Code par click karein. Code 15 minute ke liye valid hai. 5. Us PC पर downloaded GVT/Fingerprint Agent folder में PAIR_AGENT.bat चलाएं. 6. Live HTTPS Website URL aur pairing code enter karein. 7. Successful pairing par unique AGENT_ID + private AGENT_TOKEN config.env me automatic save hoga. 8. Calling Agent: START_DEVICE_AGENT.bat. 9. Fingerprint Agent: START_DEVICE_AGENT.bat heartbeat ke liye; scanner SDK adapter ready hone par START_FINGERPRINT_AGENT.bat bhi. 10. Admin Device Manager me Online/Offline, PC, Branch, Kiosk, health aur Last Seen dikhega. 11. Re-pair karne par naya token issue hota hai aur purane PC ka token invalid ho jata hai. 12. Revoke & Delete karne par us Agent ka access turant band ho jata hai. SECURITY: - Har Agent ka token alag hota hai; sab branches me ek common secret share nahi hota. - Fingerprint Agent server side par fixed Branch + Kiosk se bind hota hai. Request se branch badli nahi ja sakti. - GVT Calling Agent ko fingerprint API access nahi milta; Fingerprint Agent ko GVT job access nahi milta. - AGENT_TOKEN ko WhatsApp/chat/public file me share na karein. 21. V45 AGENT DOWNLOAD / UPDATE MANAGER -------------------------------------- Admin > Settings > Branches & Attendance > Open Device Agent + Downloads खोलें. यहाँ दो current download files रहती हैं: 1. Central GVT Calling Agent ZIP 2. Branch Fingerprint Agent ZIP NEW LAPTOP: - Admin login करें. - सही Agent ZIP Download करें. - Extract करें. - GVT/Fingerprint का official driver/SDK install करें. - Agent Manager से Pairing Code बनाकर PAIR_AGENT.bat चलाएं. FUTURE UPDATE: - नया complete Agent ZIP तैयार करें. - Agent Download Files में Version + ZIP + Update Note चुनें. - Upload & Make Current दबाएं. - उसी समय से सभी नए downloads नया ZIP देंगे. - Website/backend को adapter update के लिए edit करना जरूरी नहीं है. - Restore Bundled Agent से custom package हटाकर built-in package वापस किया जा सकता है. SECURITY: - Download केवल logged-in Admin कर सकता है. - ZIP में pairing token/password नहीं रखा जाता. - हर PC pairing के बाद अपना अलग private token पाता है. - Maximum upload size AGENT_RELEASE_MAX_BYTES environment variable से बदली जा सकती है. ANDROID APP V45 ---------------- Android App aur Website same Hostinger backend aur same MySQL use karte hain. Android App direct MySQL password use nahi karti. V45 secure Mobile API login/refresh sessions use hote hain. Full Admin/Staff/Student portal App ke authenticated WebView me bhi available hai; Royal Ludo sirf App local assets me hai.