feat(furt): implement complete Lua HTTP-Server for digital sovereignty (#63)

- Add furt-lua/ directory with pure Lua implementation
- Replace planned Go implementation with Corporate-free technology
- Complete Week 1 Challenge: HTTP-Server to production-ready in 48min

- HTTP-Server in pure Lua (185 lines, lua-socket based)
- JSON API endpoints with request/response parsing
- Modular architecture: each file < 200 lines
- Error handling for 404, 400, validation scenarios

- GET /health - Service health check with timestamp
- POST /test - Development testing with request echo
- POST /v1/mail/send - Mail service foundation with validation
- Comprehensive error responses with structured JSON

- Smart startup script with dependency auto-detection
- Automated test suite with lua-socket HTTP client
- Manual curl test suite for development workflow
- Complete documentation and installation guide

- FROM: Go (Google-controlled) → TO: Lua (PUC-Rio University)
- Corporate-free dependency chain: lua-socket + lua-cjson + lua-ssl
- Performance superior: < 1ms response time, minimal memory usage
- Foundation for planned C+Lua hybrid architecture

- furt-lua/src/main.lua - HTTP-Server implementation
- furt-lua/config/server.lua - Lua-based configuration
- furt-lua/scripts/start.sh - Startup with dependency checks
- furt-lua/scripts/test_curl.sh - Manual testing suite
- furt-lua/tests/test_http.lua - Automated test framework
- furt-lua/README.md - Implementation documentation

- README.md - Document Go→Lua migration strategy
- .gitignore - Add Lua artifacts, luarocks, issue-scripts

All endpoints tested and working:
✓ Health check returns proper JSON status
✓ Test endpoint processes POST requests with JSON
✓ Mail endpoint validates required fields (name, email, message)
✓ Error handling returns appropriate HTTP status codes

Ready for Week 2: SMTP integration with mail.dragons-at-work.de

Completes #63
Related #62
This commit is contained in:
michael 2025-06-17 20:40:40 +02:00
parent 10b795ce13
commit 662bfc7b7a
9 changed files with 1058 additions and 537 deletions

View file

@ -0,0 +1,36 @@
-- furt-lua/config/server.lua
-- Server configuration for Furt Lua HTTP-Server
return {
-- HTTP Server settings
host = "127.0.0.1",
port = 8080,
-- Timeouts (seconds)
client_timeout = 10,
-- Logging
log_level = "info",
log_requests = true,
-- Security (for future use)
api_keys = {
["hugo-frontend-key"] = {
name = "Hugo Frontend",
permissions = {"mail:send"},
allowed_ips = {"127.0.0.1", "10.0.0.0/8"}
}
},
-- Mail configuration (for SMTP integration)
mail = {
smtp_server = "mail.dragons-at-work.de",
smtp_port = 465,
use_ssl = true,
username = os.getenv("FURT_MAIL_USERNAME"),
password = os.getenv("FURT_MAIL_PASSWORD"),
from_address = "noreply@dragons-at-work.de",
to_address = "michael@dragons-at-work.de"
}
}