planning-fight/README.md
Mathieu 4ffc736fea - Rename application from "Worker Presence Tracker" to "Worker Presence Manager" in UI texts and metadata.
- Add settings management feature to dynamically update total points and sprint days.
- Refactor forms and modals for better user feedback, validation, and usability.
2025-11-19 13:34:08 +01:00

74 lines
1.5 KiB
Markdown

# Worker Presence Manager
A Next.js application for tracking worker presence with a point system.
## Point System
- Each worker has **13 points** for a 2-week sprint (10 working days)
- Each presence day = 1.3 points
- Points are calculated based on the number of presential days worked
## Getting Started
### Development Mode
1. Install dependencies:
```bash
npm install
```
2. Start the JSON server (in one terminal):
```bash
npm run json-server
```
3. Run the development server (in another terminal):
```bash
npm run dev
```
4. Open [http://localhost:3000](http://localhost:3000) in your browser
### Docker Deployment
#### Local Testing with Docker Compose
```bash
docker-compose up -d
```
#### Docker Swarm Deployment
1. Build the images:
```bash
./deploy.sh
```
2. Deploy to swarm:
```bash
docker stack deploy -c docker-compose.swarm.yml presence-tracker
```
3. Check the deployment:
```bash
docker stack services presence-tracker
```
4. Remove the stack:
```bash
docker stack rm presence-tracker
```
The application will be available at:
- Web UI: http://localhost:3000
- JSON API: http://localhost:3001
## Features
- Add workers with their presence days
- Edit worker presence days inline
- Automatic point calculation
- View points earned, points used, and remaining points
- Summary statistics (total workers, average presence, etc.)
- Reset all presences button (for new sprint)
- Persistent storage with json-server
- Responsive design with Tailwind CSS