feat: Add Web UI, Multilingual Support, Docker Deployment, and CJK Font Support

[DanZai233]

Add Web UI, Multilingual Support, Docker Deployment, and CJK Font Support

Summary

Transform Map Poster Generator into a production-ready web application with:

• 🌐 Complete React + FastAPI web UI
• 🌍 Chinese-English bilingual interface
• 🔍 Intelligent city search (multilingual)
• 🐳 Docker containerization (one-command deploy)
• 🈲 Full CJK font support (Chinese/Japanese/Korean)

Type of Change

• New feature
• Enhancement
• Bug fix
• Documentation update
• Breaking change (Python <3.14 required)

Key Features

Web UI

• Modern React + TypeScript frontend
• 6 RESTful API endpoints
• Real-time preview and gallery
• 17 beautiful themes
• Progress tracking

Multilingual

• i18next + react-i18next
• Auto language detection
• Persistent settings
• Full UI translation

Smart Search

• OpenStreetMap Nominatim API
• Autocomplete with debounce
• Multi-language support
• Auto-fill coordinates

Docker

• Multi-stage build
• Health checks
• Auto-restart

CJK Fonts

• Noto Sans SC (TTF)
• 30MB full character set
• Perfect rendering

Changes

37 files changed: +7,618, -225 lines

Added

• webapp/ - Complete React frontend
• api_server.py - FastAPI backend (303 lines)
• Dockerfile - Multi-stage build
• docker-compose.yml - Deployment config
• fonts/NotoSansSC-*.ttf - Chinese fonts (30MB)
• DOCKER.md, QUICKSTART_EN.md - English docs

Modified

• pyproject.toml - Added fastapi, pydantic, uvicorn
• requirements.txt - Synced dependencies
• font_management.py - TTF font support

Testing

# Docker deployment
docker-compose up -d
curl http://localhost:8000/api/themes  # ✅ 17 themes

# Chinese font rendering
curl -X POST http://localhost:8000/api/generate \
  -d '{"city":"Beijing","display_city":"北京","theme":"terracotta"}'
# ✅ Generated beijing_terracotta.png with perfect Chinese text

# Container health
docker ps | grep maptoposter
# ✅ Up and healthy

Breaking Changes

⚠️ Python Version: Now requires >=3.11,<3.14 (was >=3.11)

• Reason: pydantic-core doesn't support Python 3.14
• Action: Use Python 3.11, 3.12, or 3.13

Checklist

• Code follows style guidelines
• Self-review completed
• Documentation updated
• Tests pass
• Docker builds successfully
• No new warnings
• Backward compatible (CLI still works)

Usage

Docker (Recommended)

docker-compose up -d
open http://localhost:8000

Manual

./start.sh
open http://localhost:3000

API

curl -X POST http://localhost:8000/api/generate \
  -H "Content-Type: application/json" \
  -d '{"city":"Tokyo","theme":"noir"}'

Documentation

• DOCKER.md - Docker deployment guide
• QUICKSTART_EN.md - Quick start guide
• WEBUI_README.md - Web UI guide

Related Issues

Fixes: #N/A (new feature)

Notes for Reviewers

Please review:

• Frontend components (webapp/src/components/)
• API endpoints (api_server.py)
• Docker configuration
• Font handling changes
• Documentation clarity

[merwok]

Based on other PRs, this will probably be rejected.

• Author doesn’t want docker config (not sure why; the latest open PR with that is nice though, with publishing automation)
• Multilingual support is already there
• CJK fonts, if not already supported (there is google fonts support now), should be its own PR
• the author is working on their own UI