77 lines
2.1 KiB
Markdown
77 lines
2.1 KiB
Markdown
---
|
|
type: project
|
|
status: active
|
|
source: git.alwisp.com
|
|
repo: jason/wfh
|
|
repo_url: https://git.alwisp.com/jason/wfh
|
|
language: TypeScript
|
|
branch: master
|
|
tags: [repo, jason]
|
|
updated: 2026-05-29
|
|
---
|
|
|
|
# wfh
|
|
|
|
**Repository:** [jason/wfh](https://git.alwisp.com/jason/wfh) · branch `master` · TypeScript
|
|
|
|
## Summary
|
|
|
|
Work From Home - Progress Tracker
|
|
|
|
## Current status
|
|
|
|
Active. Synced from Gitea on 2026-05-29.
|
|
|
|
## Documentation overview
|
|
|
|
# WFH Daily Report App
|
|
|
|
A sleek, modern, and dockerized web application for employees to track and submit their daily work-from-home reports. Features a stunning glassmorphic design and seamless integration with Google Workspace.
|
|
|
|
## ✨ Features
|
|
|
|
- **Premium UI**: Modern glassmorphism aesthetics with smooth animations and responsive design.
|
|
- **Google OAuth 2.0**: Secure authentication using your company's Google Workspace accounts.
|
|
- **Multi-Step Reporting**:
|
|
- **Morning**: Log planned tasks, time estimates, and initial notes.
|
|
- **Evening**: Review achievements, update statuses, and submit links to completed work.
|
|
- **Smart Admin Logic**:
|
|
- The first user to log in is automatically granted the **ADMIN** role.
|
|
- Exclusive **Admin Panel** to search and review all employee reports.
|
|
- **Google Drive Integration**:
|
|
- Automatically exports completed reports as Google Docs.
|
|
- Admins can designate a specific folder for all exports.
|
|
- **Single-Container Architecture**: Uses SQLite for persistent storage, making it ideal for "drop-in" deployments (e.g., Unraid, Synology).
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### 1. Prerequisites
|
|
- [Google Cloud Console](https://console.cloud.google.com/) Project with:
|
|
- OAuth 2.0 Credentials (Web Application)
|
|
- Google Drive API enabled
|
|
- Docker installed on your host.
|
|
|
|
### 2. Environment Setup
|
|
Copy `.env.example` to `.env` and provide your credentials:
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
### 3. Run with Docker
|
|
```bash
|
|
# Build and run the container
|
|
docker build -t wfh-report .
|
|
docker run -p 3000:3000 \
|
|
--env-file .env \
|
|
-v $(pwd)/data:/app/data \
|
|
wfh-report
|
|
```
|
|
|
|
## 🏡 Unraid Installation
|
|
|
|
…(truncated — see repo)
|
|
|
|
## Notes
|
|
|
|
- Project file auto-created from repo documentation.
|