BvLogic ERP — User Manual
Everything the system does, where to find it, and how to use it day to day.
BvLogic Academy · Version 1.2 · 30 July 2026
1. What this system is
BvLogic ERP runs the whole academy in one place: enquiries, admissions, students, batches, fees, attendance, online classes, exams, staff, payroll and reporting. It replaces working across separate registers, spreadsheets and WhatsApp threads.
It is a large system — over 200 screens. Most people only ever need the six or seven that belong to their job. This manual is organised so you can read only your section and still know what exists elsewhere.
2. Getting in
The two ways to use the system
| Interface | Who it is for | How to open it |
|---|---|---|
| Full ERP (desktop / laptop) | All office staff, teachers, management | Open https://codexla.com in a browser and sign in. This is the complete system. |
| Mobile app (phone) | Teachers marking attendance, staff clocking in, management on the move | Open /app on your phone and choose “Add to Home Screen”. See section 17. |
Signing in
- Go to https://codexla.com and enter your own email and password.
- If two-factor is switched on for you, a code is emailed — enter it to continue.
- You land on the dashboard for your role.
Signing in with a QR code
Nobody has to be told a password out loud or by message. An administrator issues a QR code and the person scans it with their phone's own Camera app — nothing to install first, and it works on Android and iPhone alike. They are signed in, and the system immediately asks them to choose their own password. After that they can sign in either way.
| Code type | Behaviour | Use it for |
|---|---|---|
| One-time code | Works once, expires after 30 days, and dies the moment a password is set. | Getting somebody in for the first time. This is the normal choice. |
| ID-card code | Can be reused until revoked, expires after 180 days. | Only where the printed card stays with that person — anyone holding it can sign in as them. |
- One person: System → Users & Roles → the QR button on their row → issue. The code is shown once only, so print it there and then.
- A whole batch of students: Academics → Batches → the QR button on the batch row. That produces a printable sheet, one card per student.
- Revoking: the same screen has "Revoke all". A lost card stops working the moment you press it.
- Scanning from inside the app: the sign-in screen also has "Sign in with a QR code" if the camera is easier than typing.
An account with two-factor switched on will not accept a QR code and asks for the email and password instead. That is deliberate: a code on paper is not a second factor.
Creating accounts and resetting passwords
Only the Super Admin role can create accounts or reset passwords. Not even the CEO role can — that separation is deliberate, since whoever can create users can create an account with any level of access. Both live at System → Users & Roles.
- New account: fill the form on that page — name, email, a temporary password, and tick every role that applies.
- Reset a password: open the pencil button on that person's row and fill in "Reset password". Leave it blank and the existing password is untouched.
- Give one person extra access without changing their role: the shield button on their row.
3. Roles — who sees what
What you can see and do is decided by your role. The sidebar hides anything your role cannot use, so two people looking at the same system will genuinely see different menus. That is intended, not a fault.
| Role | What it is for | Main areas |
|---|---|---|
| Super Admin | System owner / IT | Everything, including creating users and roles |
| CEO | Business owner | Everything except user/role management. Plus CEO dashboards and student feedback |
| Academy Head | Academic oversight | View across students, fees, attendance, LMS, HR, finance; manages KPI |
| Operations Manager | Runs day-to-day operations | Students, courses, batches, enrollment, attendance, LMS, leads, certificates, approvals |
| Admin (front desk) | Reception and admissions | Register students, fees, attendance, leads, certificates, visitors |
| Accountant | Money | Fee collection, payment proofs, expenses approval, income & P&L, reconciliation |
| HR Manager | Staff | Employees, staff attendance, leave, payroll, KPI |
| Sales Manager | Admissions team lead | Leads, CRM reports, sales targets |
| Sales Rep / Counselor | Follows up enquiries | Leads and online admissions |
| Teacher | Teaching staff | Own batches only: attendance, classes, materials, assignments, exams, student leave |
| Project Coordinator | Student projects | Projects and placement |
| Receptionist | Front desk | Leads, visitors, online admissions |
| Student | Enrolled learner | Own portal only — see section 18 |
| Guardian | Parent | Read-only view of their own child |
4. Everything it can do — the full map
This is the complete sidebar. If something below is missing from your screen, your role does not have it.
Overview
| Menu item | What it does |
|---|---|
| Dashboard | Your role's summary screen |
| My Workspace | Your own attendance, leave, payslips and KPI as an employee |
Academics
| Menu item | What it does |
|---|---|
| Students | Register, edit, search students; documents, fee history, lifecycle |
| Courses | Course catalogue, fees, duration, VSS codes |
| Batches | Class groups, teacher assignment, enrollment, batch/course transfer |
| Rooms | Physical rooms with booking and clash detection |
| Timetable | Weekly class schedule |
| Fee Collection | Record payments, installment plans, receipts, outstanding balances |
| Scholarships | Discounts and scholarships against a student's fee |
| Refunds | Refund requests and disbursement |
| Payment Proofs | Verify receipts students uploaded themselves |
| Attendance | Mark attendance, view history and per-batch reports |
| LMS / Online Classes | Schedule Zoom classes, upload materials, set assignments, grade |
| Exams & Gradebook | Quizzes, tests and exams — written or auto-marked online |
| Announcements | Notices to the whole academy or one batch |
| Student Leave | Approve or reject student leave requests |
CRM & Sales
| Menu item | What it does |
|---|---|
| Leads / Inquiries | Every enquiry, its status and follow-up history |
| Follow-Up Remainders | Which follow-ups are overdue, due today or upcoming |
| Online Admissions | Applications submitted through the public form |
| Outsiders | Visitor log for people who are not students or staff |
| Sales Targets | Monthly targets per counselor and actual achievement |
HR & Payroll
| Menu item | What it does |
|---|---|
| Employees | Staff records, contracts, salary structure, contracted hours and the days of the week each person works |
| Leave Management | Staff leave requests (students are separate — see Student Leave) |
| Payroll | Monthly payroll runs and payslips, including allowances, hours worked, commission and bonus |
| Commission & Bonus | Day-by-day commission, bonus and one-off deduction entries that reach the next payslip |
| Holiday Calendar | Gazetted holidays, academy closures, and declaring any single day on or off |
| KPI System | KPI templates, monthly grading, bonus recommendations |
Finance
| Menu item | What it does |
|---|---|
| Expenses | Record and approve spending, with vendor details required |
| Income & Finance | Income ledger and profit & loss |
| CEO Reports | Executive dashboards — revenue, students, staff |
| Report Center | Around 30 reports, all with date filters and Excel export — section 15 |
| Reconciliation | Automatic money checks plus a question-answering assistant — section 16 |
| Student Feedback | Feedback students submit about teaching and facilities |
Projects
| Menu item | What it does |
|---|---|
| Projects | Student project tracking with milestones and budget |
| Placement Tracking | Job placements, employer and salary offered |
| Internship Certificates | Issue BvLogic internship certificates, publicly verifiable |
| Completion Requests | Approve course completion, which closes the enrollment |
System
| Menu item | What it does |
|---|---|
| Users & Roles | Create accounts, assign roles, grant individual extra permissions |
| QR sign-in codes | Issue or revoke a sign-in code for one person (the QR button on their row in Users & Roles), or print a sheet of cards for a whole batch from Academics → Batches — section 2 |
| Company Settings | Academy name, logo and address used on receipts and letterheads; also the campus location used for attendance checking |
| Activity Logs | Who changed what, when, from where |
| Fee & Recovery Policy | Late fee amount and reminder timing — changeable without a developer |
5. Students
Registering a new student
- Go to Academics → Students → Register Student.
- Fill in the student's details. A registration number is generated automatically.
- Assign the course on the same screen. Pick Course, then Batch, then enter the fee and any discount. The payable amount updates as you type.
- Save. The student is registered and enrolled in one step, and appears in Fee Collection immediately.
Leaving the course section blank is also fine — it registers the student without enrolling them. You can enroll them later from Batches → Enroll.
The student profile
Open any student to see, in one place: personal details, enrolled courses, full payment history, attendance, documents, certificates and lifecycle stage. From here you can also print a registration slip or a fee receipt.
Documents
Upload CNIC, qualifications or photographs on the student's profile. Accepted formats are JPG, PNG and PDF.
Transferring a student
Use Batches → the enrollment → Transfer to move a student to a different batch or course. Payment history is preserved. The fee is only recalculated if the course itself changes.
6. Courses, Batches, Rooms and Timetable
Courses
The catalogue: title, code, duration, standard fee and — where applicable — the PSDF VSS code. Editing a course fee does not change students already enrolled at the old price.
Batches
A batch is one running group of a course: its own code, start date, timing, mode (physical, online or hybrid), capacity and assigned teacher. Batch status moves through Upcoming → Active → Completed (or Cancelled).
Rooms and Timetable
Rooms can be booked per batch and the system refuses double bookings. The Timetable screen shows the weekly schedule.
7. Fees & Money
Recording a payment
- Go to Academics → Fee Collection and search by name, registration number or phone.
- Open the student's enrollment and choose to record a payment.
- Enter amount, method, date and reference. Attach the receipt image if you have one.
- Save. The balance, the fee status and the income ledger all update together.
Installment plans
Split a fee into 1–24 installments with your chosen interval. The system generates the due dates and can chase them automatically.
Receipts
Print a fee slip or a registration slip as PDF from Fee Collection, the installment history, or the student's profile. Both carry your academy letterhead from Company Settings.
Scholarships and refunds
Scholarships reduce the payable fee and are recorded against the enrollment. Refunds follow request → approval → disbursement, and correctly reduce the amount the student is recorded as having paid.
Payment proofs uploaded by students
Students can upload a bank challan or transfer screenshot themselves. It lands in Academics → Payment Proofs for the accounts team.
- Open Payment Proofs. Anything awaiting checking is listed with the amount claimed.
- Click View to see the uploaded receipt.
- Verify to accept it, or Reject with a reason.
Overdue fees and late fees
Fee Collection → Overdue lists everyone past a due date. The late fee amount and reminder timing are set in System → Fee & Recovery Policy — no developer needed.
8. Attendance
Marking a class (office / teacher, on a computer)
- Go to Academics → Attendance and choose the batch.
- Set the date if it is not today.
- Mark each student Present, Absent, Late or Leave.
- Save.
Marking by QR code (phone)
Two ways, both in the mobile app — see section 17:
- Teacher shows a class QR and students scan it. The code refreshes every 30 seconds so a screenshot cannot be reused.
- Teacher scans each student's personal QR from their phone.
Attendance from joining an online class
When a student clicks Join on an online class, attendance is recorded automatically and they are taken into the meeting.
- It only counts around the scheduled class time — from 30 minutes before, until an hour after it ends.
- Opening the link days later still lets them in, but does not mark them present.
- It never overwrites a mark a teacher has already made. Your record always wins.
Viewing attendance
Per batch: Attendance → Report. Across the academy, with filters and Excel export: Report Center → Attendance.
9. Online Classes (LMS)
Scheduling a class
- Go to Academics → LMS / Online Classes.
- Choose the batch, give the class a title, pick the platform and set date, time and duration.
- Save. For Zoom, the meeting is created and the join link is filled in automatically.
If a class is saved without a link for any reason, the screen warns you at the time. It no longer fails silently.
Cancelling a class
Cancelling deletes the online meeting and removes the Join button from students' screens.
Materials, assignments and recordings
- Materials — upload slides, notes or a course outline against a class; students see them on the batch page.
- Assignments — set with a deadline; students submit files; you grade and give feedback in the same place.
- Recordings — add the recording link after the class and students can watch it back.
Exams and gradebook
Under Academics → Exams & Gradebook. Exams are categorised as quiz, test or exam, and are either written (you enter marks) or online multiple-choice (marked automatically).
Announcements and discussion
Announcements go to the whole academy or one batch, and reach students in the portal and on their phones. Each batch also has a question-and-answer discussion board.
10. Student Leave
Students apply for leave from their portal. Requests come to the batch's teacher.
- Go to Academics → Student Leave. The count of requests awaiting you is shown at the top.
- Read the reason and open the attachment if one was provided — for example a medical certificate.
- Approve or Reject, adding a note if useful.
Teachers see only their own batches' requests. Operations and admin staff see all of them.
11. Leads & Admissions
Enquiries
Every walk-in, call or online enquiry is a lead: source, interest, status and full follow-up history.
Follow-ups
CRM → Follow-Up Remainders splits your leads into Overdue, Due Today and Upcoming so nothing is forgotten.
Turning a lead into a student
Open the lead and choose Register as Student. The registration form opens pre-filled and the lead is marked converted and linked automatically when you save.
Online admissions and visitors
Applications from the public form arrive under CRM → Online Admissions. Walk-in visitors who are not students or staff are logged under Outsiders.
12. HR & Payroll
- Employees — records, contracts and salary structure including house rent, medical and transport allowances.
- Staff attendance — staff clock in and out from the mobile app; hours accumulate for the month.
- Leave Management — staff leave requests. Student leave is a separate screen.
- Payroll — monthly runs producing payslips with allowances, hours worked, commission, bonus and deductions.
- KPI System — templates, monthly grading and bonus recommendations.
Staff see their own attendance, leave, payslips and KPI under Overview → My Workspace.
Every person's own working hours
Two fields on each employee decide what payroll expects of them, and they exist because the academy runs full-timers alongside part-timers:
- Contracted hours per day — 9 for full time, 4 or 6 for a part-timer.
- Working days of the week — tick the days that person actually works. Monday to Saturday by default; tick Sunday for staff who work it; a part-timer might be Monday, Wednesday and Friday only.
The holiday calendar and declaring a day on or off
Payroll → Holiday Calendar. Payroll reads this, so it must be filled in before a month is processed.
- Holidays — a paid holiday reduces the hours staff are expected to work, so nobody is docked for a day the academy was closed. One click adds the six fixed national holidays for a year.
- Eid, Ashura and the other Islamic dates are never added automatically. They move with the moon and are announced each year, and a guessed date would go straight into somebody's salary. Add them yourself once they are announced.
- Declare a day on or off — any single date, for one person or for the whole academy. "This Sunday is on" is one entry. A declaration for one person beats an academy-wide one, and both beat a gazetted holiday, because sometimes the academy works through one.
Paid leave
Twelve paid days a year, held as an annual pot rather than one day a month — take nothing in January and all twelve are still there in June. A day is spent in that person's own hours, so one day off costs a four-hour part-timer four hours of the pot, not nine. What is left is shown on the payslip.
Commission, bonus and one-off deductions
Payroll → Commission & Bonus. Entries are recorded against the day they were earned, not lumped into a month, and are swept into that month's payslip when payroll runs.
- Choose the person, the type (commission, bonus or deduction), the date, the amount and a note.
- The totals at the top show what is outstanding — recorded but not yet paid.
- An entry can be deleted while outstanding. Once it is on a payslip it is locked, because removing it would leave the payslip and the record disagreeing. Record a correcting entry instead.
- Fill in sales commission generates one entry per enrolment, on the day it happened, at the percentage set in Settings. Safe to run twice — it never duplicates.
- The payslip itemises every line, so anyone can check the figure themselves.
Running payroll
- Make sure every employee has a salary structure, contracted hours and a weekly pattern.
- Put that month's holidays and any on/off declarations on the calendar.
- Record the month's commission, bonus and deductions.
- Run payroll for the month and compare the payslips against your own sheet before paying anybody.
A month can only be run once. If something was wrong, delete the run and do it again: commission and bonus entries return to outstanding automatically, so nothing is lost or paid twice.
13. Expenses & Finance
Recording spending
Finance → Expenses. Vendor name, vendor contact and payment method are required — this is a deliberate control so that spending can always be traced.
Large expenses need CEO approval above a threshold set in Settings, and management is notified when one is submitted.
Income and P&L
Finance → Income & Finance shows the income ledger and profit and loss. Fee payments post here automatically when recorded.
14. Projects, Placement & Certificates
- Projects — student projects with milestones and budget.
- Placement — where students were placed, with employer and salary.
- Internship Certificates — issued as PDF and verifiable by anyone at /verify/<code>.
- Completion Requests — approving one marks the course completed and closes the enrollment properly.
15. Report Center
Finance → Report Center holds around thirty reports. Every one has Daily / Weekly / Monthly / Yearly / specific-month / custom-range filters, and nearly all export to Excel.
| Area | Reports available |
|---|---|
| Money | Total Sales Details · Fee Collection (Excel + PDF) · Fee Recovery & ageing · Daily Cash Flow · Financial / P&L · Expenses · Course Profitability · Fee Recovery Risk |
| Students | Student 360 · Enrollment · Registered–Not-Enrolled · Course Progress · Dropout Risk · Batch Strength |
| Attendance | Attendance by batch · Attendance per student · Session Activity (time in system) |
| Teaching | LMS Activity · Assignment Completion · Quiz/Test Performance · Discussion Activity |
| Sales | CRM / Leads funnel · Counselor Scoring |
| Staff | HR · Leave · KPI Performance |
| Operations | Projects · Certificates · Completion Requests · Rooms & Timetable · Visitor Log · Placement |
| Management | Daily Management Summary · Exceptions & Alerts |
| Build your own | Custom Report Builder — pick a module, choose columns and filters, save and export |
16. Reconciliation & asking questions
Finance → Reconciliation checks the money automatically and lets you ask questions in plain language.
The health checks
Each run verifies that recorded payments match the ledger, that balances are arithmetically correct, that fee status labels match reality, that every payment reached the income accounts, and it flags possible duplicate payments. It runs daily and shows anything at risk.
Student lookup
Search by name, phone, registration number, CNIC or email to get that student's full financial position instantly.
Ask a question
Type questions such as “how much has Hammad Khan paid in total” or “which teacher has the most students”. The figures always come from the database — the assistant explains them, it never invents them.
17. The mobile app
It is the same system, sized for a phone. Full step-by-step instructions with a QR code to scan are on the install page — Get the Mobile App in the sidebar, which anyone can open without signing in.
Android
- Open https://codexla.com in Chrome and sign in.
- Menu (⋮) → Install app, or Add to Home screen.
iPhone and iPad — the order matters
- Open the address in Safari. This does not work in Chrome on iPhone.
- Share button → Add to Home Screen → Add.
- Close Safari, open the new BvLogic icon, and sign in there.
There is no separate download for iPhone and nothing to wait for — the install page is how iPhone users get it, and it is the same app Android users install.
What you get, by role
| Role | On the app |
|---|---|
| Teacher | Take attendance by QR · clock in/out · student feedback · classes |
| Staff | Clock in/out · monthly hours · notifications |
| Management / CEO | Cash today and month-to-date, expenses, outstanding, new students, staff clocked in |
| Student | Scan attendance · personal QR · progress · schedule · fees · leave · announcements · feedback |
| Guardian | Their child's summary and announcements |
Notifications can be pushed to your phone for announcements and alerts — allow notifications when asked.
18. Student & Parent portals
Students can
- See courses, progress and remaining days
- See attendance — present, absent, late and leave
- Join online classes (which marks their attendance), and watch recordings
- Download materials and submit assignments
- Take online exams and see results
- See fees, payment history and upload a payment receipt
- Apply for leave and track the decision
- Read announcements, use the discussion board, download certificates, give feedback
Parents can
See their own child's fees, attendance and exam results, read-only.
19. Step-by-step workflows
A walk-in enrolls today
- Log the enquiry under Leads (skip if they enroll immediately).
- Students → Register Student — fill details, choose course, batch and fee, save.
- Fee Collection — search the student, record the payment received.
- Print the fee slip and hand it over.
Running an online class
- LMS — schedule the class on Zoom; the link is created for you.
- Upload the material for the session.
- Students click Join at class time; their attendance is recorded automatically.
- After the class, add the recording link and set an assignment if needed.
A student says they already paid
- Ask them to upload the receipt from their portal, or take it at the counter.
- Payment Proofs — open it, check the receipt against the bank.
- Verify to record the payment, or reject with the reason.
Month end
- Report Center → Fee Collection — what came in.
- Fee Recovery — what is still outstanding and how old.
- Daily Cash Flow and Financial — cash and P&L.
- Reconciliation — confirm no money is unaccounted for.
- Payroll — run payroll and issue payslips.
20. Before you report something as missing
Most “this is missing” reports have turned out to be one of the four things below. Please check them before raising it.
- Are you on your own login? A shared admin account shows a different menu from yours. Sign in as yourself.
- Does your role include it? Check section 3 and 4. The sidebar hides what your role cannot use.
- Is it empty rather than absent? Many screens look missing when no data has been entered yet — timetable, materials, assignments, announcements and exams all start empty. An empty screen is not a broken screen.
- Is it under a different name? See the table below.
| If you are looking for… | It is here |
|---|---|
| Separate admin / teacher / student systems | One system, three views. Your role decides what you see — section 3 |
| Assigning students to a teacher | Assign the teacher to the batch; students belong to batches |
| Course outline upload | LMS → Materials, against the batch or class |
| Fee receipt for the student | Fee Collection → Slip, or the student's profile |
| Who changed this record | System → Activity Logs |
| Student attendance percentage | Report Center → Course Progress, or the student's profile |
| Combined registration + course revenue | Report Center → Total Sales Details |
| Students who paid but never joined | Report Center → Registered–Not-Enrolled |
| Changing the late fee amount | System → Fee & Recovery Policy |
| Giving one person extra access | System → Users & Roles → Permissions (no role change needed) |
| A sign-in code for one person | System → Users & Roles → the QR button on their row |
| Recording commission or a bonus | Payroll → Commission & Bonus (record it against the day it was earned) |
| Marking Eid or a public holiday | Payroll → Holiday Calendar |
| Making a Sunday a working day | Payroll → Holiday Calendar → Declare a day on or off |
| Giving one person a single day off | Same screen — declare the date OFF and name that person |
| Setting part-time hours | The employee's record: contracted hours per day, and the days of the week they work |
| How much paid leave somebody has left | Their payslip — twelve days a year, drawn down |
| Sign-in cards for a whole batch | Academics → Batches → the QR button on the batch row (prints a sheet) |
| Getting a student into the app without giving out a password | Print their batch's QR cards — they set their own password after scanning (section 2) |
| The app for an iPhone | Safari → Add to Home Screen. There is no App Store download; section 17 |
If it is still genuinely missing, report it with: your role, the screen you were on, what you expected, and what happened instead. That is usually enough to resolve it same-day.
21. Known limits right now
| Item | Status |
|---|---|
| Google Meet class links | Not connected. Use Zoom, or paste a link manually. Awaiting a one-time Google sign-in by the owner. |
| Student logins | Created — every enrolled student now has an account. None of them can sign in until their QR card is printed and handed over (section 2), because no password was ever set on those accounts. |
| Timetable data | Empty until class schedules are entered. |
| Staff clock-in | Working, but no records yet. Monthly hours and any hours-based payroll stay empty until staff start clocking in from the app. |
| Salary structures | Set for only a handful of employees. Payroll pays basic salary alone until each employee has one, so allowances are missed. |
| Contracted hours | Every employee currently defaults to 9 hours a day, Monday to Saturday. Correct the part-timers before payroll is run against hours. |
| Short-hours deduction | Deliberately switched off. Hours are recorded and reported, but no salary is reduced until an administrator turns it on after a checked month. |
| Holiday calendar | Empty until holidays are entered. Add the year's holidays before running payroll, or a closed day counts as a missed one. |
| EOBI, income tax, provident fund | Not calculated. Statutory deductions are handled outside the system. |
| Batch capacity | Not set on existing batches, so occupancy reporting is incomplete until filled in. |
| Bank statement matching | Digital payments are recorded but statement upload and auto-matching is not built yet. |
| Uploaded receipts | Anyone with the exact file link can open it. Do not share those links outside the academy. |