Skip to content

Latest commit

Β 

History

History
101 lines (77 loc) Β· 1.67 KB

README.md

File metadata and controls

101 lines (77 loc) Β· 1.67 KB

πŸ“Š Shift Passdown PDF Generator

AI-powered application for converting raw engineering daily notes into structured shift passdown reports in PDF format.


πŸš€ Features

  • Convert raw notes β†’ structured report (OpenAI)
  • Automatic classification:
    • Work Orders (XAMxxxx)
    • Machines (Mxx)
    • Blockers / Issues
  • Generate professional PDF (WeasyPrint)
  • FastAPI backend
  • Docker-ready deployment

🧠 Use Case

Designed for:

  • Semiconductor equipment engineers
  • Fab environments (Intel / Rigaku / etc.)
  • Shift handover documentation

πŸ“¦ Project Structure

passdown_app/ β”œβ”€β”€ app.py β”œβ”€β”€ requirements.txt β”œβ”€β”€ Dockerfile β”œβ”€β”€ docker-compose.yml β”œβ”€β”€ .env └── templates/ └── passdown.html


βš™οΈ Installation (Local)

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt


OPENAI_API_KEY=your_key
OPENAI_MODEL=gpt-5.4

Run:
uvicorn app:app --reload
Open:
http://127.0.0.1:8000

🐳 Docker Installation
Build & Run
docker compose up --build
Open:
http://127.0.0.1:8000

πŸ§ͺ Example Input
M21 XAM200857 General routing started.
Item 2234 is absent.
M23 down, vacuum issue.
Replaced sensor J14.

πŸ“„ Output
Generated PDF includes:
Summary
Tasks Performed
Machine Status
Blockers
Risks
Handoff to Next Shift
Notes

πŸ”§ Tech Stack
FastAPI
OpenAI Responses API (Structured Outputs)
Jinja2
WeasyPrint
Docker

⚠️ Notes
Requires valid OpenAI API key
WeasyPrint requires system dependencies (handled in Docker)

πŸš€ Future Improvements
WO grouping logic
Machine state tracking
Email export
Report history storage
Authentication

πŸ‘¨β€πŸ”§ Author
Dima Kozach
 Semiconductor Equipment Engineer