跪拜 Guibai
← All articles
Open Source · GitHub · Agile Development

MiniWho: A Self-Hosted Resume Builder That Actually Keeps Hidden Fields Hidden

By Cosolar ·
Read original on juejin.cn ↗ Google Translate ↗ Alt translation

Most resume platforms monetize by watermarking, AI processing, or analytics, and hidden fields often amount to front-end CSS. MiniWho eliminates those vectors by design, and for teams or career services that handle sensitive resumes, it offers a self-hosted instance where data never leaves the premises.

Summary

MiniWho targets the resume-writing grind: alignment fights in Word, watermarked exports from template sites, and data uploaded to third parties without consent. The project is a self-hosted, open-source resume workbench that stores content as JSON, separates content from layout, and renders A4 pages consistently across screen, print, and PDF. It ships with 18 structured modules and 60 A4 templates, all free, with no paid tiers or third-party analytics.

Privacy is structural, not cosmetic. Phone numbers, emails, and other fields flagged as hidden are stripped from the server response before they reach a visitor's browser. Photos are served via HMAC-signed short-lived URLs, and share links support passwords, expiry, view counts, and revocation. A five-dimension diagnostic scores resumes on completeness, job match, expression quality, quantified results, and format, using fixed local rules with no external AI. The project runs on SQLite by default, switches to MySQL with one environment variable, and self-hosts cleanly with a Docker command that includes Chromium and Chinese fonts for server-side PDF generation.

Template packs are deliberately sandboxed: they contain theme tokens and constrained CSS only, with @import, expression(), behavior, !important, and external url() rejected server-side. That means community templates can't execute code or corrupt someone's resume. The project also documents its honest limits: no Word or Markdown export, no OCR, no AI polishing, and no central template marketplace yet.

Takeaways
— 18 structured modules and 60 official A4 templates are included, with no paid tiers or watermarks.
— Server-side PDF export uses headless Chrome or Edge, then PDFBox rewrites only the ToUnicode mapping to make text selectable and searchable without touching layout.
— Fields marked hidden are removed server-side before reaching the visitor's browser, not hidden with CSS.
— Photo access uses HMAC-signed short-lived URLs that expire and cannot be shared indefinitely.
— The five-dimension diagnostic weights completeness 25, job match 25, expression quality 20, quantified results 15, and format 15, with up to 12 actionable tips.
— Default storage is SQLite with zero config; setting SPRING_PROFILES_ACTIVE=mysql switches to MySQL 8.
— All three registration methods (SMTP, GitHub, username) are off by default, and accounts can zip-export all data with a 7-day reversible deletion window.
— Template packs contain only theme tokens and constrained CSS, with server-side rejection of @import, expression(), behavior, !important, and external url().
— A one-line Docker command runs the full stack with built-in Chromium and Chinese fonts, so server-side PDF works out of the box.
— The README explicitly lists unimplemented features: Word/Markdown export, OCR, AI polish, central template marketplace, version history, and object storage.
Conclusions

MiniWho treats hidden fields as a server-side contract, not a styling choice; that is the difference between a privacy feature and privacy theater.

The template sandbox's approach of physically denying execution capability at the format level makes an open template ecosystem viable without a security review pipeline.

By rewriting only the ToUnicode mapping in the PDF, the project solves the ATS-readable text problem without touching layout, a trade-off many export tools get wrong.

The README's explicit list of unfinished features is more useful than a hyped roadmap, because it sets expectations and points contributors to the gaps.

Concepts & terms
ToUnicode mapping
The part of a PDF that maps internal character codes to Unicode text. Rewriting it makes text selectable and searchable without changing the visual layout.
HMAC-signed URL
A URL signed with a hash-based message authentication code and an expiry time. MiniWho uses these for photo access so links expire and cannot be shared indefinitely.
Source: juejin.cn ↗ Google Translate ↗ Backup ↗