@adminide-stack/clock-tik-browser 12.0.19 → 12.0.22-alpha.1

package/lib/templates/content/docs/hrm/onboarding.md

@@ -0,0 +1,115 @@
+---
+id: hrm-onboarding
+title: Onboarding
+sidebar_label: Onboarding
+---
+
+## Onboarding
+
+The **Onboarding** module (`HRM > Onboarding`) lets you create structured onboarding workflows for both candidates and employees. Navigate to `/hrm/onboarding` to access it.
+
+![Onboarding Flows](/static/img/hrm/onboarding-main.png)
+
+---
+
+### Onboarding Flows
+
+The main Onboarding page displays two flow types:
+
+#### Candidate Onboarding
+
+For new hires who have not yet officially joined the organization:
+
+- **Flow** — Define the step-by-step onboarding flow (e.g., document collection, background checks, offer letter acceptance)
+- **Preferences** — Configure onboarding settings and preferences for the candidate workflow
+
+#### Employee Onboarding
+
+For existing employees joining new teams or roles:
+
+- **Flow** — Define the onboarding steps (e.g., team introductions, system access setup, training schedule)
+- **Preferences** — Configure onboarding preferences for the employee workflow
+
+---
+
+### Onboarding Sub-menus
+
+When expanded, the Onboarding section in the sidebar reveals three additional pages:
+
+---
+
+### Candidates
+
+![Candidates Page](/static/img/hrm/onboarding-candidates.png)
+
+Manage your organization's candidates in one place.
+
+**Adding a Candidate:**
+
+1. Navigate to **HRM > Onboarding > Candidates**
+2. Click **Add Candidate**
+3. Fill in the candidate's details
+
+**Filter candidates by status:**
+
+| Status | Description |
+|--------|-------------|
+| All Candidates | View all candidates regardless of status |
+| Pending | Candidates awaiting initial processing |
+| In Progress | Candidates currently going through onboarding |
+| Completed Onboarding | Candidates who finished the onboarding process |
+| Converted to Employee | Candidates who have been officially hired |
+
+The page shows a count (e.g., "0 of 0 candidates") and provides an empty-state prompt to add your first candidate.
+
+---
+
+### Onboarding Instances
+
+![Onboarding Instances](/static/img/hrm/onboarding-instances.png)
+
+Track and manage active onboarding processes.
+
+**Starting an Onboarding:**
+
+1. Navigate to **HRM > Onboarding > Onboarding Instances**
+2. Click **Start Onboarding**
+3. Select the candidate/employee and the onboarding flow to use
+
+**Filter by status:**
+
+| Status | Description |
+|--------|-------------|
+| All Statuses | View all onboarding instances |
+| Pending Offer | Offer letter sent, awaiting acceptance |
+| Pending Contract | Contract pending signature |
+| In Progress | Onboarding actively underway |
+| Completed | Onboarding finished successfully |
+| Cancelled | Onboarding was cancelled |
+
+---
+
+### Onboarding Tasks
+
+![Onboarding Tasks](/static/img/hrm/onboarding-tasks.png)
+
+Manage individual tasks within onboarding flows across all instances.
+
+**Creating a Task:**
+
+1. Navigate to **HRM > Onboarding > Onboarding Tasks**
+2. Click **Create Task**
+3. Define the task details, assignments, and due dates
+
+**Task Statistics:**
+
+| Metric | Description |
+|--------|-------------|
+| Total Tasks | All onboarding tasks created |
+| Pending | Tasks not yet started |
+| In Progress | Tasks currently being worked on |
+| Completed | Tasks finished |
+| Blocked | Tasks blocked by dependencies or issues |
+| Overdue | Tasks past their due date |
+
+Use **Filters** to narrow down the task list by status, assignee, or onboarding instance.

package/lib/templates/content/docs/hrm/settings.md

@@ -0,0 +1,158 @@
+---
+id: hrm-settings
+title: HRM Settings
+sidebar_label: Settings
+---
+
+## HRM Settings
+
+**HRM Settings** (`HRM > Settings`) allows administrators to configure module-level permissions and access controls for the entire HRM module. Navigate to `/hrm/settings` to access it.
+
+The Settings section has two sub-items in the sidebar:
+
+- **Permissions** — Role-based permission configuration
+- **User Access Control** — Individual user access management
+
+---
+
+## Permissions
+
+Navigate to **HRM > Settings > Permissions** (`/hrm/settings/permissions`) for the full role-based permission configuration.
+
+![HRM Permissions](/static/img/hrm/settings-permissions.png)
+
+### Role Selection
+
+Select a role from the dropdown to configure its permissions. Available roles include:
+
+| Role | Description |
+|------|-------------|
+| **HR Director** | Full HR management access with strategic oversight |
+| **HR Manager** | Day-to-day HR operations and team management |
+| **Tech Lead** | Technical team leadership with limited HR access |
+| **Team Manager** | Direct team management and performance oversight |
+| **Department Head** | Department-level management and budgeting |
+| **Vice President** | Executive-level access with strategic HR oversight |
+| **Recruiter** | Recruitment and candidate management access |
+| **Payroll Admin** | Payroll processing and compensation management |
+| **Training Coordinator** | Training programs and employee development |
+| **Compliance Officer** | HR compliance, audits, and policy enforcement |
+
+### Permission Categories
+
+Each role has toggleable permissions organized into these categories:
+
+#### Employee Management
+
+Control what the selected role can do with employee records:
+
+- View other employees
+- Create employees
+- Edit other employees
+- Delete employees
+- Manage employees
+- View own profile
+- Edit own profile
+
+#### Recruitment & Candidates
+
+Manage the recruitment pipeline:
+
+- View / Create / Edit / Delete candidates
+- View / Create / Edit / Publish job postings
+
+#### Departments
+
+Manage organizational departments:
+
+- View / Create / Edit / Delete departments
+- Manage departments
+
+#### Onboarding
+
+Manage employee onboarding:
+
+- View / Create / Edit / Delete onboarding flows
+- View others' onboarding
+- Start onboarding for others
+- View / Create / Assign onboarding tasks
+
+#### Performance Management
+
+Manage reviews and goals:
+
+- View / Create / Edit / Approve others' performance reviews
+- View own performance / Submit self-assessment
+- View / Create / Approve others' goals
+- View / Create own goals
+
+#### Training & Learning
+
+Manage training programs:
+
+- View / Create / Edit training courses
+- View / Enroll others in training
+- View own enrollments
+
+#### Attendance & Schedule
+
+Manage attendance:
+
+- View / Edit / Approve others' attendance
+- View / Mark own attendance
+- View / Create others' schedules
+- View own schedule
+
+#### Payroll & Compensation
+
+Access payroll data:
+
+- View / Edit / Process / Approve others' payroll
+- View own payroll
+- View / Edit others' compensation
+- View own compensation
+
+#### Documents
+
+Manage employee documents:
+
+- View / Upload / Delete others' documents
+- View / Upload own documents
+
+#### Agreements & Contracts
+
+Manage employment agreements:
+
+- View / Create / Edit / Delete agreements
+- Send for signature
+- Sign agreements
+
+#### Travel
+
+Manage travel workflows:
+
+- View / Create others' travel
+- Approve travel requests
+- View own travel / Request travel
+
+#### Settings & Administration
+
+Access HRM settings:
+
+- View / Edit / Manage HRM settings
+- View / Export HRM reports
+- View / Create / Edit workflows
+
+---
+
+## User Access Control
+
+Navigate to **HRM > Settings > User Access Control** to manage access at the individual user level.
+
+![User Access Control](/static/img/hrm/settings-user-access.png)
+
+User Access Control allows you to:
+
+- Grant or restrict specific users' access to HRM features beyond their role defaults
+- Override role-based permissions for individual users when needed
+- Manage access to sensitive HR data on a per-user basis

package/lib/templates/content/docs/hrm/travel.md

@@ -0,0 +1,94 @@
+---
+id: hrm-travel
+title: Travel Management
+sidebar_label: Travel
+---
+
+## Travel Management
+
+The **Travel Management** module (`HRM > Travel`) handles business travel requests and expense claims. Navigate to `/hrm/travel` to access it.
+
+![Travel Management](/static/img/hrm/hrm-travel.png)
+
+---
+
+### Overview
+
+The Travel Management page lets employees submit travel requests and expenses, and gives managers visibility into team travel.
+
+**Description:** Manage travel requests and expenses for your organization.
+
+---
+
+### Request Statistics
+
+The page displays summary cards at the top:
+
+| Stat | Description |
+|------|-------------|
+| **Total Requests** | All travel requests submitted |
+| **Pending Approval** | Requests awaiting manager / HR approval |
+| **Approved** | Requests that have been approved |
+| **Rejected** | Requests that have been denied |
+
+---
+
+### Search & Filter
+
+Use the search bar to find requests by:
+- Request ID
+- Employee name
+- Purpose of visit
+- Location / destination
+
+---
+
+### Creating a Travel Request
+
+Click **New Request** to open the dropdown with two options:
+
+#### Travel Request
+
+![Travel Request Form](/static/img/hrm/travel-request-form.png)
+
+Submit a request for business travel with these fields:
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| Employee ID | Yes | Select the employee (from dropdown) |
+| Employee Department | Auto | Auto-filled based on selected employee |
+| Purpose of Visit | Yes | Why the travel is needed (e.g., "Client Meeting", "Conference") |
+| Place of Visit | Yes | Destination (e.g., "New York", "London") |
+| Departure Date | Yes | Travel start date |
+| Arrival Date | Yes | Travel end date |
+| Expected duration in days | No | Estimated number of days |
+| Mode of Travel | No | Transportation mode (e.g., "Flight", "Train", "Car") |
+| Billable to Customer | No | Checkbox — whether travel costs are billed to a customer |
+| Description / Notes | No | Additional context or details |
+
+**To submit:**
+1. Navigate to **HRM > Travel**
+2. Click **New Request > Travel Request**
+3. Fill in the required fields
+4. Click **Submit Request**
+
+#### Travel Expense
+
+Submit expenses incurred during approved travel:
+
+1. Click **New Request > Travel Expense**
+2. Link to an existing approved travel request
+3. Add expense details (amount, category, receipts)
+4. Submit for reimbursement
+
+---
+
+### Approval Workflow
+
+1. **Employee** submits a travel request
+2. **Reporting Manager** reviews and approves/rejects
+3. **HR / Admin** provides final approval if required
+4. Employee is notified of the decision
+5. After travel, employee submits **Travel Expense** for reimbursement
+
+> Pending travel requests appear in the **HR Dashboard > Pending Travels** tab for administrators.

package/lib/templates/content/docs/timer/timetracking-main.md

@@ -0,0 +1,65 @@
+---
+id: timetracking-main
+title: Time Tracking
+sidebar_label: Time tracking
+---
+
+## Tracking time using timer
+
+In Clockbook, there are two main ways you can add time entries: automatic (use a start-and-stop timer) and manual (add a complete time entry).
+
+The Timer page features a full control bar with **START**, **PAUSE**, **STOP**, and **Discard** buttons, along with project selection, tags, and billable toggles. You can also filter entries by date range and view your **Current Week** summary.
+
+![Timer Page](/static/img/timer/timer-page-overview.png)
+
+[ _Read More_ ](/docs/timetracking)
+
+---
+
+## Adding time manually
+
+If you forgot to start the timer, or you prefer to fill in all your work hours in one go, use manual mode to add time entries one by one with custom start and end times.
+
+---
+
+## Entering time in timesheet
+
+See all your time entries in a Timesheet view and add time more quickly. The Timesheet lets you fill time by project/task for each day of the week.
+
+---
+
+## Calendar view
+
+See all your tracked time in a Calendar view so you can: see how your day looks at a glance and notice work patterns, see if you have gaps where you forgot to log time, and see if you have overlapping entries.
+
+---
+
+## Editing time entries
+
+You can edit any time entry directly in your timesheet on the Time Tracker page by clicking on it. Change descriptions, projects, tasks, tags, billable status, start/end times, and duration.
+
+---
+
+## Time categorization and tags
+
+Organize time entries with a 4-level hierarchy: descriptions, tasks, projects, and clients. Further categorize entries using tags for flexible filtering and reporting.
+
+---
+
+## Idle detection, Pomodoro, and reminders
+
+Track time with greater accuracy with the help of time tracking reminders, automatic clock-out, and idle detection.
+
+---
+
+## Integrations
+
+Start Clockbook timer from within other web tools, like Jira, Trello, Asana, Gitlab, Basecamp, Github, Google Calendar, Xero, and more.
+
+---
+
+## Jira integration
+
+Our free Jira app enables you to track time on issues directly from Atlassian Jira with just one click. Clockbook plugin for Jira is available in the Jira web app, Jira mobile app for Android and iOS, as well as Jira macOS desktop app.
+
+---

package/lib/templates/content/docs/{timetracking.md → timer/timetracking.md}

@@ -18,18 +18,109 @@ You can track using any app and all data is synced online, so all your tracked d
 
 ### Tracking time from the web browser
 
-- Enter timer mode by clicking the clock icon in the upper left corner on the Time Tracker page.
-- Optionally type what you're working on in the "What are you working on?" box
-- Optionally, mark time as billable, select project/task, and add tags.
-- Start the timer by clicking START button.
-- When you finish working, stop the timer by clicking STOP button.
+The Timer page is the main place for time tracking. Navigate to **Time Tracker > Timer** in the sidebar to access it.
+
+![Timer Page Overview](/static/img/timer/timer-page-overview.png)
+
+The timer bar at the top contains the following elements:
+
+- **Description field** — Type what you're working on in the "What are you working on?" input field
+- **Project selector** — Click the **Projects** button to assign a project to your time entry
+- **Tags toggle** — Click the tag icon to add tags to your time entry
+- **Billable toggle ($)** — Click the dollar sign to mark the time entry as billable or non-billable
+- **Duration display** — Shows the elapsed time (e.g., 00:00:00) for the running timer
+- **START button** — Click to start the timer
+
+To track time:
 
-![img](/static/img/timer-mode-new2.jpg)
+1. Optionally type what you're working on in the "What are you working on?" box.
+2. Optionally, mark time as billable, select a project/task, and add tags.
+3. Click the **START** button to begin tracking.
+
+![Timer with description](/static/img/timer/timer-with-description.png)
+
+Once the timer is running, the following controls become available:
+
+- **PAUSE** — Temporarily pause the timer without stopping it. Click again to resume.
+- **STOP** — Stop the timer and save the time entry to your timesheet.
+- **Discard** — Cancel and discard the running timer without saving.
+
+![Timer running with controls](/static/img/timer/timer-running-controls.png)
 
 Note that once you start the timer, it will keep running until you stop it; it will keep running even if you leave the page or close the browser (unless you use the extension and have the option to stop it automatically).
 
 When the timer is running, the favicon in the browser will change from black to blue so you have a visual cue to see if you maybe forgot to start or stop the timer. Also, Clockbook will display how long the timer is running in the tab.
 
+### Pausing the timer
+
+If you need to take a break but don't want to stop the timer entirely, use the **PAUSE** button. The timer will stop counting, and you can resume it later by clicking **PAUSE** again or clicking the resume control.
+
+![Timer paused](/static/img/timer/timer-paused.png)
+
+This is especially useful when:
+- You're taking a short break but will continue the same task
+- You need to step away from the computer briefly
+- You want to pause without creating a new time entry
+
+### Discarding a timer
+
+If you accidentally started a timer or no longer need the tracked time, click the **Discard** button (trash icon) to cancel the timer without saving any time entry.
+
+### Date range filter
+
+At the top of the Timer page, you'll find a **date range filter** with Start Date and End Date inputs. This lets you filter which time entries are displayed in the list below.
+
+- Set the **Start Date** and **End Date** to filter entries within a specific period
+- Click **Reset** to clear the date filter and return to the default view
+- By default, the timer page shows entries for the current month
+
+### Current Week summary
+
+Below the timer bar, the **Current Week** section shows a summary of time tracked for the current week, helping you quickly see your weekly totals at a glance.
+
+### Time entries list
+
+Below the timer bar and weekly summary, your time entries are displayed grouped by day. Each entry shows:
+
+- **Description** — What you worked on
+- **Project** — The assigned project
+- **Billable status ($)** — Whether the entry is billable
+- **Duration** — Total time for the entry
+- **Start and end times** — When you started and stopped (e.g., 08:11:50 AM — 08:11:59 AM)
+- **Daily total** — The total time tracked for each day
+
+![Timer entries list](/static/img/timer/timer-entries-list.png)
+
+### Selecting a project
+
+Click the **Projects** button in the timer bar to open the project dropdown. You can:
+
+- Search for projects by name or creator using the search field
+- Select a project from the list to assign it to the current time entry
+- Change the project on an existing entry by clicking the project name
+
+![Project dropdown](/static/img/timer/timer-project-dropdown.png)
+
+If no projects have been created yet, the dropdown will show "No projects available". To create projects, go to **Projects** in the sidebar.
+
+### Adding tags
+
+Click the **tag icon** (Toggle Tags button) next to the Projects button to add tags to your time entry.
+
+![Tags dropdown](/static/img/timer/timer-tags-dropdown.png)
+
+Tags help you further categorize time entries beyond projects and tasks. If no tags are available, go to **Tags** in the sidebar to create them first.
+
+### Marking time as billable
+
+Click the **$** (dollar sign) icon to toggle the billable status of a time entry. When billable is active, the dollar sign is highlighted. This is useful for:
+
+- Separating billable client work from internal non-billable activities
+- Generating accurate invoices based on tracked billable time
+- Analyzing your billable vs non-billable time ratio in Reports
+
+![Billable toggle](/static/img/timer/timer-billable-toggle.png)
+
 ### Continuing time entries
 
 When you continue working on something, you can start a timer for that activity in one click.
@@ -48,11 +139,9 @@ Autocomplete list takes into consideration last 250 time entries from last 60 da
 
 ### Change start time of the running timer
 
-You can change the start time while the timer is running by clicking on the running time. Then you can manually type in your real start time.
+You can change the start time while the timer is running by clicking on the running time display. Then you can manually type in your real start time.
 
-This is useful when you start an activity but you can't start the timer at that moment (eg. you're on a meeting and are away from the computer).
-
-![img](/static/img/timer-mode-new2.jpg)
+This is useful when you start an activity but you can't start the timer at that moment (e.g., you're in a meeting and are away from the computer).
 
 ### Running multiple timers
 
@@ -68,12 +157,10 @@ Keep in mind that all the time you track in one workspace will not be available
 
 If you forgot to start the timer, or you prefer to fill in all your work hours in one go, use manual mode.
 
-Manual mode is also useful when you want to add past activities/events (e.g. previous week's day to your timesheet).
+Manual mode is also useful when you want to add past activities/events (e.g., previous week's day to your timesheet).
 
 Manual mode lets you add time entries one by one, specify start and end times, and date.
 
-![img](/static/img/timer-mode-new2.jpg)
-
 - Enter manual mode by clicking the list icon in the upper right corner on the Time Tracker page.
 - Optionally type what you've worked on in the "What have you worked on?" box.
 - Optionally, mark time as billable, select project/task, and add tags.
@@ -92,7 +179,6 @@ Manual mode lets you add time entries by duration. Let’s say you've started wo
 - Type 2h (or 200 or 2:00)
 - Click ADD to add the time entry
 
-![img](/static/img/timer-mode-new2.jpg)
 
 Duration format guide