Skip to main content

FS Garage Utilisation (BE) Overview

PocketBase + SQLite backend for FS Garage utilisation: allocation publish, scorecard snapshots, and Timesheet API integration via pb_hooks.

What is FS Garage Utilisation (BE)?​

PocketBase + SQLite backend for FS Garage utilisation: allocation publish, scorecard snapshots, and Timesheet API integration via pb_hooks.

FieldValue
CategoryCore / Utilisation
GitHubfs-garage-base
OrgTeamFleetStudio
Source of truth

Runtime setup, env vars, and deploy steps live in the repository. Use this Fleet Docs page for knowledge-transfer context.

Knowledge Transfer Core

Key Features​

  • PocketBase runtime: Auth, collections, Admin UI, SQLite (pb_data/).
  • Custom hooks: pb_hooks/*.pb.js with routerAdd for utilisation/allocation APIs.
  • Allocations collection: Weekly planned hours per user-project-week (draft / published).
  • Utilisation snapshots: Computed scorecard JSON per week for FE display and sparklines.
  • Timesheet pull-on-run: Pulls external Timesheet API on run; does not store full timesheet as SoT.
  • Agent docs suite: docs/ + root AGENTS.md for architecture, ADRs, status, quality.

Tech Snapshot​

LayerChoice
RuntimePocketBase binary
DBSQLite (pb_data/)
Schemapb_migrations/*.js (source of truth)
Custom APIspb_hooks/*.pb.js
Local Adminhttp://127.0.0.1:8091/_/
Work branchoperations (PR into dev-clone)
Default branchdevelopment

Frontend: base-fs-garage-fe.

Metrics​

This BE repo owns Run Now, snapshot JSON, and derived metric calculation (utilisation_derived.js).

Full metric catalog (formulas, badges, key actions):
FS Garage Utilisation - Metrics and Calculations

Project-level overview (FE + BE together):
FS Garage Utilisation - Project Overview

Quick Start​

git clone https://github.com/TeamFleetStudio/fs-garage-base.git
cd fs-garage-base

Then follow Getting Started.

Next Steps​