Skip to content

Product-Designs/WeeklySummaryGenerator

Repository files navigation

Claude Express.js NodeJS

Weekly Summary Generator

A web application that parses time tracking PDFs and generates comprehensive weekly summaries with downloadable markdown and PDF outputs.

This generator was created for direct integration with PDFs from TimeTracker Pro. Results will vary with other documents.

Built using Claude Code.

Features

  • Upload time tracking PDFs with daily work entries
  • Automatically groups entries by week (Sunday to Saturday)
  • Generates combined weekly summaries organized by project/topic
  • Extracts tasks, hours, revenue, and project information
  • Generates formatted summaries in both Markdown and PDF formats
  • Clean, modern web interface with drag-and-drop support
  • Displays most recent weeks first
  • Configurable output: weekly summaries only or with detailed daily breakdowns

Installation

npm install

Usage

Start the Web Server

npm start

Then open your browser to http://localhost:3000

Development Mode

npm run dev

How It Works

  1. Upload PDF: Drag and drop or click to upload your time tracking PDF
  2. Parse Data: The system extracts dates, tasks, hours, and revenue
  3. Group by Week: Entries are organized into weeks (Sunday-Saturday)
  4. Generate Combined Summary: Creates human-readable weekly summaries organized by project/topic
  5. View Statistics: See summary statistics and weekly breakdowns
  6. Configure Output: Choose to include detailed daily summaries or just weekly summaries
  7. Download: Get your summary as Markdown (.md) or PDF

Weekly Summary Feature

The generator creates intelligent weekly summaries that:

  • Organize by project: Major work items are grouped by project with bullet points
  • Condense information: Removes duplicate mentions of the same work across days
  • Highlight key activities: Focuses on significant time blocks and major tasks
  • Include context: Minor activities are summarized in a paragraph for completeness
  • Professional tone: Written in first person with a conversational but professional style
  • Partner-ready: Perfect for sharing progress with clients and partners

PDF Format Requirements

The application expects PDFs with the following structure:

  • Date headers: "DayOfWeek, Month Day, Year" (e.g., "Wednesday, December 3, 2025")
  • Time information: Start and end times with total hours
  • Financial data: Billable/non-billable hours and revenue
  • Daily summary: Text description of work performed
  • Task table: Optional detailed task breakdown

Tech Stack

  • Node.js: Runtime environment
  • Express: Web server framework
  • pdf-parse: PDF text extraction
  • PDFKit: PDF generation
  • Multer: File upload handling

Project Structure

WeeklySummaryGenerator/
├── src/
│   ├── server.js            # Express server and API routes
│   ├── pdfParser.js         # PDF parsing and week grouping logic
│   ├── summaryGenerator.js  # Combined weekly summary generation
│   ├── markdownGenerator.js # Markdown output generation
│   └── pdfGenerator.js      # PDF output generation
├── public/
│   └── index.html           # Web interface
├── test/
│   └── testParser.js        # Testing utility
├── package.json
└── README.md

API Endpoints

POST /api/upload

Uploads and processes a PDF file

  • Body: multipart/form-data with 'pdf' field
  • Response: JSON with parsed weeks and statistics

GET /api/download/markdown

Downloads the generated summary as Markdown

  • Query Parameters:
    • includeDailySummaries (boolean, default: true) - Include detailed daily breakdowns
  • Response: markdown file

GET /api/download/pdf

Downloads the generated summary as PDF

  • Query Parameters:
    • includeDailySummaries (boolean, default: true) - Include detailed daily breakdowns
  • Response: PDF file

Future Enhancements

  • CLI tool version for command-line usage
  • Support for multiple PDF formats
  • Custom date range filtering
  • Export to additional formats (CSV, JSON)
  • Session persistence for multiple users
  • Project-based filtering and grouping

About

Generates a weekly summary from uploaded PDFs. Best when used with reports generated by TimeTracker Pro.

Resources

Stars

Watchers

Forks