# DIGISTREET Monitor — A modern HR + productivity workspace

URL: https://monitor.digistreet-media.com/
Tagline: The work happens in plain sight — and that's a good thing.
Built for: Marketing & creative teams
Operator: DIGISTREET MEDIA (a marketing and communications agency)

DIGISTREET Monitor is the daily workspace for your team. It unifies attendance, leaves, payroll, task tracking, daily output logging, and lightweight desktop monitoring into one product. The aim: stop bouncing between five different SaaS tools and instead handle the full employee lifecycle — from joining to payday — in one place.

The platform is mobile-friendly, supports role-aware navigation (Employee / Manager / HR / Admin), and has both a web app and an optional Windows + macOS desktop monitoring agent.

## Stats at a glance

- 9 core modules out of the box
- 3 distinct roles (plus Admin)
- 217+ contextual welcome messages (time-aware, name-personalised, caring)
- 100% mobile native
- Hosted on Hostinger shared infra; Vanilla PHP 8 + MySQL; no external SaaS dependencies for core HR data

## Core features

### Smart Attendance
Clock in / out from the web or the desktop agent. Every clock event captures:
- GPS coordinates (browser geolocation API)
- IP address (server-side)
- Device fingerprint (canvas + UA + screen + timezone hash)
- Persistent device token in localStorage

This combination locks attendance to a specific employee on a specific device. Clocking in from a colleague's machine is blocked with a "device ownership mismatch" error. HR maintains a Device Registry where they can trust, untrust, or block specific devices.

Multi-session days are handled cleanly — the first clock-in is preserved as the "morning" time, and each subsequent clock-in updates the "current session" pointer while accumulating total work seconds across the day.

Work hours validation is enforced: clock-in is blocked before 5 AM and after 11:30 PM, with soft warnings for clock-in more than an hour before scheduled start or more than two hours after scheduled end.

### Leaves Made Simple
Three modes:
- **Full day(s)**: Date range with AM/PM session selection
- **Half day**: Single date with AM (first half) or PM (second half) choice
- **Short leave**: 1–4 hour block with start/end time, computed as fractional days

Auto-routes to manager + HR with one-click approve/reject email links (tokenised, 72-hour TTL, single-use). HR can grant Earned Leave (EL) credits for weekend work or exceptional delivery — directly bumps the employee's balance with full audit history.

Leave types: Privilege Leave (PL), Sick Leave (SL), Casual Leave (CL), Work From Home (WFH), Comp Off (COF), Loss of Pay (LOP), Earned Leave (EL), Short Leave (SHRT).

### Tasks & Delivery
Managers, HR, or admins assign tasks with:
- Title and description
- Priority (low / normal / high / urgent)
- Due date (locked once set — assignee cannot modify)
- Client / brand tag (linked to the work clients master list)

Employees toggle status through open → in_progress → done. A month-end performance scorecard auto-computes:
- On-time completions
- Late completions
- Currently overdue
- In progress
- Cancelled
- Score = (on_time × 1.0 + late × 0.5 + done_no_due × 1.0) / (total − cancelled) × 100
- Grade: A+ (≥90), A (≥80), B (≥70), C (≥60), D (≥50), F (<50)

Employees see their own report card on /hr/me. Managers see all reports' scorecards sorted by score on /manager.

### Task Delegation
If an assignee is on leave or otherwise unavailable, they can request a handoff:
1. Pick a teammate to take over
2. Provide a 10+ character reason
3. Submit — status becomes "handoff pending"
4. Manager (their direct manager) or HR approves
5. Task automatically re-assigns to the new person; deadline unchanged

The original assigner, the current assignee, and the proposed new assignee are all notified by email. Audit log records every step.

### Daily Work Output
Employees log tangible counts of what they actually shipped each day:
- "5 reels for Demo Client A"
- "100 SEO submissions for Internal"
- "3 carousels for Wellness brand"

33+ pre-seeded categories across departments (Creative, Content, Digital Marketing, Social Media Team, Client Servicing, Tech), each tied to a default unit (count). Aggregations by user, category, client, and date are available to managers and HR.

A task notification panel on /work shows the employee what they should be working on (open + in-progress tasks with priority dots and brand tags) right above the log form — so they can match their output to assigned work.

### Salary & Payroll (Indian-format)
Per-employee salary structure stored in `employee_salaries`:
- Monthly gross (the basis)
- Basic % of gross (default 50%)
- HRA % of basic (default 40%)
- Conveyance allowance flat amount (default ₹1600/month)
- Medical allowance flat amount (default ₹1250/month)
- PF applicable flag (default true; 12% of basic, capped at ₹1800/month)
- Professional tax (default ₹200/month)

Auto-calculated on payroll generation. Every component is pro-rated by attendance ratio (present + paid leave days / working days). Special allowance auto-balances to keep total earnings consistent with the pro-rated gross.

Payslip shows full breakdown:
- Earnings: Basic, HRA, Conveyance, Medical, Special Allowance, Gross
- Deductions: PF, Professional Tax, TDS, Total
- Attendance summary: working days, present, paid leaves, unpaid days
- Net payable in figures + words (Indian lakhs/crores)
- Branded company header, signature lines, print-as-PDF support

### Bank Transfer Sheet
End of each month, HR generates a bank-disbursement file in two formats:
- **Printable HTML PDF**: Branded document with employee name, account, IFSC, PAN, net amount, total to disburse, and signature lines — for internal records.
- **CSV**: Generic Beneficiary Name / Account / IFSC / Amount / Bank / PAN / Remarks / Email format compatible with HDFC, ICICI, and SBI bulk-upload templates.

Missing bank details are highlighted in red on the sheet and listed at the top so HR can chase them.

### Manager Dashboard
Custom landing for users with `role = manager`:
- Team snapshot strip (present / not in / on leave / today's work output)
- Pending leave approvals with one-click decide
- Team today list with attendance status badges
- Team work output rollup (last 7 days)
- Productivity scores for each direct report
- Top performers + Needs-a-nudge sections
- "Tasks I assigned" panel with status badges
- "Tasks for me" personal widget
- Team task report card (monthly grades A+ to F per report)

Sub-pages: My Team (per-report cards), Team Work Output (full drill-down with filters), Team Attendance (monthly muster grid).

### HR Modules
- **Employee directory** with bank, PAN, documents, manager assignment
- **Bulk CSV upload** with two-step preview → commit, validation per row
- **Self-registration approvals** with email notification to HR
- **Salary management** with breakdown editor
- **Payroll generation** with auto-calc from attendance + leaves
- **People Ops**: Warnings (verbal / written / final), Offer Letters with accept/decline links, Resignations workflow (employee submits, HR decides), Terminations
- **Earned-leave grants** for rewarding weekend work
- **Device Registry** for managing per-user device trust
- **Documents & Policies** library (NDA, Remote Monitoring Consent, Handbook, etc.) with required-acknowledgment tracking

### Self-Registration
New employees who aren't pre-created by HR can sign up at /register. The form collects:
1. Basic: name, email, phone, DOB
2. Work: job title, team, address, PAN
3. Bank: bank name, account number, IFSC, account holder
4. Documents (optional): ID proof, address proof, PAN card, photo, resume
5. Password (min 8 chars)

Account is created with `status = pending_approval`. HR receives a branded email and sees the registration in a yellow banner on /hr/employees. One-click Approve activates the account and sends a welcome email. Reject deletes the row.

### Company Documents
HR uploads PDFs (or images) for:
- Non-Disclosure Agreement
- Remote Monitoring Consent letter
- Employee Handbook
- Code of Conduct
- Leave Policy
- Offer Letter Template
- Other

Each can be marked "required". Required + un-acknowledged documents trigger a banner on /policies until the employee marks them as read (timestamped + IP-logged).

### Time-aware welcome messages
On /hr/me and /my, every page load shows a contextual greeting based on hour-of-day:
- 5–9: Early morning — breakfast nudges, gentle starts
- 9–12: Morning — focus tips
- 12–14: Lunch — eat, hydrate, walk
- 14–17: Afternoon — post-lunch dip awareness
- 17–20: Evening — wrap-up rituals
- 20–22: Dinner — "did you eat?" caring tone
- 22–24: Night — sleep is the cheat code
- 0–5: Late night — please rest

Each band has 10–15 quotes mixed across motivational, health, work-life balance, and quirky tones. Name is interpolated via `%s` placeholder.

## Custom Rank Titles
The system replaces the generic role label ("Employee") with a custom rank title that HR sets per-employee. Examples:
- "Editing Star" for video editors
- "Design Wizard" for senior designers
- "Reel Maestro" for short-form video specialists
- "People Strategist" for HR managers
- "Design Captain" for design team leads

Displayed in the topbar, profile, task delegation candidate list, and elsewhere. Falls back to job title, then role.

## Technical stack
- PHP 8.3, vanilla MVC (custom Router + Database + Auth + Email classes)
- MySQL / MariaDB with utf8mb4
- Front-controller pattern (public/index.php + .htaccess)
- Session auth + RBAC (admin / hr / employee / manager), CSRF tokens
- Electron desktop agent (active-win, powerMonitor, desktopCapturer, electron-builder)
- macOS ad-hoc code signing via afterPack hook
- GitHub Actions for Windows builds
- Chart.js 4.4.0 (CDN) for dashboards
- Resend API for transactional emails (welcome, leave, warnings, offers, tasks, handoffs)
- CSS Grid bento layout (12-column responsive)
- Mobile-first design with fullscreen menu + bottom tab bar
- Browser device fingerprinting (canvas + UA + screen + timezone + persistent token)

## Brand
- Company: DIGISTREET MEDIA
- Tagline: THE MARCOM CO.
- Primary colors: Black (#0a0a0a / #141414), Yellow (#ffd400 / #fbbf24)
- Logo: Stylized "DIGI**S**TREET" with the "S" rendered as a road graphic with arrows

## Who is this for
DIGISTREET Monitor was built first for DIGISTREET MEDIA's own team but is offered as a productized workspace for similar small-to-mid creative and marketing agencies (10–200 employees) looking for:
- A single tool to replace HRMS + payroll + task tracker + light monitoring
- Indian-format payroll built in (Basic / HRA / PF / Professional Tax)
- Mobile-first design that works for distributed teams
- Anti-fraud attendance (geo + device binding)
- Lightweight, privacy-respecting desktop monitoring (optional)

## Credits
Crafted by DIGISTREET MEDIA — Web Application Development:
https://digistreetmedia.com/services/web-application-development/