BvLogic ERP — User Manual

Download / Print as PDF Use your browser's “Save as PDF” option.

What changed in this edition (24 October 2026)

Version 1.4 adds everything built between 1 and 24 October 2026. In plain words:

• Students mark their own attendance from the app. An Attendance tile on the student app home, within 200 m of campus, inside the class window from the timetable, one mark per class per day; refusals are recorded and nothing is marked. See section 8.
• Segment and certification filters on the student list. NAVTTC / PSDF / TCF / Private with live counts, a certification selector, badges on each row and a count line on the dashboard. See section 5.
• A Help button on every staff page. Bottom right. Type how you want to do something, in English, Urdu or Roman Urdu, and it answers from this manual and the guides, with links to the right section and to the pages you are allowed to open. If the manual does not cover it, it says so and gives the office number. See section 2.
• Certification Management. A teacher asks for a student's certificate from Request Certification; the accountant and the academy head check fees and approve, reject or grant a fee exception in the Certification Register, which has search, filters and ten exports. Approval emails the student. See section 15.
• NUTECH Applications. Group the eligible students into a named application, set its status, and export it as Excel or CSV. See section 15.
• Assign Another Course on the student profile saves a real enrolment with its fee, without charging the registration fee again. See section 5.
• Student data rules and the CNIC. Names, phones, emails and CNICs are checked on the form; the CNIC is stored as 13 digits and shown as 35202-1234567-1. See section 5.
• Course outline tracking. Which modules of the outline each student has opened: the student's own page, a teacher's matrix per batch, and an admin report with an Excel export. See section 5.
• Leads: Export to Excel and Upload Excel. Update statuses, notes and follow-ups in bulk, with a preview of every change before anything is saved. See section 12.
• Orientations, Hero programmes and the AI Counsellor desk in CRM and Courses. See section 12 and section 6.
• CEO pages from CEO Growth: Revenue Command Center, Free-to-paid funnel, Weekly KPI (twelve numbers), Unit economics, Revenue per 1,000 visitors, and the Sales team report. See section 20.
• Curriculum Reviews, Curriculum Signals and the Demand Meeting Pack. See section 6 and section 20.
• Media Calendar and Media mix, Research authority, SEO maintenance. See section 20 and section 18.
• Growth desk: campus ambassadors (20% commission on the net course fee of the referred student's first paid enrolment), CRO experiments, graduate outcomes, employer skills demand. See section 15.
• Talent desk: employer accounts and API keys, Employer-Verified Projects, introductions. See section 15.
• Skills Score levels on the CEO Education numbers: Beginner, Foundation, Job Ready, Professional, Advanced. See section 20.
• Help Questions for the CEO: every question staff asked the Help button, and the ones it could not answer. See section 20.

1. What this system is

BvLogic ERP runs the whole academy in one place: enquiries, admissions, funded projects, students, batches, fees, attendance, online classes, free courses, exams, staff, payroll, support and reporting. It replaces working across separate registers, spreadsheets and WhatsApp threads.

It is a large system, with well 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 ways to use the system

Signing in

1. Go to https://codexla.com and enter your own email and password.
2. If two-factor is switched on for you, a code is emailed — enter it to continue.
3. You land on the dashboard for your role.

Forgotten password — reset it yourself

On the sign-in page, click “Forgotten your password? Reset it yourself” and enter your email. A reset link is emailed and works for 60 minutes. The new password needs at least 8 characters with letters and numbers. Afterwards you sign in normally, and any printed QR sign-in card you hold stops working.

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.

• New students get one automatically. Registering a student creates their login (section 5), and their registration slip and fee slip carry a “Start using the app” panel with their username and a “Scan to sign in” QR — until they have chosen a password. Reprinting the slip cancels the QR on the earlier print.
• 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 staff accounts or reset passwords for others. The CEO role cannot — that separation is deliberate, since whoever can create users can create an account with any level of access. Both live at System → Users & Roles. (Student logins are the exception: they are created automatically when a student is registered.)

• New account: fill the form on that page — name, email, a temporary password, and tick every role that applies. One person can hold several roles.
• 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.
• “No mailbox” warning: Users & Roles warns when active accounts have an email address the mail server refuses. Those people receive no scheduled reports or digests until the address is corrected.

Stuck? Ask the Help button

Every staff page has a round Help button at the bottom right. Click it and type what you are trying to do, in English, Urdu or Roman Urdu, for example how do I record a fee payment? or fee ki receipt kaise print karun?

1. It looks for the sections of this manual and the guides that answer the question and shows them under From the manual, each one a link to the section.
2. Under Pages you can open it lists the ERP pages those sections describe, but only the ones your own role can open.
3. The answer is written from those sections only. When the academy's AI key is configured, the AI phrases the answer in your language and must name the sections it used; a reply that mentions a page, link or figure that is not in the manual is thrown away and the sections' own text is shown instead. Without the key, you get the sections' own text and links, which is enough to find the page.
4. If nothing in the manual matches, it says it does not know, with a link to the manual and the office WhatsApp and phone. It never guesses.
5. Click Yes or No under the answer. The CEO reads every question and every "No" (section 20, Help Questions), and the manual grows where people were stuck.

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.

4. Everything it can do — the full map

This is the complete sidebar, in the order it appears. If something below is missing from your screen, your role does not have it. A heading only shows when you can use the first item under it, so an item can appear under the previous heading on your screen — the item is the same.

Overview

Academics

CRM & Sales

HR & Payroll

Finance

Projects

System

Added since version 1.3

• Academics: Curriculum Reviews, Curriculum Signals, Hero programmes (from Courses), Assign Another Course and the data rules on the student profile, course outline tracking (My batches → Outline; Report Center → Course Outline Progress).
• CRM & Sales: Export to Excel and Upload Excel on Leads, Orientations, AI counsellor, Sales team report (from CEO Growth).
• Academics (lower part): Employers, BvLogic Talent, Alumni, Growth programmes.
• Projects: Request Certification, Certification Register, NUTECH Applications.
• Finance / management: CEO Growth → Revenue Command Center, Free-to-paid funnel, Weekly numbers, Unit economics, Revenue per 1,000 visitors; Media Calendar and Media mix; Demand Meeting Pack; Help Questions.
• Report Center: Course Outline Progress, Research Authority (referring domains), SEO Maintenance.
• Everywhere: the Help button.

5. Students

Registering a new student

1. Go to Academics → Students → Register Student.
2. Fill in the student's details. A registration number is generated automatically.
   • Phone must be a complete Pakistani mobile number (spaces, dashes and +92 are fine).
   • City is required — where the student lives, not the campus.
   • CNIC is optional, but a CNIC already on file is refused and the screen names who holds it. One CNIC is one person.
   • A phone number already on file stops the save once and names the other person. If they really are different people (siblings sharing a phone), tick “Same number, different person” and save again.
3. 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. Use Assign Another Course to add more — up to ten courses on one registration, covered by one registration fee.
4. Answer “Who brought this student in?” — a staff member, or “Nobody at the academy”. This is required: sales targets and commission are credited from it. Someone outside the academy who referred them goes in the separate free-text box.
5. Enter the registration fee and how it was paid. If they paid by transfer, attach the payment proof; it goes to Payment Proofs for the accountant to verify.
6. Save. The student is registered and enrolled in one step, appears in Fee Collection immediately, and gets an app login (below).

Leaving the course section blank is also fine — it registers the student without enrolling them. You can enroll them later from Batches → Enroll.

Their login and welcome letter

Saving creates the student's login automatically and emails them a welcome letter. The success message tells you whether the email went. A student with no email still gets a login, named after their registration number (…@student.bvlogic.academy); no email is sent, so print their receipt and have them scan the QR on it to choose a password.

Funded students (NAVTTC / PSDF)

When a funded project is running, the form shows a Funded Project choice. Picking it attaches the student to that project and counts them as joined even at a registration fee of Rs 0. A course fee is only billed if you assign a course; a blank fee means the course's list price, not free.

Joined, not joined, and the joining date

• A registration fee above the amount set in System → Fee & Recovery Policy (Rs 5,000 unless changed) counts as joined. That amount or less leaves the student at the admission stage until they pay towards a course.
• Academics → Not Joined lists those students with how many days they have waited. Filter by month, dates, or “Waiting 7+ days only”. Fee holders also see the money columns and can export to Excel, which names who handled each student.
• A student leaves the list by paying — any course payment moves them to joined.
• The joining date is the date of their first paid installment. The profile shows “Joined on”, and the attendance register shows it too.

The student profile

Open any student to see, in one place: personal details, enrolled courses, attendance, documents, certificates and lifecycle stage. Fee holders also see the Registration & Joining card, the Fee Management card (Total Fee is registration fee plus course fee; any amount paid above a course's fee is shown as a warning, and never counts against another course) and the full payment history. From here you can print a registration slip or a fee receipt.

Clicking a student's name on most lists and reports opens this profile, if you are allowed to see student profiles. Teachers see only their own students, with a Paid / Partial / Pending / Overdue badge per course and no amounts.

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.

Assign Another Course

Students → open the student → Course Enrollments card Needs: create-students (admin, operations, sales, reception, project coordinator)

A student who is already registered and wants a second programme does not need a second registration. On the profile, the Assign Another Course button at the top of the Course Enrollments card opens a form.

1. Choose the Course (active courses, shown with their list fee) and then the Batch. Only open private batches that are upcoming or active are offered; NAVTTC seats are added on the NAVTTC portal, not here.
2. Set the Start date (today by default).
3. Leave Course fee blank to use the course's list price, or type the agreed fee. Add a Discount in rupees or percent, with its reason. The line Payable for this course updates as you type.
4. Click Save course assignment.

What is saved: one enrolment on that batch with the gross fee, the discount and the net fee, nothing paid yet, and the net fee added to Fee Collection. The registration fee is not charged again. An instalment plan is set afterwards from Fee Details, as for any enrolment. The learner gets the usual enrolment notice.

The form refuses, and says why, when: the student is dropped out; the batch belongs to another course; the batch is not upcoming or active; the batch is NAVTTC; the discount is more than the fee; the student is already on that batch; or the student is already active on the same course (use Transfer on that enrolment instead).

Student data rules and the CNIC

Students → Register Student / Edit Profile

The registration and edit forms now check the data the same way, and tell you exactly what to fix:

For records entered before these rules, an administrator can run php artisan students:validation-report (a read-only list of every record with a name, registration number, CNIC, phone, email or duplicate problem; fix each on its Edit Profile page) and php artisan students:normalize-cnic --apply, which rewrites CNICs that are 13 digits written with dashes into the stored form and leaves anything else alone. Neither runs by itself.

Course outline: which modules a student has opened

Student portal → batch → Open the outline My batches → Outline (teachers) Report Center → Course Outline Progress (view-reports)

When a course has a published outline, the system records the first and last time each student opens each module and how often. "Viewed" means opened, not studied or completed.

• Student: on their batch page, the Course outline card shows "X of Y modules opened" and a button Open the outline. Each module shows Viewed or Not viewed with the dates. Opening a module records it.
• Teacher: My batches has an Outline button per private batch (also Outline progress on the batch page). The matrix shows every student against every module (M1, M2, ...), the viewed and not-viewed counts, the progress and the last opening. Set Follow up below (50% by default) and click Apply; the students under that line are highlighted and listed in the Follow up card.
• Office / management: Report Center → Course Outline Progress. Filter by course, batch, teacher, student, active or all batches, and the low threshold; Apply, Reset, or Export to Excel. The By batch table gives the average viewing per batch with a Matrix link; the Students table is sorted by progress. A teacher opening this report sees only their own batches.

The Excel file (outline-progress-date.xlsx) has: Course, Batch, Teacher, Reg No, Student, Total Modules, Modules Viewed, Modules Not Viewed, Outline Viewing Progress %, Last Opened, and a Below n% yes/no column.

Segment and certification filters on the student list

Academics → Students Needs: view-students

Two selectors sit with the other filters at the top of the list, and each option shows its live count under the filters already applied:

• Segment: All segments, NAVTTC, PSDF, TCF or Private, each with its count.
• Certification: Certification required, No certification or Not recorded (students whose profile was never asked), each with its count.

The rule in one sentence: a student is NAVTTC, PSDF or TCF when any batch they are enrolled on belongs to a project of that type, or they sit on the roster of a project of that type; a student with neither is Private. A student on two funded types matches both filters and wears both badges (for example PSDF + NAVTTC); an archived project or batch still counts. Corporate, government and other projects are not a segment, so their students read as Private.

Each row carries its segment badge, and a dark Cert badge when certification is required. The staff dashboard's Active Students card shows the same counts on one line, NAVTTC n / PSDF n / TCF n / Private n, across all students. This is filtering only: NAVTTC leads and NAVTTC batches keep their own portals and lists.

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). A funded batch can also carry its PSDF class code; the trainer's code is entered on the teacher's employee record. Both appear on the project roster.

Rooms and Timetable

Rooms can be booked per batch and the system refuses double bookings. The Timetable screen shows the weekly schedule.

Curriculum Reviews (every quarter)

Academics → Curriculum Reviews See: view-courses · Edit: manage-courses

Every paid programme with a public page gets one review per quarter (named like 2026-Q4). A review is due 45 days into the quarter and shows as Overdue after that. Every Monday at 08:20 the system opens any missing reviews for the quarter and sends a bell notice to everyone who can manage courses, and to the reviewers of overdue ones.

1. On the index, click Open this quarter's reviews if the quarter's reviews are not there yet, then Open a programme from the Overdue or Due table.
2. In the Checklist card fill a Finding and at least one Evidence link (https://... or /path, one per line) for each of the seven points: Technologies, Tools, Employer requirements, Salary, Projects, Obsolete modules, New AI capabilities. Add a Summary and click Save checklist.
3. In the Modules table mark every module Current, Needs update or Retire, with a reason, and click Save on each.
4. Click Complete and sign as (your name). The button stays disabled, and lists what is missing, until every point and every module is done. A completed review is read-only; the next quarter starts a new one.

The History table keeps every review as it was completed, with the reviewer and the date.

Curriculum Signals

Academics → Curriculum Signals See: view-courses · Edit: manage-courses

A signal is opened by the system on the 9th of each month when the data moves: a skill's open postings change by at least 20% and at least 10 postings, a skill moves three places or more in the Skills Index, at least three new employers ask for a skill, or employer intelligence names one. There is one signal per source, skill and month, and a source that would open more than twelve at once is held back.

Each signal has six steps: Research: what changed in the data, Curriculum team reviews the affected programmes, Course updated, New free course, Marketing campaign, Learners reached. Open a signal, and for each step choose an owner, a status (Pending, In progress, Done, Not needed), the due or done date, a link and a note, then Save. The signal closes when every step is Done or Not needed; the index lists open and closed signals.

Hero programmes

Academics → Courses → Hero programmes See: view-courses · Change: manage-courses

The table lists every course with its fee, whether it is a hero programme, and its public funnel page (/journey/slug). Click Make hero or Remove hero on a row. The card The owner's recommended five shows which existing course matches each of AI & Generative AI, Python Development, Data Analytics, Digital Marketing and Cybersecurity; a missing course is never created from here. See the public funnels opens /journey. Hero programmes carry a Hero badge on the Revenue Command Center (section 20).

7. Fees & Money

Recording a payment

1. Go to Academics → Fee Collection and search by name, registration number or phone. You can narrow it by enrolment month or a date range.
2. Open the student's enrollment and choose to record a payment.
3. Enter amount, method (Cash, JazzCash, EasyPaisa, Bank Transfer, Online Payment or Cheque), date and reference. Attach the receipt image if you have one.
4. Save. The balance, the fee status and the income ledger all update together, and the student is emailed a receipt if they have a real email address.

Installment plans

Split a fee into 1–24 installments with your chosen interval. The system generates the due dates. Only students with a plan can be “overdue” or receive fee reminders.

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, and — for a student who has not yet chosen a password — the “Start using the app” panel with their sign-in QR.

Who owes what

• Academics → Pending Students — one row per enrolment with a balance, largest first, with days since the last payment (or “never paid”). Filter by enrolment month, dates, or “Overdue only”.
• Academics → Students by Month — one row per admission month: students, total fee, paid, pending, collected %, how much had come in by day 30/60/90, and how many have settled. Click a month to see its students; Excel export lists every student's fee position.
• Academics → Course Recovery — one row per course: enrolments, fee billed, collected, outstanding and recovery %, sortable. Courses with fewer than ten enrolments are marked “thin”.
• Fee Collection → Overdue lists everyone past a due date.

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

Students can upload a bank challan or transfer screenshot themselves, and the front desk can attach one at registration. Both land in Academics → Payment Proofs for the accounts team.

1. Open Payment Proofs. Anything awaiting checking is listed with the amount claimed.
2. Click View to see the uploaded receipt.
3. Verify to accept it, or Reject with a reason.

Late fees, reminders and the daily list

• The late fee amount and reminder timing are set in System → Fee & Recovery Policy — no developer needed.
• Fee reminders go by WhatsApp at 10:00, a set number of days before, on, and after a due date — only once WhatsApp is connected (section 25).
• Every weekday at 09:15, everyone who can see student fees is emailed the list of enrolments that have never paid anything.

8. Attendance

Marking a class (office / teacher, on a computer)

1. Go to Academics → Attendance and choose the batch.
2. Set the date if it is not today. Future dates are refused.
3. Mark each student Present, Absent, Late or Leave (Leave is recorded as Excused).
4. Save.

The sheet also shows when the batch's training started and ends, and each student's joining date.

Marking on the phone

In the mobile app, Take Attendance → your class gives three ways — see also section 21:

• Tick the register — present, absent, late or excused for each enrolled student. Works in a room where nobody has the app.
• Show QR — students scan the class code. It refreshes every few seconds so a screenshot cannot be reused.
• Scan students — scan each student's personal QR from their phone.

When the campus check is switched on in Company Settings, QR attendance only works on campus: the phone's location must be within the set radius, and faked locations can be blocked.

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.
• A link copied into WhatsApp and opened from there does not mark attendance — only the Join button does.

Viewing attendance

• Per batch, by month: Attendance → Report, with Excel export.
• Across the academy: Report Center → Attendance. Filter by Batch (listed with its course) and by period — today, this week, this month, a specific month, a custom range or all time — then export to Excel.
• Students who have stopped turning up: Gone Quiet (section 16). Three absences in a row also send an alert to the student and teacher.
• Every evening at 8 pm (not Sundays) each teacher gets a “Your classes today” notification: students per batch, attendance against the 90% target, and any batch whose register has not been taken this month.

Student self-marking from the app

Student app home → Attendance tile → Mark Attendance Setting: System → Company Settings → Student self-marking radius (metres)

A student on a campus class can mark their own attendance from the app, the way staff clock in. The Attendance tile appears first on the student's app home only when they have a live enrolment held on campus; an online-only learner sees no tile, because pressing Join on the schedule is how their attendance is recorded. Scan Attendance (the class QR the teacher shows) stays on the grid as before.

1. Open the Attendance tile. The page lists today's campus classes, whether each is already marked, and says You can only mark attendance within 200 m of the academy (or whatever the radius is set to).
2. Allow the phone's location. The button stays off while the location is being checked.
3. Press Mark Attendance. If more than one of the student's classes runs today, choose the class first.

The rules, in order:

• The class window comes from the timetable. The mark is accepted from the join-window minutes before the class starts until the join-window minutes after it ends, read off the same timetable the student's schedule shows. Too early: the page says when it opens. Too late: it says when it closed and to speak to the teacher. A batch whose timetable has no class today is refused; a batch with no timetable at all is open for the day.
• One mark per class per day. A class already recorded today, by anyone, is refused and the existing status is shown. A student's own mark never overturns a teacher's.
• The 200 m fence. The phone must be within the Student self-marking radius of the campus point. The default is 200 m; an administrator changes it under System → Company Settings, in the geofence block beside the staff radius (setting student_attendance_fence_metres, 20 to 5,000). The phone's own accuracy is subtracted before comparing.
• Poor GPS. A reading accurate only to more than 100 m is too rough to confirm the campus and is refused with the distance it reported.
• Mock location. A faked location (a GPS spoofing app replaying one fixed point) is refused while the mock check is on, which is the default.

Every refusal at the fence (outside the radius, poor GPS, mock location) is recorded with the reason, the distance and the accuracy, and nothing is marked. A successful mark says Present: class at time (distance m from campus), is stored with the position and the distance like a staff clock-in, and shows on the teacher's mobile register and the student's own page as Self-marked from the app, next to marks made by the register, a QR scan, joining online or the biometric device.

9. Online Classes (LMS)

Scheduling a class

1. Go to Academics → LMS / Online Classes.
2. Choose the batch, give the class a title, pick the platform (Zoom, Google Meet, Physical or Recorded) and set date, time and duration.
3. Leave the meeting link empty for Zoom or Google Meet: the system creates the meeting and fills in the join link. A link you paste yourself is always kept.
4. Save. You land on the class page, and every enrolled student is notified that a class has been scheduled (“N enrolled student(s) notified”). They get a reminder again in the hour before it starts.

Google Meet is connected under System → Company Settings → Video Conferencing. Meet links are created on the academy's Google account; students do not get a calendar invitation — the link reaches them through the portal and app. If a class is ever saved without a link (for example if the connection is lost), the page says so and tells you which problem it is.

Session Controls (on the class page)

• Status — Live while teaching, Completed afterwards. Completed classes lose their Join button.
• Meeting link — add or replace the join link at any time; students see it straight away.
• Recording link — paste it after the class and students see Watch Recording.
• Cancel this class — keeps the class on the list marked Cancelled, so students see it was called off, and removes the Zoom meeting or Meet event.
• Remove session — only for a class created by mistake. It disappears from every list, but the record is kept and an administrator can restore it.

The title, date and time cannot be changed after saving. To move a class, cancel it and schedule a new one.

Materials, assignments and recordings

• Materials — upload slides, notes or a course outline against a class (or paste a URL); students see them on the batch page.
• Assignments — set one quickly from a class page (visible to students immediately), or with a full brief from Academics → Assignments, where managers can save a draft and publish later and grade every enrolled student, including those who did not submit.
• Resubmission — a student can resubmit until the work is graded. Every earlier version is kept: the class page shows “Resubmitted · N earlier versions” under that submission, with each version's date and file. Once graded, it can no longer be replaced.
• Grading — enter marks and feedback against each submission; students see their mark and your feedback on their course page.

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, with the time limit enforced). Each exam page shows every student's score, grade and pass or fail.

Announcements and discussion

Announcements go to all students, one batch, teachers, or everyone, and reach people in the portal and as a push notification on their phones. A teacher can announce only to their own batches. Each batch also has a question-and-answer discussion board; the teacher is notified of new questions.

10. Course Studio & Free Academy

The Free Academy is the set of short online courses on bvlogic.academy/free-courses. Anyone can read lesson 1. Later lessons need a free BvLogic ID (name, email, mobile and password). Each lesson can have a reading, an exercise, a video and a quiz; a course can have one graded lab. Reaching the course's pass mark — and passing the lab, where the course requires one — issues a certificate (code starting BVLF-) that anyone can check at /certificate/<code>.

Course Studio

Academics → Course Studio (LMS managers). Write and publish a course without a developer:

• Course settings — title, web address, description, duration, instructor, category, English and Urdu walkthrough videos, pass percentage, whether it issues a certificate and whether the lab is required.
• Lessons — add, edit and reorder. Each has a title, objective, reading, exercise (with an optional Urdu version), video and multiple-choice quiz questions with the right answer and a “why”.
• Lab — one per course: a task sheet (English, optional Urdu), time, pass points and a marking rubric that adds up to 100.
• Publish / Retire — a course with no lessons cannot be published. Courses are never deleted; retiring simply takes it offline.

Lab reviews

1. Academics → Lab reviews. The badge shows how many labs are waiting.
2. Open a hand-in, give a mark for every rubric line, and choose Pass or Return.
3. Pass is refused below the lab's pass mark; Return needs written feedback. A returned lab can be handed in again.

The learner sees the marks and feedback on their lab page and in My learning.

11. Student Leave

Students apply for leave from their portal, with an attachment if they have one, and can withdraw a request while it is pending. Requests come to the batch's teacher.

1. Go to Academics → Student Leave. The count of requests awaiting you is shown at the top.
2. Read the reason and open the attachment if one was provided — for example a medical certificate.
3. Approve or Reject, adding a note if useful.

Teachers see only their own batches' requests. Operations and admin staff see all of them.

12. Leads, NAVTTC & Admissions

Enquiries

Every walk-in, call or online enquiry is a lead: source, interest, status and full follow-up history. Enquiries made on the academy website arrive here automatically with source website. They arrive unassigned, and a Sales Rep only sees leads assigned to them — so somebody must assign website leads before reps will see them.

Follow-ups

CRM → Follow-Up Remainders splits your leads into Overdue, Due Today and Upcoming, using the next date on each lead's latest follow-up. A lead whose latest follow-up has no next date drops off the list.

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. Recording a follow-up with outcome “enrolled” takes you to the same form.

NAVTTC Leads

NAVTTC applicants have their own sidebar heading, NAVTTC → NAVTTC Leads, visible only to the named people who work them. They can also be added from the phone (“Add NAVTTC Lead” tile).

• Entering: one form for everything, including the preferred slot (morning or evening). A CNIC already on file is refused; a repeated phone number asks you to confirm it is a different person.
• Searching: one box — type any words of the name in any order, or a CNIC, phone, email or city.
• Editing: everyone must say what they changed and why. The CEO's edits apply at once; anybody else's are held as one request — nothing changes until the CEO approves it. Notes save without approval.
• Approving: the CEO opens NAVTTC → Edit Requests and approves or refuses the whole submission, with a reason. The person who asked is notified.
• Export: an Excel export is on the list. A daily data-entry progress note goes out at 19:30.

Admissions back office and WhatsApp

• Admissions (under the Projects heading) — counsellors enter phone or WhatsApp enquiries with their channel; each one becomes an application and a lead. The page shows the funnel by step and channel, and a banner when payments are waiting. Staff who handle fees see Verify this payment on the application: verifying enrols the student; rejecting needs a reason.
• WhatsApp Enquiries — conversations held by the WhatsApp admissions bot, which asks about education and goals and offers a free course, a weekend cohort, or a hand-off to a counsellor. It only works once WhatsApp is connected (section 25).

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.

Leads: Export to Excel and Upload Excel

CRM & Sales → Leads / Inquiries Export: view-leads · Upload: manage-leads

Update many leads at once without opening each one:

1. Filter the leads list as you want it, then click Export to Excel. The file (leads-update-date.xlsx) holds exactly the leads the list shows, so a counsellor only gets their own. The grey columns are read-only (Lead ID, Name, Phone, Email, Course interest, Source, Assigned to, Current status, Last and Next follow-up); the green columns are the ones you fill: New status, Lost reason, Note, New next follow-up, Follow-up type. They have dropdowns. Read the How to use sheet.
2. Fill the green columns for the leads that changed. Leave the others alone; unchanged rows are skipped. Do not edit Lead ID.
3. Back on the leads page click Upload Excel, choose the file (.xlsx, up to 5 MB) and click Check the file.
4. The Check the Excel upload page shows every change it will make (status from and to, note, next follow-up, type) and every row it will skip, with the reason. Nothing is saved yet. Click Confirm N changes, or Cancel.

Rules: a status can only be one of the list; Lost needs a lost reason; Converted cannot be set here (use Register as Student); a note longer than 2,000 characters, a lead you cannot see, or the same note added again within 30 days is skipped; at most 2,000 changed rows per file. Each applied row adds a follow-up to the lead's history, and the upload is written to the activity log.

Orientations

CRM & Sales → Leads / Inquiries → Orientations Needs: manage-leads

1. Fill Schedule an orientation: title, programme (leave empty for a general one), start in Pakistan time (must be in the future), minutes (15 to 600), Online or On campus, where or how the link is sent, seats, what it covers. Click Schedule.
2. The list is split into upcoming and past, with the number registered. Public page opens the sign-up page (/orientation/number) to share; Cancel cancels it, keeping its registrations on record.
3. Open an orientation to see the registrations: name, phone, city, consent, the lead it created or matched, and the time.

A visitor registers with their name, mobile number, email, city and a consent tick; each registration creates or reuses a lead. The page refuses when the event is past or full, and a number already registered is told so. No email is sent; the page says the joining details come on WhatsApp, which is a counsellor's follow-up.

AI counsellor desk

CRM & Sales → Leads / Inquiries → AI counsellor Needs: view-leads

The website, WhatsApp, Messenger and Instagram counsellor asks a visitor a few questions and recommends a programme. This desk shows those conversations: a card per channel with totals (recommended, next step taken, leads), and a table with the last message, the profile it gathered (level, timing, city, budget), what was recommended (programme, alternative, free course, and whether the wording came from the template or the AI), the next step and whether it was taken, and the lead. Click a channel card to filter. A counsellor who cannot see every lead sees only conversations on their own leads. The desk is read-only: the work continues on the lead.

Sales team report

CEO Growth → Sales team, or /sales/team Needs: view-crm-reports

One line per counsellor for the chosen period: leads received, median first response, never contacted, calls, WhatsApp, counselling conversations, applications, admissions, revenue and conversion. Where a counsellor logged nothing the page says none logged rather than 0. Each lead jumps to the Sales Command Center.

13. HR, Staff Attendance & Payroll

• Employees — records, contracts and salary structure including house rent, medical and transport allowances, and fixed monthly EOBI and income-tax amounts.
• Contract end dates — a contract ending within 30 days, or already expired, is flagged on the Employees list, the person's profile and beside their name on a payroll run.
• Staff attendance — staff clock in and out from the mobile app within the campus radius, or on the biometric machine; 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.
• Salary Cost — what a chosen period costs in pay: each person's monthly pay spread over their own working days, with Excel export. Anyone with no salary on file is named, because they count as zero.
• KPI System — templates, monthly grading and bonus recommendations.

Staff see their own attendance, leave, payslips and KPI under Overview → My Workspace.

The Staff Attendance report

Finance → Staff Attendance (also a tile in the mobile app). Choose Daily or Monthly and a date.

• Daily: present, absent, off or on leave, with clock-in, clock-out, hours and expected hours. A day with no clock-out shows hours as “unknown”, not zero.
• Monthly: days present, working days, hours worked against expected, shortfall, and days left open.
• Click a name for that person's month day by day. Every view exports to Excel.
• Staff who are not expected to clock in are left off the sheets and named in a note, so they are never shown as “Absent”.

Recording attendance by hand

People given this permission see Record attendance on the report. Pick a date (not a future one) and set each person Present, Absent or On leave, with times for Present. Days already recorded by the person's own phone clock-in or by the biometric machine are locked and left untouched.

The biometric device

Finance → Biometric Device (HR, operations, CEO). The machine only knows finger numbers, so each one must be linked to a person once.

• Device card — whether the machine is set up, and when the last punch arrived. It also warns if the machine's clock is wrong.
• Fingers with no person — the enrolment worklist. Choose the employee and press Enrol; all that finger's past punches are claimed and those days rebuilt.
• Hand-written days the machine disagrees with — shown side by side for you to resolve. Nothing is changed automatically.
• End mapping — when a finger should stop counting for someone. Nothing is deleted.

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 outstanding entry can be removed (there is no edit button — remove it and enter it again). Once it is on a payslip it is locked here.
• Fill in sales commission generates one entry per enrolment, on the day it happened, credited to whoever brought the student in. Safe to run twice — it never duplicates.
• The payslip itemises every line, so anyone can check the figure themselves.

Running payroll

1. Make sure every employee has a salary structure, contracted hours and a weekly pattern.
2. Put that month's holidays and any on/off declarations on the calendar.
3. Record the month's commission, bonus and deductions.
4. Run payroll for the month and compare the payslips against your own sheet before paying anybody.

Correcting a payslip after the run

On the payroll run, the pencil beside a payslip opens its deductions: change, remove (set to 0) or add a deduction and the payslip is recalculated. A payslip already marked paid can still be corrected, but only with a written reason, and the change is logged as made to a paid payslip with the net pay before and after.

A month can only be run once. If something was wrong across the board, delete the run and do it again: commission and bonus entries return to outstanding automatically, so nothing is lost or paid twice.

14. 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 (Rs 50,000 unless an administrator has changed it), and management is notified when one is submitted.

Standing costs

Finance → Standing Costs. Declare a regular monthly cost once — category, title, amount, day of the month, start date and optional end date — and it is posted as an approved expense every month automatically, so the P&L never counts income against nothing. The page compares the declared cost base with what was actually posted. Changing an amount does not alter months already posted; Backfill posts any missed months without duplicating.

Income and P&L

Finance → Income & Finance shows the income ledger and profit and loss. Fee payments post here automatically when recorded. The fuller Academy P&L opens from Strategy Boards (finance managers); it says “not available” for any figure it cannot honestly state yet, rather than guessing.

Client Delivery

Academics → Client Delivery (finance managers). Paid client work that BvLogic bills and a supervised student team delivers: create the engagement (client, fee, supervisor), add students with their stipend and agreement, record supervisor sign-off, invoice (recorded as income) and pay stipends (recorded as expenses).

15. Projects, Placement, Certificates & Letters

Funded projects (NAVTTC / PSDF / TCF)

• Projects → Projects (NAVTTC/PSDF/TCF). Search finds a project by name, code or funding body, or by any student on it.
• Roster & completion on the project lists its students with their PSDF class and trainer codes (a missing code is shown as “not set”).
• Set each trainee enrolled, active, completed or dropped — one at a time, or tick several and save once. Marking a trainee completed makes them available in Placement Tracking.

Placement

Projects → Placement Tracking. A new placement needs the funding programme (PSDF, NAVTTC, TCF or Private) and can only be made for a student who has completed a course or a project. Search by student, registration number, company or job title; export any month or year to Excel.

Employers

Academics → Employers is the list of companies the academy is building for placements, with what skills they want. Its call list ranks companies nobody has researched yet and gives a form to record what the caller learned; it exports to CSV.

Certificates, letters and student projects

• Internship Certificates — issued as PDF and verifiable by anyone at /verify/<code>.
• Programme Letters — Participation, Completion and Practical Internship letters. Pick a batch and a student and the screen shows their evidence first. Completion and internship letters need at least 70% attendance and a recorded assessment; an internship letter also needs a verified student project. If a letter is not allowed, the reasons are shown instead of the button. Reissuing revokes the previous letter. Anyone can verify a letter at bvlogic.academy/verify-letter with its code.
• Student Projects — work students built, added by staff or submitted by the student. A teacher verifies or returns it for more work; only verified projects count toward internship letters.
• Completion Requests — approving one marks the course completed and closes the enrollment properly.

Certification Management

Teacher: Request Certification Accountant / Academy Head: Certification Register Fee exception: academy head

A course certificate is requested by the teacher, checked against the student's fees, and approved by the accountant or the academy head. Every step is kept in the request's history. The record of each student says whether certification is required at all (Certification Required on the profile, section 5).

1. The teacher requests (Request Certification)

1. Open Request Certification in the sidebar. Choose a class (All my classes or one batch code) and Completed the course or All on my classes, then Show. NAVTTC classes are not listed.
2. For a student who can be requested, add an optional note and click Request certification. The screen explains when it cannot: the course is not marked completed yet; Certification Required is No, or not recorded (ask the office to record it on the profile); a request already exists; or the student is not on a class you teach.
3. The accountant and the academy head get a bell, a push and an email. The fees are checked automatically at once.
4. A rejected request shows the reviewer's reason; write what changed and click Submit again. The same request goes back to Pending.

2. The register (Certification Register)

• Five count tiles, each a filter: All requests, Pending (pending or under review), Approved (not issued yet), Eligible (meets the NUTECH checks below), Completed (issued).
• Search by name, registration number or CNIC (five or more digits match the CNIC digits), and filter by approval status, fee clearance, course, batch and request dates. Filter and Clear.
• Exports: an Excel and a CSV link for each of the five sets. Each export uses the search and filters you set, then keeps its own set. The file is certification-set-date.xlsx or .csv with the thirteen register columns: Student Name, Student ID / Registration Number, CNIC, Course Name, Batch, Course Completion Status, Certification Required, Fee Clearance Status (with the amount when outstanding), Request Date, Approval Status, Approved By, Certification Issuance Status, Remarks. Every export is written to the activity log.
• Statuses: Pending, Under Review, Approved, Rejected, Issued. Fee clearance: Not checked yet, Cleared, Fees outstanding, Exception granted.

3. Reviewing one request

Click Open on a row. The left side shows the request and its history, the admission details (the CNIC is flagged when it is not 13 digits), the course, and the fee records: the amount outstanding, each enrolment's fee, paid and remaining, and the last instalments. The Decision card on the right offers:

1. Start review (a pending request): moves it to Under Review and checks the fees again.
2. Check fees again at any time; the result is shown and kept in the history.
3. Approve, with optional remarks. While fees are owed and no exception has been granted, the button is disabled and a red notice names the amount; the server refuses too. Approving emails the student that they are Eligible for Certification (subject: "BvLogic Academy: you are eligible for certification"), and the page records whether the email went, or why not (no address on file, a generated address, a refused address). The teacher gets a bell.
4. Reject, with a required reason, so the teacher knows what to fix. The teacher gets a bell.
5. Grant exception (academy head only, and only while fees are owed): write the reason (at least 5 characters). The request can then be approved while fees are outstanding, and the exception, its reason and who granted it stay on the record.
6. Mark issued on an approved request: the date (not in the future) and an optional note such as the certificate number. Issuing a course certificate from Internship Certificates for the same student and course marks the request Issued automatically.

NUTECH Applications

Projects → NUTECH Applications Needs: review-certification

Group eligible students into one application to NUTECH. Eligible here means the academy's own checks: the request is approved, fees are cleared or an exception was granted, the course is completed and the CNIC is 13 digits. These are not NUTECH's admission rules, which are not recorded in this system; check NUTECH's own criteria before submitting.

1. Under New application give a name (for example NUTECH November 2026), the application date and notes, then Create application. It starts as a Draft.
2. On the application page tick the eligible students under Add eligible students and click Add ticked students. Students can be added only while the application is a Draft. A student already on another application can be included again only with a reason, when that is allowed in the settings.
3. Set the application's status (Draft, Submitted, Accepted, Rejected) with Set; students still at the old status move with it. A student can be given their own status on their row.
4. Export Excel or Export CSV gives the register columns plus the NUTECH Application Status.

The index also has an Eligible students search showing which application each student is already on. Every addition and status change is written to the student's request history and the activity log. No email is sent from here.

Growth desk: ambassadors, experiments, outcomes, employer demand

Academics → Growth programmes manage-ambassadors · manage-experiments · manage-outcomes · manage-employer-demand

One sidebar entry opens the first desk your role may use; the desk's own menu has Campus ambassadors, Ambassador training, Ambassador board, CRO experiments, Graduate outcomes, Employer skills demand and the Demand report.

Campus ambassadors

• Students apply on the public page /campus-ambassador. The index lists them with a status filter (Waiting for approval, Approved, Suspended, Not approved), institution, city, referral code, leads and admissions.
• Open an ambassador, choose the status, write a note the applicant will see, and Save status. An approved ambassador is told their referral link is ready in their portal; other statuses are told the status.
• Commission: 20% of the net course fee (course fee minus discount; the registration fee does not count) of the referred student's first private enrolment, payable once that enrolment's fee status is paid. The ambassador page shows earned, payable, waiting, paid and balance. Money is not moved by the ERP: pay outside it and Record payout (amount, date, method, reference, note). The percentage is AMBASSADOR_COMMISSION_PERCENT; 0 switches commission off.
• Attribute a lead to an ambassador: lead number plus an approved ambassador. Refused when the lead already names one.
• Certificate of participation criteria (admissions, leads, days since approval): with nothing set, nobody is eligible.
• Ambassador training (post an item, publish or unpublish it) and the Ambassador board (post as the BvLogic team; Hide keeps a post on record).

CRO experiments

1. New experiment: name, hypothesis, the one element changed (title, call to action, price presentation, WhatsApp call to action, free-course offer, testimonial, project proof, curriculum presentation, payment option, urgency), the page path, the method (A/B split or before-and-after), variants A and B, the conversion measured (lead created, application started, WhatsApp click), dates. Save as draft.
2. Start it (only a draft, and only one live experiment per page). The results table shows visitors, converted and rate per variant.
3. End it, then Record decision: Keep A, Keep B, or Inconclusive, with why. The verdict needs at least 100 visitors per variant and 10 conversions in all.

Graduate outcomes (Outcome Evidence)

• Every day at 10:15 the system emails graduates an outcome form 3 and 6 months after completion ("How are things going since your BvLogic programme?"); the form link stays open 60 days. The cards show sent, opened and submitted, and the Learner Outcome Rate.
• Record an outcome from staff evidence: registration number, type (Got a job, Promotion, Freelance client, Launched a business, Job interview, Project completed), detail, date, verification (Self-reported, Staff-verified, Employer-verified), how it was checked, consent to show publicly. Each row can be re-verified with Save.
• The public page /verified-outcomes shows consented outcomes once there are at least ten.

Employer skills demand

Employers answer the public form /employer-skills-demand or the one in their Talent portal. Review each entry with Accept or Do not count and a note. The Demand report groups accepted answers by skill, role or city with employers, answers, salary from and up to (medians) and remote or hybrid.

Talent desk (BvLogic Talent)

Academics → BvLogic Talent Needs: manage-talent (academy head, placement officer)

• Employer accounts: employers register on the Talent portal and wait here as pending. Open one, choose Approve, Back to pending, Do not approve or Suspend, add a staff-only note and Save; the employer gets a bell notice. Only an approved account can hold an API key: name it and click Issue key; the key is shown once, so copy it then. Revoke ends it. The API log lists every verification call (employer, key, channel, code, result).
• Employer projects (Employer-Verified Projects): a task an employer sent arrives as Received. Write the brief (title, family, level, hours, summary, scenario, acceptance criteria, evidence to hand in, supervision, safety rule) and Save brief; Publish to eligible learners notifies the learners and the employer; Close or Do not take on. Review each learner's entry: criteria met, score, Reviewed or Return for more work, note, Save review.
• Introductions: an employer's request to be introduced to a learner. Mark introduced works once the learner has consented.

16. Support, Surveys & Gone Quiet

Support Desk

Students and staff can raise a support ticket (access, content, assessment, fees, facility or other) with a priority. Each gets a reference number and sees only their own tickets. Staff with support access work them in Finance → Support Desk: Open, Past SLA, Resolved and Closed tabs; reply, add an internal note the person never sees, assign, resolve (a resolution note is required) or close. The red badge counts tickets past their deadline. A reply from the person reopens a resolved ticket.

Support SLA shows, per priority, how many tickets met their deadlines, median times, and how many were never answered.

Surveys

Finance → Surveys. Create a survey for trainees or staff, optionally for one batch, with scale, single-choice, multiple-choice or text questions, and a close date. An anonymous survey stores nobody's identity with the answers, and cannot be switched to named once answers exist. Results stay hidden until a minimum number of people have answered (five unless you set otherwise), so nobody can be identified from a small group.

Gone Quiet

Finance → Gone Quiet lists active learners with no activity for 14 days — no class attended, no sign-in, no lesson opened and nothing handed in. Learners who have done nothing since enrolling are marked “never started”. It is checked every morning; each learner is flagged once per quiet spell, not every day, and drops off automatically when they come back. Record what you did (a call, a message) against each one. If more than half the academy looks quiet at once, nobody is flagged and the page explains why — that means the activity data is missing, not that everyone left.

Privacy choices

Students and staff record their own consent for research, sharing with funders and employers, marketing and photography on their privacy page. No record means no consent.

17. Approvals & Feedback

Approvals

HR & Payroll → Approvals is a queue for edits and deletions of sensitive records — students, enrolments, fee payments, income, expenses, payslips, salaries, refunds, scholarships, certificates and employees — decided by the academy head. Nobody can approve their own request, and the person who asked can withdraw it.

Send Feedback and the Feedback Inbox

Send Feedback is open to every member of staff: a suggestion, complaint, appreciation or anything else, sent to the CEO, with a Send anonymously box that stores no name. Only the CEO reads it, in the Feedback Inbox, and marks it read or actioned. Student Feedback is a separate screen for what students submit.

18. Report Center

Finance → Report Center holds around forty reports. Almost every one has Today / Week / Month / Year / specific-month / custom-range / all-time filters and exports to Excel.

• Attendance has a Batch filter (each batch listed with its course) alongside the period picker.
• LMS Activity has a period picker for the Instructor Activity table (classes, materials and announcements each teacher posted), separate from the “no activity in N days” box for inactive students. It has no Excel export.
• Fee Recovery can be filtered by intake year and by payment silence — never paid, or paid before but silent for 90+ days — and ages the debt by days since the last payment.

Reports that arrive by email

Some reports are emailed automatically to everyone whose role covers them: the Daily Management Summary at 08:00, the never-paid fees list on weekdays at 09:15, a placement digest on weekdays at 18:00, and a weekly activity-log digest to the CEO on Mondays. If your email address bounces, you will not receive them — see “No mailbox” in section 2.

Research authority: referring domains

Report Center → Research Authority Needs: view-reports

A log of the sites that link to BvLogic's research pages, counted against the authority target of 100 referring domains.

• Log a referring domain: the domain or a link on it, our page it links to (/research/...), the page that links, first seen, the source of the data (required), a Quality link tick and notes. Duplicates are refused.
• Import a backlink export (CSV) from a backlink tool (up to 5 MB) with where it came from and its date. Imported rows are never marked quality until someone reviews them.
• Filter All, Quality or Not reviewed. On each row choose Quality or Not quality, say why (required) and Save.

SEO maintenance

Report Center → SEO Maintenance Needs: view-reports

A read-only monthly report built on the 4th at 07:30 for the month before: search queries, positions 4 to 20 (opportunities), possible cannibalisation (two pages for one query), content decay (clicks fell from the month before), indexation, internal links, broken pages, schema, Core Web Vitals and referring domains. A section whose source is not connected says Not collected with the reason. Choose the month; the buttons open the weekly SEO audit and the referring domains log.

19. 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.

20. Management screens

For the CEO and management (in the Finance part of the sidebar):

The CEO's phone has its own dashboard too (section 21).

The revenue pages (from CEO Growth)

Finance → CEO Growth → Revenue Command Center · Free-to-paid funnel · Weekly numbers · Unit economics · Revenue per 1,000 visitors Needs: view-ceo-reports

Every page except Weekly has the same period picker: This month, Last month, Last 30 days, Last 90 days or custom dates, then Apply. A button row on each page jumps between them.

• Revenue Command Center: one row per paid programme: page visitors, leads, admissions, revenue, lead-to-admission, completion rate, upsell, and an action badge (Scale, Optimize, Fix or kill, Grow demand, Not enough data) with the rule printed under the table. Click a column title to rank by it. Hero programmes carry a Hero badge. The CAC column shows "not enough data" until spend is entered per channel.
• Free-to-paid funnel: the stages from a free course started, through career test, enquiry, counselling, application, admission and payment, to Skill Passport, verified project, graded assessment and career outcome, with the step from each stage to the next and a Weakest step badge. Filter by channel. The stage "Recommended programme viewed" is not tracked and says so.
• Weekly KPI, the twelve numbers: pick a day, click Show that week; Monday to Sunday against the week before: website visitors, free learners, qualified leads, AI counsellor conversations, applications, paid admissions, revenue, CAC, lead to admission, course completion, project completion, and learners at Job Ready or Professional. Plus the Learner Outcome Rate.
• Unit economics: per channel: spend, admitted, CAC, revenue per student, LTV, LTV/CAC and payback. Spend comes from Marketing Spend.
• Revenue per 1,000 visitors: course fees paid (NAVTTC left out), memberships and signed organisation contracts, by month and by the channel of the first visit.
• Sales team: the counsellor report (section 12).

The five CEO numbers and the Skills Score levels

CEO Reports → the five cards: Acquisition, Sales, Revenue, Education, Outcomes

Each card opens its own page (/ceo/numbers/education and so on). The Education page shows programme completions in the period, the completion rate of private batches that ended, project success, and the line Learners with at least one skill at Job Ready or above (Skills Score 60+) · at Professional or above (75+), counted today from the latest Skills Score snapshot, not for the dates chosen.

Scores are rounded, so 59.5 counts as Job Ready. The snapshots are written every night at 02:40; the same count feeds the Weekly KPI's twelfth number.

Media Calendar and the media mix

Finance → Media Calendar → Mix and post log Needs: view-ceo-reports

• Media Calendar: the queue of posts ready to be made from published research reports, monthly briefs, salary updates and Skills Index months, for LinkedIn, Facebook, the WhatsApp channel and YouTube. For each, Open the page, post it yourself, paste the link to the live post and click Mark posted. Nothing is posted to any network by the ERP. Choose how many months to show (1 to 24).
• Media mix: pick a month to see the mix of posts against the target of 60% education, 20% research, 10% outcomes and 10% programmes. Use Log a post made outside the calendar (date, channel, category, what the post was, link, note, then Log post); logged posts are never deleted. When programme posts go above the 10% limit the page says so and asks for education, research or outcomes before the next programme post.

Demand Meeting Pack

Finance → Demand Meeting Pack Needs: view-ceo-reports

Choose a month. The pack has six parts: skills by demand (open postings), skills not measured by any permitted source, salary movement (entry band, PKR a month), employer demand, open curriculum signals, and recommended curriculum changes. CSV downloads it (demand-meeting-pack-month.csv); Print prints it.

Help Questions

Finance → Help Questions Needs: view-ceo-reports

What staff asked the Help button in the last 7, 30, 90 or 365 days: how many were answered from the manual, how many it did not know, thumbs up and down, and how many were phrased by the AI. Top unanswered questions groups the questions nothing matched, most asked first: each is a place this manual should grow. Below it, the answers marked not helpful with the sections they were built from, and every question with its result. The assistant re-reads the manual every night at 03:10, or at once with php artisan help:index.

21. 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 — staff download

1. On the phone, open https://codexla.com/app-install.html and tap Download for Android.
2. Open the downloaded file. Android asks to allow installing from this source — allow it, go back and tap Install.
3. Open BvLogic Academy and sign in with your own email and password.

Or, in Chrome: open /app, sign in, then Menu (⋮) → Install app or Add to Home screen.

iPhone and iPad — the order matters

1. Open the address in Safari. This does not work in Chrome on iPhone — the install page tells you if you are in the wrong browser.
2. Share button → Add to Home Screen → Add.
3. Close Safari, open the new BvLogic icon, and sign in there.

The app asks for the camera (to scan QR codes) and location (to confirm you are on campus) the first time you use attendance. Both are needed.

What you get, by role

The home screen shows only tiles you can actually open.

Notifications are pushed to your phone for announcements, new classes and alerts — allow notifications when asked.

22. Student & Parent portals

Students and parents sign in at https://bvlogic.academy/login. Every student gets a login when they are registered (section 5).

Students can

• See courses, progress, attendance percentage and fees on their dashboard
• See attendance — present, absent, late and leave
• Join online classes (which marks their attendance), and watch recordings
• Download materials, submit assignments — and resubmit until graded, with earlier versions kept
• Take online exams and see results
• See fees, payment history and upload a payment receipt
• Apply for leave, withdraw a pending request and track the decision
• Read announcements, use the discussion board, submit their own projects, download certificates, give feedback
• Raise a support ticket, answer surveys, and set their privacy choices
• Take Free Academy courses and see them under My learning (section 10)

Parents can

See each linked child's attendance percentage, fees paid and outstanding, enrolments, and exam results, read-only. Staff who can edit students create a parent's access from the student's record.

23. Step-by-step workflows

A walk-in enrolls today

1. Log the enquiry under Leads (skip if they enroll immediately).
2. Students → Register Student — fill details (phone, city), choose course, batch and fee, answer “Who brought this student in?”, enter the registration fee, save.
3. Fee Collection — search the student, record the course payment received.
4. Print the fee slip and hand it over. If they have no email, show them the QR on it to set up the app.

Registering a funded (NAVTTC / PSDF) trainee

1. Students → Register Student — choose the project under Funded Project, the course and the batch.
2. Enter a registration fee of 0 and save. They count as joined and get an app login.
3. Check the roster under Projects → the project → Roster & completion.

Running an online class

1. LMS — schedule the class on Google Meet or Zoom; the link is created and students are notified.
2. Upload the material for the session.
3. Students click Join at class time; their attendance is recorded automatically.
4. After the class, set it Completed, add the recording link and set an assignment if needed.

A class has to be called off

1. Open the class page → Session Controls → Cancel this class. Students see it as cancelled.
2. Schedule the replacement as a new class; students are notified of it.

A student says they already paid

1. Ask them to upload the receipt from their portal, or take it at the counter.
2. Payment Proofs — open it, check the receipt against the bank.
3. Verify to record the payment, or reject with the reason.

A member of staff forgot to clock in

1. Staff Attendance → Record attendance (if you have that permission).
2. Pick the date, set them Present with their times, and save.

Month end

1. Report Center → Fee Collection — what came in.
2. Fee Recovery and Pending Students — what is still outstanding and how old.
3. Daily Cash Flow and Financial — cash and P&L.
4. Reconciliation — confirm no money is unaccounted for.
5. Payroll — run payroll and issue payslips.

24. 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.

1. Are you on your own login? A shared admin account shows a different menu from yours. Sign in as yourself.
2. Does your role include it? Check sections 3 and 4. The sidebar hides what your role cannot use.
3. 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.
4. Is it under a different name? See the table below.

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.

25. Known limits right now

Added in version 1.4

• NUTECH eligibility is the academy's own four checks, not NUTECH's admission rules, which are not in the system.
• Course outline "viewed" means the module was opened, not studied or completed.
• Assign Another Course creates the enrolment and its fee, but not an instalment plan; set one from Fee Details.
• students:validation-report and students:normalize-cnic are run by hand; nothing schedules them.
• On the Revenue Command Center the CAC column shows "not enough data"; in the Free-to-paid funnel the stage "Recommended programme viewed" is not tracked.
• Orientations send no email; the joining details are a counsellor's WhatsApp follow-up.
• Ambassador commission is calculated and shown; payouts are made outside the ERP and recorded here.
• The Help button answers only from this manual and the guides. If a page is not described here, it will say it does not know; tell the CEO (Help Questions) so the section can be written.