🇨🇳 中文文档

A document generation microservice based on Spring Boot, using poi-tl for Word template rendering and EasyExcel for Excel operations. Provides RESTful APIs for external systems (e.g., Go services) to call, with Docker containerization support.

• 📄 Word Document Generation - Template-based dynamic document generation using poi-tl
• 📑 Batch Word Generation - Generate multi-page documents from multiple data records
• 📊 Excel Generation - Dynamic Excel creation with EasyExcel
• 📋 Excel Template Fill - Fill Excel templates with variables and list data
• 🔄 Table Loop Rendering - Automatic detection and rendering of collection data
• 📤 Template Management - Upload and list template files via API
• 🐳 Docker Ready - Multi-architecture support (amd64/arm64)
• 📚 Go SDK - Ready-to-use Go client library

• 🐛 Fixed: Batch Word generation now correctly adds page breaks between documents
• ⚡ Improved: Using poi-tl native NiceXWPFDocument.merge() for better document format preservation

# Build and run
mvn clean package -DskipTests
docker-compose up -d --build

# Access Swagger UI
open http://localhost:8081/swagger-ui.html

# Build
mvn clean package -DskipTests

# Run
java -jar target/doc-gen-service-0.0.4.jar

POST /api/v1/doc/word
Content-Type: application/json

{
  "templateName": "template.docx",
  "data": {
    "title": "My Report",
    "date": "2025-01-01"
  },
  "fileName": "output_report"
}

Generate a single document with multiple pages from multiple data records.

POST /api/v1/doc/word/batch
Content-Type: application/json

{
  "templateName": "certificate.docx",
  "dataList": [
    {"name": "Alice", "award": "Gold"},
    {"name": "Bob", "award": "Silver"}
  ],
  "fileName": "certificates"
}

POST /api/v1/doc/excel
Content-Type: application/json

{
  "sheetName": "Sheet1",
  "headers": ["Name", "Age", "City"],
  "data": [
    ["Alice", 25, "Beijing"],
    ["Bob", 30, "Shanghai"]
  ],
  "fileName": "employees"
}

Fill Excel templates with variables {variable} and list data {.field}.

POST /api/v1/doc/excel/fill
Content-Type: application/json

{
  "templateName": "report-template.xlsx",
  "data": {"title": "Sales Report", "date": "2025-01-01"},
  "listData": {
    "items": [
      {"no": 1, "name": "Product A", "price": 100},
      {"no": 2, "name": "Product B", "price": 200}
    ]
  },
  "fileName": "sales_report"
}

# Upload template
POST /api/v1/template/upload
Content-Type: multipart/form-data

# List templates
GET /api/v1/template/list

# Download template
GET /api/v1/template/download/{templateName}

# Delete template
DELETE /api/v1/template/{templateName}

go get github.com/Mars-Sea/doc-gen-service/sdk/[email protected]

client := docgen.NewClient("http://localhost:8081")

// Generate Word document
doc, _ := client.GenerateWord("template.docx", data, "report")
os.WriteFile("report.docx", doc, 0644)

// Batch generate Word document
dataList := []map[string]any{
    {"name": "Alice", "award": "Gold"},
    {"name": "Bob", "award": "Silver"},
}
batchDoc, _ := client.BatchGenerateWord("certificate.docx", dataList, "certificates")

// Fill Excel template
filledExcel, _ := client.FillExcelTemplate("template.xlsx", data, listData, "output")

# Build for ARM64
docker buildx build --platform linux/arm64 -t doc-gen-service:arm64 --load .

# Build for AMD64
docker buildx build --platform linux/amd64 -t doc-gen-service:amd64 --load .

MIT License

• poi-tl Documentation
• EasyExcel Documentation
• Spring Boot
• Go SDK Documentation