polyforge-cli 0.1.0

package/dist/templates/backend/springboot/apps/api/src/main/java/com/scaffold/api/common/GlobalExceptionHandler.java

@@ -0,0 +1,22 @@
+package com.scaffold.api.common;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+import org.springframework.web.bind.annotation.ControllerAdvice;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+
+@ControllerAdvice
+public class GlobalExceptionHandler {
+
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public ResponseEntity<ApiResponse<Void>> handleValidation(MethodArgumentNotValidException ex) {
+        return ResponseEntity.badRequest().body(ApiResponse.error(10001, "validation error", TraceIdHolder.get()));
+    }
+
+    @ExceptionHandler(Exception.class)
+    public ResponseEntity<ApiResponse<Void>> handleException(Exception ex) {
+        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
+                .body(ApiResponse.error(10000, "internal server error", TraceIdHolder.get()));
+    }
+}

package/dist/templates/backend/springboot/apps/api/src/main/java/com/scaffold/api/common/TraceIdHolder.java

@@ -0,0 +1,19 @@
+package com.scaffold.api.common;
+
+public final class TraceIdHolder {
+    private static final ThreadLocal<String> HOLDER = new ThreadLocal<>();
+
+    private TraceIdHolder() {}
+
+    public static void set(String traceId) {
+        HOLDER.set(traceId);
+    }
+
+    public static String get() {
+        return HOLDER.get();
+    }
+
+    public static void clear() {
+        HOLDER.remove();
+    }
+}

package/dist/templates/backend/springboot/apps/api/src/main/java/com/scaffold/api/config/TraceIdFilter.java

@@ -0,0 +1,38 @@
+package com.scaffold.api.config;
+
+import com.scaffold.api.common.TraceIdHolder;
+import jakarta.servlet.FilterChain;
+import jakarta.servlet.ServletException;
+import jakarta.servlet.http.HttpServletRequest;
+import jakarta.servlet.http.HttpServletResponse;
+import org.slf4j.MDC;
+import org.springframework.stereotype.Component;
+import org.springframework.web.filter.OncePerRequestFilter;
+
+import java.io.IOException;
+import java.util.UUID;
+
+@Component
+public class TraceIdFilter extends OncePerRequestFilter {
+    private static final String TRACE_HEADER = "X-Trace-Id";
+
+    @Override
+    protected void doFilterInternal(HttpServletRequest request,
+                                    HttpServletResponse response,
+                                    FilterChain filterChain) throws ServletException, IOException {
+        String traceId = request.getHeader(TRACE_HEADER);
+        if (traceId == null || traceId.isBlank()) {
+            traceId = UUID.randomUUID().toString().replace("-", "").substring(0, 16);
+        }
+        TraceIdHolder.set(traceId);
+        MDC.put("traceId", traceId);
+        response.setHeader(TRACE_HEADER, traceId);
+
+        try {
+            filterChain.doFilter(request, response);
+        } finally {
+            TraceIdHolder.clear();
+            MDC.remove("traceId");
+        }
+    }
+}

package/dist/templates/backend/springboot/apps/api/src/main/java/com/scaffold/api/controller/HealthController.java

@@ -0,0 +1,17 @@
+package com.scaffold.api.controller;
+
+import com.scaffold.api.common.ApiResponse;
+import com.scaffold.api.common.TraceIdHolder;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Map;
+
+@RestController
+public class HealthController {
+
+    @GetMapping("/health")
+    public ApiResponse<Map<String, String>> health() {
+        return ApiResponse.success(Map.of("status", "ok"), TraceIdHolder.get());
+    }
+}

package/dist/templates/backend/springboot/apps/api/src/main/java/com/scaffold/api/controller/PingController.java

@@ -0,0 +1,23 @@
+package com.scaffold.api.controller;
+
+import com.scaffold.api.common.ApiResponse;
+import com.scaffold.api.common.TraceIdHolder;
+import com.scaffold.api.service.PingService;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Map;
+
+@RestController
+public class PingController {
+    private final PingService pingService;
+
+    public PingController(PingService pingService) {
+        this.pingService = pingService;
+    }
+
+    @GetMapping("/api/v1/ping")
+    public ApiResponse<Map<String, String>> ping() {
+        return ApiResponse.success(Map.of("message", pingService.ping()), TraceIdHolder.get());
+    }
+}

package/dist/templates/backend/springboot/apps/api/src/main/java/com/scaffold/api/repository/PingRepository.java

@@ -0,0 +1,10 @@
+package com.scaffold.api.repository;
+
+import org.springframework.stereotype.Repository;
+
+@Repository
+public class PingRepository {
+    public String message() {
+        return "pong";
+    }
+}

package/dist/templates/backend/springboot/apps/api/src/main/java/com/scaffold/api/service/PingService.java

@@ -0,0 +1,17 @@
+package com.scaffold.api.service;
+
+import com.scaffold.api.repository.PingRepository;
+import org.springframework.stereotype.Service;
+
+@Service
+public class PingService {
+    private final PingRepository pingRepository;
+
+    public PingService(PingRepository pingRepository) {
+        this.pingRepository = pingRepository;
+    }
+
+    public String ping() {
+        return pingRepository.message();
+    }
+}

package/dist/templates/backend/springboot/apps/api/src/main/resources/application-dev.yml

@@ -0,0 +1,2 @@
+app:
+  profile: dev

package/dist/templates/backend/springboot/apps/api/src/main/resources/application-prod.yml

@@ -0,0 +1,2 @@
+app:
+  profile: prod

package/dist/templates/backend/springboot/apps/api/src/main/resources/application-test.yml

@@ -0,0 +1,2 @@
+app:
+  profile: test

package/dist/templates/backend/springboot/apps/api/src/main/resources/application.yml

@@ -0,0 +1,8 @@
+spring:
+  application:
+    name: {{PROJECT_NAME}}-api
+server:
+  port: ${APP_PORT:8080}
+logging:
+  pattern:
+    level: "%5p [traceId:%X{traceId}]"

package/dist/templates/backend/springboot/apps/api/src/test/java/com/scaffold/api/ApplicationTests.java

@@ -0,0 +1,12 @@
+package com.scaffold.api;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+class ApplicationTests {
+
+    @Test
+    void contextLoads() {
+    }
+}

package/dist/templates/base/.env.example

@@ -0,0 +1,5 @@
+APP_NAME={{PROJECT_NAME}}
+APP_ENV=dev
+APP_PORT=8080
+LOG_LEVEL=info
+TRACE_HEADER=X-Trace-Id

package/dist/templates/base/docs/ARCHITECTURE.md

@@ -0,0 +1,9 @@
+# Architecture Notes
+
+- Unified response payload: code/message/data/traceId/timestamp
+- Health endpoint: `/health`
+- Trace propagation header: `X-Trace-Id`
+- Backend main stack: `{{BACKEND_MAIN}}`
+- Frontend: `{{FRONTEND}}`
+- Data modules: `{{DATA_MODULES}}`
+- Extra modules: `{{EXTRA_MODULES}}`

package/dist/templates/base/infra/scripts/build.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[build] building project"
+if [[ -d apps/web && -f apps/web/package.json ]]; then
+  if command -v npm >/dev/null 2>&1; then
+    (cd apps/web && npm run build || true)
+  fi
+fi
+
+if [[ -f apps/api/go.mod ]]; then
+  if command -v go >/dev/null 2>&1; then
+    (cd apps/api && go mod tidy && go build ./...)
+  fi
+elif [[ -f apps/api/pom.xml ]]; then
+  if command -v mvn >/dev/null 2>&1; then
+    (cd apps/api && mvn -q -DskipTests package)
+  fi
+fi
+
+if [[ -f apps/worker-go/go.mod ]]; then
+  if command -v go >/dev/null 2>&1; then
+    (cd apps/worker-go && go mod tidy && go build ./...)
+  fi
+fi
+
+if [[ -f apps/gateway-bff/package.json ]]; then
+  if command -v npm >/dev/null 2>&1; then
+    (cd apps/gateway-bff && npm run build || true)
+  fi
+fi
+
+if [[ -f apps/auth-center/package.json ]]; then
+  if command -v npm >/dev/null 2>&1; then
+    (cd apps/auth-center && npm run build || true)
+  fi
+fi
+
+echo "[build] done"

package/dist/templates/base/infra/scripts/check.sh

@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[check] workspace sanity"
+if [[ ! -f package.json ]]; then
+  echo "[check] package.json missing at repo root" >&2
+  exit 1
+fi
+
+if [[ -d apps/api ]]; then
+  if [[ -f apps/api/go.mod ]]; then
+    if command -v go >/dev/null 2>&1; then
+      (cd apps/api && go mod tidy && go test ./...)
+    else
+      echo "[check] go missing, skip go test"
+    fi
+  elif [[ -f apps/api/pom.xml ]]; then
+    if command -v mvn >/dev/null 2>&1; then
+      (cd apps/api && mvn -q -DskipTests verify)
+    else
+      echo "[check] maven missing, skip spring verify"
+    fi
+  fi
+fi
+
+if [[ -f apps/worker-go/go.mod ]]; then
+  if command -v go >/dev/null 2>&1; then
+    (cd apps/worker-go && go mod tidy && go test ./...)
+  else
+    echo "[check] go missing, skip worker-go tests"
+  fi
+fi
+
+if [[ -f apps/gateway-bff/server.js ]]; then
+  if command -v node >/dev/null 2>&1; then
+    node --check apps/gateway-bff/server.js
+  else
+    echo "[check] node missing, skip gateway-bff syntax check"
+  fi
+fi
+
+if [[ -f apps/auth-center/server.js ]]; then
+  if command -v node >/dev/null 2>&1; then
+    node --check apps/auth-center/server.js
+  else
+    echo "[check] node missing, skip auth-center syntax check"
+  fi
+fi
+
+if [[ -f apps/python-ai/app/main.py ]]; then
+  if command -v python3 >/dev/null 2>&1; then
+    python3 -m py_compile apps/python-ai/app/main.py
+  else
+    echo "[check] python3 missing, skip python-ai compile check"
+  fi
+fi
+
+echo "[check] done"

package/dist/templates/base/infra/scripts/dev.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[dev] starting minimal development flow"
+
+if [[ -d apps/web ]]; then
+  echo "[dev] frontend available at apps/web"
+fi
+
+if [[ -f apps/api/go.mod ]]; then
+  if command -v go >/dev/null 2>&1; then
+    echo "[dev] running go api"
+    (cd apps/api && go mod tidy && go run ./cmd/server)
+  else
+    echo "[dev] go missing, skip api startup"
+  fi
+elif [[ -f apps/api/pom.xml ]]; then
+  if command -v mvn >/dev/null 2>&1; then
+    echo "[dev] running spring api"
+    (cd apps/api && mvn spring-boot:run)
+  else
+    echo "[dev] maven missing, skip api startup"
+  fi
+fi
+
+if [[ -f apps/gateway-bff/server.js ]]; then
+  echo "[dev] gateway-bff available at apps/gateway-bff"
+fi
+
+if [[ -f apps/python-ai/app/main.py ]]; then
+  echo "[dev] python-ai available at apps/python-ai"
+fi

package/dist/templates/base/infra/scripts/test.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "[test] running tests"
+if [[ -d apps/web && -f apps/web/package.json ]]; then
+  if command -v npm >/dev/null 2>&1; then
+    (cd apps/web && npm run test -- --run || true)
+  fi
+fi
+
+if [[ -f apps/api/go.mod ]]; then
+  if command -v go >/dev/null 2>&1; then
+    (cd apps/api && go mod tidy && go test ./...)
+  fi
+elif [[ -f apps/api/pom.xml ]]; then
+  if command -v mvn >/dev/null 2>&1; then
+    (cd apps/api && mvn -q test)
+  fi
+fi
+
+if [[ -d apps/worker-python ]]; then
+  if command -v python3 >/dev/null 2>&1; then
+    (cd apps/worker-python && python3 -m unittest -q)
+  else
+    echo "[test] python missing, skip worker tests"
+  fi
+fi
+
+if [[ -f apps/worker-go/go.mod ]]; then
+  if command -v go >/dev/null 2>&1; then
+    (cd apps/worker-go && go mod tidy && go test ./...)
+  fi
+fi
+
+if [[ -f apps/python-ai/app/main.py ]]; then
+  if command -v python3 >/dev/null 2>&1; then
+    python3 -m py_compile apps/python-ai/app/main.py
+  fi
+fi
+
+echo "[test] done"

package/dist/templates/base/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "private": true,
+  "version": "0.1.0",
+  "scripts": {
+    "dev": "bash infra/scripts/dev.sh",
+    "build": "bash infra/scripts/build.sh",
+    "test": "bash infra/scripts/test.sh",
+    "check": "bash infra/scripts/check.sh"
+  }
+}

package/dist/templates/data/mongodb/infra/data/mongodb/README.md

@@ -0,0 +1,4 @@
+# MongoDB Module
+
+- URI placeholder: `mongodb://localhost:27017/app`
+- Suitable for document-oriented workloads

package/dist/templates/data/mysql/infra/data/mysql/README.md

@@ -0,0 +1,4 @@
+# MySQL Module
+
+- DSN placeholder: `mysql://root:root@localhost:3306/app`
+- Suggested for relational production workloads

package/dist/templates/data/mysql/infra/data/mysql/schema.sql

@@ -0,0 +1,5 @@
+CREATE TABLE IF NOT EXISTS sample_users (
+  id BIGINT PRIMARY KEY,
+  name VARCHAR(128) NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);

package/dist/templates/data/postgresql/infra/data/postgresql/README.md

@@ -0,0 +1,4 @@
+# PostgreSQL Module
+
+- DSN placeholder: `postgres://postgres:postgres@localhost:5432/app`
+- Add pool settings in backend config for production

package/dist/templates/data/postgresql/infra/data/postgresql/schema.sql

@@ -0,0 +1,5 @@
+CREATE TABLE IF NOT EXISTS sample_users (
+  id BIGSERIAL PRIMARY KEY,
+  name TEXT NOT NULL,
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);

package/dist/templates/data/redis/infra/data/redis/README.md

@@ -0,0 +1,4 @@
+# Redis Module
+
+- Use for cache/session/rate-limit placeholders
+- Key naming sample: `app:{domain}:{id}`

package/dist/templates/data/sqlite/infra/data/sqlite/README.md

@@ -0,0 +1,4 @@
+# SQLite Module
+
+- Default file: `./data/app.db`
+- Suitable for local dev / PoC

package/dist/templates/frontend/react/apps/web/.env.example

@@ -0,0 +1,4 @@
+VITE_API_BASE=/api
+VITE_BFF_BASE=/bff
+VITE_DEV_API_TARGET=http://localhost:8080
+VITE_DEV_BFF_TARGET=http://localhost:3001

package/dist/templates/frontend/react/apps/web/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{PROJECT_NAME}} web</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/dist/templates/frontend/react/apps/web/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "{{PROJECT_NAME}}-web",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.8",
+    "@types/react-dom": "^18.3.0",
+    "@vitejs/plugin-react": "^4.4.0",
+    "typescript": "^5.9.2",
+    "vite": "^5.4.8",
+    "vitest": "^2.1.3"
+  }
+}

package/dist/templates/frontend/react/apps/web/src/App.test.tsx

@@ -0,0 +1,7 @@
+import { describe, expect, it } from "vitest";
+
+describe("app", () => {
+  it("basic assertion", () => {
+    expect(true).toBe(true);
+  });
+});

package/dist/templates/frontend/react/apps/web/src/App.tsx

@@ -0,0 +1,59 @@
+import { useState } from "react";
+import {
+  availableServices,
+  getApiBase,
+  getBffBase,
+  hasBffEnabled,
+  pingApi,
+  pingBff,
+  type ApiPayload,
+} from "./api/client";
+
+const HAS_BFF = hasBffEnabled();
+
+export function App() {
+  const [apiResult, setApiResult] = useState<ApiPayload | null>(null);
+  const [apiError, setApiError] = useState<string>("");
+  const [bffResult, setBffResult] = useState<ApiPayload | null>(null);
+  const [bffError, setBffError] = useState<string>("");
+
+  const callApi = async () => {
+    setApiError("");
+    try {
+      setApiResult(await pingApi());
+    } catch (error) {
+      setApiError(error instanceof Error ? error.message : String(error));
+    }
+  };
+
+  const callBff = async () => {
+    if (!HAS_BFF) return;
+    setBffError("");
+    try {
+      setBffResult(await pingBff());
+    } catch (error) {
+      setBffError(error instanceof Error ? error.message : String(error));
+    }
+  };
+
+  return (
+    <main style={{ fontFamily: "sans-serif", padding: 24, maxWidth: 900 }}>
+      <h1>{{PROJECT_NAME}} - React</h1>
+      <p>API base: <code>{getApiBase()}</code> | BFF base: <code>{getBffBase()}</code></p>
+      <p>Available services: <code>{availableServices.join(", ")}</code></p>
+
+      <section style={{ marginBottom: 20 }}>
+        <button onClick={callApi}>Call API /api/v1/ping</button>
+        {apiError ? <p style={{ color: "crimson" }}>{apiError}</p> : null}
+        {apiResult ? <pre>{JSON.stringify(apiResult, null, 2)}</pre> : null}
+      </section>
+
+      <section>
+        <button onClick={callBff} disabled={!HAS_BFF}>Call BFF /bff/ping</button>
+        {!HAS_BFF ? <p>BFF module not selected. Enable <code>gateway-bff</code> to use this call.</p> : null}
+        {bffError ? <p style={{ color: "crimson" }}>{bffError}</p> : null}
+        {bffResult ? <pre>{JSON.stringify(bffResult, null, 2)}</pre> : null}
+      </section>
+    </main>
+  );
+}

package/dist/templates/frontend/react/apps/web/src/api/client.ts

@@ -0,0 +1,20 @@
+import { type ApiPayload } from "./request";
+import { getApiBase, healthApi, pingApi } from "./services/api";
+import { getBffBase, pingBff as pingBffService } from "./services/bff";
+
+const HAS_BFF = "{{HAS_GATEWAY_BFF}}" === "true";
+
+export { type ApiPayload, getApiBase, healthApi, pingApi, getBffBase };
+
+export const availableServices = HAS_BFF ? ["api", "bff"] as const : ["api"] as const;
+
+export async function pingBff(): Promise<ApiPayload<{ message: string }>> {
+  if (!HAS_BFF) {
+    throw new Error("gateway-bff module not enabled");
+  }
+  return pingBffService();
+}
+
+export function hasBffEnabled(): boolean {
+  return HAS_BFF;
+}