How treuware/timesheet-saas works
Timesheet SaaS is a multi-tenant scheduling and time-tracking product for small businesses, with a separate platform-operator surface. The tenant workflow covers workforce setup, shift planning, attendance and breaks, timesheet approval, and accounting export; configurable working-time law supports mandatory-break evaluation. Platform operators manage tenants, plans, subscriptions, support, settings, and audit. The tree and README establish capabilities; sampled source also shows attendance invoking timesheet services and contract operations using legal/agreement services. Other links are included only where documented or indexed; unsampled internals are not assumed.
Main entry points: main.py API entry · models.py Employees and contracts · shift/router.py Shift planning · attendance/router.py Attendance and breaks
Components 24
Tenant access
- Tenant web app
frontend/src/App.tsx - Tenant authentication
backend/app/modules/auth/router.py - API entry
backend/app/main.py
Workforce planning
- Companies and branches
backend/app/modules/company/models.py - Employees and contracts
backend/app/modules/employee/models.py - Weekly availability
backend/app/modules/availability - Shift planning
backend/app/modules/shift/router.py - Planner advisory
backend/app/modules/advisory
Time and payroll
- Attendance and breaks
backend/app/modules/attendance/router.py - Timesheet review
backend/app/modules/timesheet/service.py - Accounting export
backend/app/modules/export/service.py - Business dashboard
backend/app/modules/dashboard
Rules and compliance
- Legal configuration
backend/app/modules/legal/service.py - Collective agreements
backend/app/modules/collective_agreement/service.py - Working-time policy
backend/app/modules/working_time_policy/service.py - Rule resolution
backend/app/modules/rule_resolution/resolver.py - Break evaluation
backend/app/modules/legal_evaluation/service.py
Platform operations
- Operator web app
frontend/src/platform/PlatformApp.tsx - Operator authentication
backend/app/modules/platform_auth/router.py - Tenant lifecycle
backend/app/modules/platform_tenants/service.py - Plans and subscriptions
backend/app/modules/platform_subscriptions/service.py - Operator services
backend/app/modules/platform_support/service.py - Account email actions
backend/app/modules/platform_email/account_routes.py
Other components
- Business user
Connections 28
- Business user → Tenant web app: uses
README.md - Tenant web app → API entry: uses API
- API entry → Tenant authentication: mounts routes
backend/app/main.py - API entry → Attendance and breaks: mounts routes
backend/app/main.py - API entry → Shift planning: mounts routes
backend/app/main.py - API entry → Planner advisory: mounts routes
backend/app/main.py - API entry → Break evaluation: mounts routes
backend/app/main.py - Business user → Companies and branches: sets up
README.md - Business user → Employees and contracts: manages workforce
README.md - Business user → Weekly availability: sets availability
README.md - Business user → Shift planning: plans shifts
README.md - Business user → Attendance and breaks: records work
README.md - Attendance and breaks → Timesheet review: calls service
backend/app/modules/attendance/router.py - Business user → Timesheet review: approves months
README.md - Business user → Accounting export: exports records
README.md - Business user → Break evaluation: views evaluation
README.md - Business user → Legal configuration: configures law
README.md - Shift planning → Employees and contracts: reads coverage
backend/app/modules/shift/router.py - Shift planning → Companies and branches: reads branches
backend/app/modules/shift/router.py - Employees and contracts → Collective agreements: assigns agreement
backend/app/modules/contract/router.py - Employees and contracts → Legal configuration: checks regimes
- Working-time policy → Rule resolution: uses combination
backend/app/modules/working_time_policy/service.py - Business user → Operator web app: uses
README.md - Operator web app → Operator authentication: uses API
- Operator authentication → Account email actions: account actions
- Business user → Tenant lifecycle: operator manages tenants
README.md - Business user → Plans and subscriptions: operator manages plans
README.md - Business user → Operator services: operator handles support
README.md