JK
>ΦΟΡΤΩΣΗ // ΦΟΡΤΩΣΗ
ΑΡΧΙΚΟΠΟΙΗΣΗ ΠΡΟΒΟΛΗΣ
Ολοκληρώθηκεreacttypescriptvitetailwindgogindocker
Γεννήτρια Βιογραφικών LaTeX
Εργαλείο βιογραφικών επικεντρωμένο στην ιδιωτικότητα που παράγει έγγραφα LaTeX βελτιστοποιημένα για ATS.
Πρόβλημα & Λύση
Οι παραδοσιακές υπηρεσίες αποθηκεύουν ευαίσθητα δεδομένα στο cloud και παράγουν αρχεία PDF που απορρίπτονται από συστήματα ATS. Αυτό το εργαλείο προσφέρει απόλυτη τοπική προστασία και ακρίβεια LaTeX.
Χαρακτηριστικά
- 9 βελτιστοποιημένα πρότυπα LaTeX για συστήματα ATS
- Τοπική αποθήκευση στο πρόγραμμα περιήγησης για απόλυτη προστασία
- Ζωντανή προεπισκόπηση με άμεση μεταγλώττιση μέσω Go
- Αυστηρός περιορισμός σε μία σελίδα A4
- Εξαγωγή σε κώδικα LaTeX και PDF
Τεχνολογικό stack
| Τεχνολογία | Έκδοση | Σκοπός | Γιατί επιλέχθηκε |
|---|---|---|---|
| React | 19 | UI framework | Latest concurrent features, lazy loading |
| TypeScript | ~6.0 | Type safety | Prevents runtime errors on complex resume data model |
| Vite | 8.x | Build tool & dev server | Fast HMR, native ESM, code splitting via glob imports |
| Tailwind CSS | v4 | Utility-first styling | Rapid UI development, consistent design tokens |
| Zustand | 5.x | State management | Minimal boilerplate, built-in persist middleware |
| @dnd-kit | core 6, sortable 10 | Drag-and-drop | Accessible, performant sortable lists |
| Go | 1.25+ | Backend runtime | Fast startup, small binaries, excellent concurrency |
| Gin | 1.12 | HTTP framework | High performance, middleware ecosystem |
| Tectonic | 0.16.9 | LaTeX→PDF compiler | Self-contained, no TeX distribution needed |
| Docker | — | Containerization | Reproducible builds, production parity |
| SQLite | modernc.org/sqlite 1.54 | Stats persistence | No CGO dependency, cross-compilation |
| Sentry | 10.x | Error tracking & monitoring | Session replay, performance monitoring, feedback widget |
Αρχιτεκτονική
Frontend (React SPA)
- React 19 SPA with Zustand state management
- 9 pluggable template strategy pattern (config + preview + LaTeX generator)
- Live A4 page simulation with zoom and pagination
- WebSocket-based real-time compilation streaming
- Vite 8 with code splitting via import.meta.glob
Backend (Go Microservice)
- Go/Gin HTTP server with single concern: LaTeX compilation
- Tectonic subprocess management with --untrusted sandboxing
- Per-IP token bucket rate limiting (5 rps, burst 10)
- API key authentication on compile endpoints
- SQLite for aggregate visit/download statistics
Infrastructure
- Docker Compose orchestration (backend + Prometheus + Grafana)
- Multi-stage Docker builds (golang → alpine + tectonic)
- Vercel deployment for frontend, Render for backend
- Prometheus metrics with Grafana dashboards
Δομή έργου
backend
cmd
server
main.go
internal
compiler
handlers
middleware
websocket
frontend
src
components
editor
preview
hooks
stores
templates
API endpoints
Go Backend (θύρα 8080)
| Μέθοδος | Διαδρομή | Σκοπός |
|---|---|---|
| POST | /api/compile | Compile LaTeX to PDF (HTTP) |
| GET | /api/compile/ws | WebSocket compile with progress streaming |
| POST | /api/stats/visit | Record page visit |
| POST | /api/stats/download | Record PDF download |
| GET | /api/stats | Get aggregate stats |
| GET | /api/health | Health check (Tectonic + DB status) |
| GET | /metrics | Prometheus metrics |
Σχεδιασμός βάσης δεδομένων
stats
| Στήλη | Τύπος | Σημειώσεις |
|---|---|---|
| keyPK | TEXT | Counter name: 'visits' or 'downloads' |
| value | INTEGER | Counter value, default 0 |
Single table with 2 key-value rows. WAL mode enabled. Used only for aggregate visit/download statistics — no user data stored.
No relationships. Single table with 2 counter rows.
Βασικές σχεδιαστικές αποφάσεις
Frontend-First Architecture
Απόφαση: All resume data, editing, preview, and LaTeX generation happen in the browser
Λόγος: Privacy-first: all data stays in browser with localStorage persistence
Οφέλη: Zero server costs for editing, user privacy, offline-capable editing
Ανταλλάγματα: No cloud sync, no cross-device access, localStorage size limits
Tectonic for LaTeX Compilation
Απόφαση: Use Tectonic instead of pdflatex or other TeX distributions
Λόγος: Self-contained binary, no TeX distribution needed on the server
Οφέλη: Simple Docker image, reproducible builds
Ανταλλάγματα: Slower than pdflatex for complex documents
Zustand over Redux/Context
Απόφαση: Use Zustand for state management with built-in persist middleware
Λόγος: Minimal boilerplate, built-in localStorage persistence
Οφέλη: Simple state management, easy persistence
Ανταλλάγματα: Less ecosystem than Redux
WebSocket for Compile Streaming
Απόφαση: Use WebSocket instead of HTTP polling for PDF compilation
Λόγος: Real-time progress feedback improves UX during 5-60s compilation
Οφέλη: User sees compilation stages (validating → writing → compiling → done)
Ανταλλάγματα: More complex than HTTP polling
Strategy Pattern for Templates
Απόφαση: Each template implements a Template interface with config, Preview, and generateLatex
Λόγος: Multiple visual styles with shared data model
Οφέλη: Extensible, each template self-contained, lazy-loadable via import.meta.glob
Ανταλλάγματα: Code duplication across templates
SQLite for Stats Only
Απόφαση: Use SQLite for aggregate visit/download counters only
Λόγος: Zero-config embedded DB adequate for 2 counter rows
Οφέλη: No external database dependency, simple deployment
Ανταλλάγματα: Write contention under concurrent access
Δοκιμές
None configured•0 μονάδες δοκιμών
Τι δοκιμάζεται
Κενά κάλυψης
- Unit tests for escapeLatex, generateLatex functions
- Unit tests for template rendering and LaTeX generation
- Integration tests for compile handler
- Integration tests for WebSocket compilation flow
- E2E tests for critical user flows (edit → preview → export)
Βασικές προκλήσεις
- Μεταγλώττιση LaTeX σε serverless περιβάλλον με απόκριση κάτω των 500ms
- Διασφάλιση διατήρησης του περιεχομένου αυστηρά σε μία σελίδα A4
Βασικά διδάγματα
- Σύνδεση μηχανών μεταγλώττισης LaTeX με web microservices
- Σχεδιασμός τοπικής αποθήκευσης με προτεραιότητα την ιδιωτικότητα