feat: migrate database from MySQL to PostgreSQL and update schema

.dockerignore

@@ -1,2 +1,4 @@
-node_modules/
+delta-force-guide-server.iml
-README.md
+build/
+.idea/
+.gradle

.gitattributes

@@ -0,0 +1,3 @@
+/gradlew text eol=lf
+*.bat text eol=crlf
+*.jar binary

.github/dependabot.yml

@@ -1,27 +0,0 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
-
-version: 2
-updates:
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-    commit-message:
-      prefix: "chore: "
-
-    groups:
-      dependency-updates:
-        patterns: ["*"]
-        update-types: ["minor", "patch"]
-
-    ignore:
-      - dependency-name: "@types/node"
-        update-types: ["version-update:semver-major"]
-
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "daily"

.gitignore

@@ -97,30 +97,7 @@ fabric.properties
 # Editor-based HTTP Client
 http-client.private.env.json
 
-### Gradle
+### Server
-.gradle
-**/build/
-!**/src/**/build/
-
-# Ignore Gradle GUI config
-gradle-app.setting
-
-# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
-!gradle-wrapper.jar
-
-# Avoid ignore Gradle wrappper properties
-!gradle-wrapper.properties
-
-# Cache of project
-.gradletasknamecache
-
-# Eclipse Gradle plugin generated files
-# Eclipse Core
-.project
-# JDT-specific (Eclipse Java Development Tools)
-.classpath
-
-### Java
 # Compiled class file
 *.class
 
@@ -134,155 +111,40 @@ gradle-app.setting
 .mtj.tmp/
 
 # Package Files #
-*.jar
 *.war
 *.nar
 *.ear
 *.zip
 *.tar.gz
 *.rar
+*.jar
 
 # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
 hs_err_pid*
 replay_pid*
 
-### Node.js
+# Config
-# Logs
+config/*.yml
-logs
+config/*.yaml
-#*.log
+config/*.properties
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
 
-# Diagnostic reports (https://nodejs.org/api/report.html)
+# Tests
-report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+test/
 
-# Runtime data
+### Gradle
-pids
+.gradle
-*.pid
+**/build/
-*.seed
+!**/src/**/build/
-*.pid.lock
 
-# Directory for instrumented libs generated by jscoverage/JSCover
+!gradle/
-lib-cov
+!gradle/wrapper
+!gradle/wrapper/gradle-wrapper.jar
+!gradle/wrapper/gradle-wrapper.properties
+gradle-app.setting
+.gradletasknamecache
 
-# Coverage directory used by tools like istanbul
+# Eclipse Gradle plugin generated files
-coverage
+# Eclipse Core
-*.lcov
+.project
-
+# JDT-specific (Eclipse Java Development Tools)
-# nyc test coverage
+.classpath
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
-
-# Snowpack dependency directory (https://snowpack.dev/)
-web_modules/
-
-# TypeScript cache
-*.tsbuildinfo
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Optional stylelint cache
-.stylelintcache
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.tgz
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variable files
-.env
-.env.*
-!.env.example
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
-.parcel-cache
-
-# Next.js build output
-.next
-out
-
-# Nuxt.js build / generate output
-.nuxt
-dist
-
-# Gatsby files
-.cache/
-# Comment in the public line in if your project uses Gatsby and not Next.js
-# https://nextjs.org/blog/next-9-1#public-directory-support
-# public
-
-# vuepress build output
-.vuepress/dist
-
-# vuepress v2.x temp and cache directory
-.temp
-#.cache
-
-# Sveltekit cache directory
-.svelte-kit/
-
-# vitepress build output
-**/.vitepress/dist
-
-# vitepress cache directory
-**/.vitepress/cache
-
-# Docusaurus cache and generated files
-.docusaurus
-
-# Serverless directories
-.serverless/
-
-# FuseBox cache
-.fusebox/
-
-# DynamoDB Local files
-.dynamodb/
-
-# Firebase cache directory
-.firebase/
-
-# TernJS port file
-.tern-port
-
-# Stores VSCode versions used for testing VSCode extensions
-.vscode-test
-
-# yarn v3
-.pnp.*
-.yarn/*
-!.yarn/patches
-!.yarn/plugins
-!.yarn/releases
-!.yarn/sdks
-!.yarn/versions
-
-# Vite logs files
-vite.config.js.timestamp-*
-vite.config.ts.timestamp-*

.prettierrc.yaml

@@ -1,24 +0,0 @@
-printWidth: 100
-tabWidth: 2
-useTabs: false
-semi: false
-singleQuote: false
-quoteProps: as-needed
-jsxSingleQuote: false
-trailingComma: es5
-bracketSpacing: true
-bracketSameLine: true
-arrowParens: always
-#rangeStart: 0
-#rangeEnd: n
-#parser:
-#filepath:
-#requirePragma: false
-#insertPragma: false
-#proseWrap: preserve
-htmlWhitespaceSensitivity: css
-#vueIndentScriptAndStyle: false
-endOfLine: lf
-#embeddedLanguageFormatting: auto
-# Enforce single attribute per line in HTML, Vue and JSX
-#singleAttributePerLine: false

.vscode/launch.json

@@ -1,22 +0,0 @@
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "node-terminal",
-            "request": "launch",
-            "name": "pnpm dev",
-            "command": "pnpm dev",
-            "cwd": "${workspaceFolder}"
-        },
-        {
-            "type": "node-terminal",
-            "request": "launch",
-            "name": "build",
-            "command": "pnpm build",
-            "cwd": "${workspaceFolder}"
-        }
-    ]
-}

Dockerfile

@@ -1,9 +1,10 @@
-FROM node:20-alpine as builder
+FROM amazoncorretto:21 AS builder
 WORKDIR /app
-COPY . .
+ADD . .
-RUN corepack enable pnpm
+RUN chmod +x ./gradlew && \
-RUN pnpm install
+    ./gradlew build -x test
-RUN pnpm build
 
-FROM nginx:1.27 as runner
+FROM amazoncorretto:21-alpine AS runner
-COPY --from=builder /app/dist/ /usr/share/nginx/html/
+WORKDIR /app
+COPY --from=builder /app/build/libs/delta-force-guide-server-1.0.0.jar app.jar
+ENTRYPOINT ["java", "-jar", "app.jar"]

LICENCE

@@ -1,21 +0,0 @@
-MIT Licence
-
-Copyright (c) 2026 Zihlu Wang
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

README.md

@@ -1,96 +0,0 @@
-# Delta Force Firearm Modification Codes
-
-Delta Force Firearm Modification Codes is a lightweight web app for browsing and filtering firearm modification codes for Delta Force.
-
-The site is built with Vite, React, TypeScript, Tailwind CSS, and React Router. It presents a searchable code library with filtering by weapon, mode, and tag, and includes quick copy support for each modification code.
-
-## Features
-
-- Browse a curated list of firearm modification codes.
-- Filter results by weapon, mode, and tag.
-- Copy modification codes directly from the interface.
-- Render large lists efficiently with window virtualisation.
-- Deploy as a static site.
-
-## Tech Stack
-
-- Vite
-- React 19
-- TypeScript
-- Tailwind CSS 4
-- React Router 7
-- @tanstack/react-virtual
-- Day.js
-
-## Getting Started
-
-### Prerequisites
-
-- Node.js 20 or later is recommended.
-- pnpm is required for dependency management and scripts.
-
-### Install dependencies
-
-```bash
-pnpm install
-```
-
-### Start the development server
-
-```bash
-pnpm dev
-```
-
-### Build for production
-
-```bash
-pnpm build
-```
-
-### Preview the production build locally
-
-```bash
-pnpm preview
-```
-
-## Available Scripts
-
-- `pnpm dev`: start the Vite development server.
-- `pnpm build`: run TypeScript compilation and create a production build.
-- `pnpm preview`: preview the production bundle locally.
-- `pnpm lint`: run project linting.
-- `pnpm deploy`: build and publish the site with `gh-pages`.
-
-## Project Structure
-
-```text
-src/
-	components/       Shared UI components
-	data/             Modification code dataset
-	init/             Application initialisation
-	layout/           Route layouts
-	page/             Route pages
-	router/           Router configuration
-```
-
-The current dataset is stored in `src/data/modification-codes.json`.
-
-## Deployment
-
-The repository is configured for static deployment. The `public/CNAME` file indicates the site is intended to be served on `onixbyte.dev`.
-
-To deploy:
-
-```bash
-pnpm deploy
-```
-
-## Contributing
-
-Contributions are welcome. If you want to improve the dataset, refine the filtering experience, or fix UI issues, open an issue or submit a pull request.
-
-When contributing, please keep documentation and user-facing copy in British English.
-
-## Licence
-
-This project is released under the MIT Licence. See `LICENCE` for details.

build.gradle.kts

@@ -0,0 +1,63 @@
+plugins {
+    java
+    alias(libs.plugins.spring.boot)
+    alias(libs.plugins.spring.dependency.management)
+}
+
+val artefactVersion: String by project
+
+group = "com.onixbyte.helix"
+version = artefactVersion
+
+tasks.withType<JavaCompile> {
+    options.encoding = "UTF-8"
+}
+
+java {
+    sourceCompatibility = JavaVersion.VERSION_21
+    targetCompatibility = JavaVersion.VERSION_21
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(21)
+    }
+}
+
+dependencies {
+    implementation(libs.jspecify.core)
+    implementation(platform(libs.aws.sdk.bom))
+    implementation(libs.aws.sdk.s3)
+    implementation(libs.commons.io)
+    implementation(libs.commons.lang)
+    implementation(libs.commons.collections)
+    implementation(libs.hypersistence.core)
+    implementation(platform(libs.onixbyte.versionCatalogue))
+    implementation(libs.onixbyte.tuple)
+    implementation(libs.onixbyte.commonToolbox)
+    implementation(libs.onixbyte.mathToolbox)
+    implementation(libs.onixbyte.identityGenerator)
+    implementation(libs.onixbyte.captcha)
+    implementation(libs.onixbyte.regions)
+    implementation(libs.jwt.core)
+    implementation(libs.spring.boot.configurationProcessor)
+    implementation(libs.spring.boot.actuator)
+    implementation(libs.spring.boot.starter.web)
+    implementation(libs.spring.boot.starter.webFlux)
+    implementation(libs.spring.boot.starter.validation)
+    implementation(libs.spring.boot.starter.redis)
+    implementation(libs.spring.boot.starter.cache)
+    implementation(libs.spring.boot.starter.jpa)
+    implementation(libs.mybatis.starter.core)
+    implementation(libs.flyway.core)
+    implementation(libs.flyway.postgresql)
+    implementation(libs.jackson.jsr310)
+    implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.16")
+    testImplementation(libs.spring.boot.starter.test)
+    testImplementation(libs.reactor.test)
+    testImplementation(libs.mybatis.starter.test)
+    runtimeOnly(libs.postgres.driver)
+    testRuntimeOnly(libs.h2.database)
+    testRuntimeOnly(libs.junit.launcher)
+}
+
+tasks.test {
+    useJUnitPlatform()
+}

gradle.properties

@@ -0,0 +1 @@
+artefactVersion = 1.0.0

gradle/libs.versions.toml

@@ -0,0 +1,76 @@
+[versions]
+jspecifyVersion = "1.0.0"
+javaJwtVersion = "4.5.1"
+postgresDriverVersion = "42.7.9"
+h2Version = "2.2.224"
+springBootVersion = "3.5.13"
+springSecurityVersion = "6.5.2"
+reactorVersion = "3.7.8"
+junitPlatformVersion = "1.12.2"
+onixbyteVersion = "3.3.0"
+onixbyteCaptcha = "1.1.0"
+onixbyteRegions = "2025.12.0"
+awsSdkVersion = "2.25.48"
+commonsIoVersion = "2.16.1"
+commonsCollections = "4.5.0"
+commonsLangVersion = "3.20.0"
+mybatisVersion = "3.0.5"
+jacksonVersion = "2.19.2"
+hypersistenceVersion = "3.14.0"
+springDependencyManagementVersion = "1.1.7"
+
+[libraries]
+# General Utilities
+jspecify-core = { group = "org.jspecify", name = "jspecify", version.ref = "jspecifyVersion" }
+commons-io = { group = "commons-io", name = "commons-io", version.ref = "commonsIoVersion" }
+commons-collections = { group = "org.apache.commons", name = "commons-collections4", version.ref = "commonsCollections" }
+commons-lang = { group = "org.apache.commons", name = "commons-lang3", version.ref = "commonsLangVersion" }
+jackson-jsr310 = { group = "com.fasterxml.jackson.datatype", name = "jackson-datatype-jsr310", version.ref = "jacksonVersion" }
+
+# Onixbyte Ecosystem
+onixbyte-versionCatalogue = { group = "com.onixbyte", name = "version-catalogue", version.ref = "onixbyteVersion" }
+onixbyte-tuple = { group = "com.onixbyte", name = "tuple" }
+onixbyte-commonToolbox = { group = "com.onixbyte", name = "common-toolbox" }
+onixbyte-mathToolbox = { group = "com.onixbyte", name = "math-toolbox" }
+onixbyte-identityGenerator = { group = "com.onixbyte", name = "identity-generator" }
+onixbyte-captcha = { group = "com.onixbyte", name = "captcha", version.ref = "onixbyteCaptcha" }
+onixbyte-regions = { group = "com.onixbyte", name = "regions4j", version.ref = "onixbyteRegions" }
+
+# Persistence & Database
+mybatis-starter-core = { group = "org.mybatis.spring.boot", name = "mybatis-spring-boot-starter", version.ref = "mybatisVersion" }
+spring-boot-starter-jpa = { group = "org.springframework.boot", name = "spring-boot-starter-data-jpa" }
+hypersistence-core = { group = "io.hypersistence", name = "hypersistence-utils-hibernate-63", version.ref = "hypersistenceVersion" }
+postgres-driver = { group = "org.postgresql", name = "postgresql", version.ref = "postgresDriverVersion" }
+mysql-driver = { group = "com.mysql", name = "mysql-connector-j" }
+h2-database = { group = "com.h2database", name = "h2", version.ref = "h2Version" }
+spring-boot-starter-redis = { group = "org.springframework.boot", name = "spring-boot-starter-data-redis", version.ref = "springBootVersion" }
+flyway-core = { group = "org.flywaydb", name = "flyway-core" }
+flyway-postgresql = { group = "org.flywaydb", name = "flyway-database-postgresql" }
+flyway-mysql = { group = "org.flywaydb", name = "flyway-mysql" }
+
+# Spring Boot Core & Web
+spring-boot-starter-web = { group = "org.springframework.boot", name = "spring-boot-starter-web" }
+spring-boot-starter-webFlux = { group = "org.springframework.boot", name = "spring-boot-starter-webflux" }
+spring-boot-starter-validation = { group = "org.springframework.boot", name = "spring-boot-starter-validation" }
+spring-boot-starter-cache = { group = "org.springframework.boot", name = "spring-boot-starter-cache" }
+spring-boot-configurationProcessor = { group = "org.springframework.boot", name = "spring-boot-configuration-processor" }
+spring-boot-actuator = { group = "org.springframework.boot", name = "spring-boot-starter-actuator" }
+
+# Security & Auth
+spring-boot-starter-security = { group = "org.springframework.boot", name = "spring-boot-starter-security", version.ref = "springBootVersion" }
+jwt-core = { group = "com.auth0", name = "java-jwt", version.ref = "javaJwtVersion" }
+
+# Cloud Services
+aws-sdk-bom = { group = "software.amazon.awssdk", name = "bom", version.ref = "awsSdkVersion" }
+aws-sdk-s3 = { group = "software.amazon.awssdk", name = "s3" }
+
+# Testing
+spring-boot-starter-test = { group = "org.springframework.boot", name = "spring-boot-starter-test", version.ref = "springBootVersion" }
+spring-security-test = { group = "org.springframework.security", name = "spring-security-test", version.ref = "springSecurityVersion" }
+reactor-test = { group = "io.projectreactor", name = "reactor-test", version.ref = "reactorVersion" }
+junit-launcher = { group = "org.junit.platform", name = "junit-platform-launcher", version.ref = "junitPlatformVersion" }
+mybatis-starter-test = { group = "org.mybatis.spring.boot", name = "mybatis-spring-boot-starter-test", version.ref = "mybatisVersion" }
+
+[plugins]
+spring-boot = { id = "org.springframework.boot", version.ref = "springBootVersion" }
+spring-dependency-management = { id = "io.spring.dependency-management", version.ref = "springDependencyManagementVersion" }

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.4-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

gradlew

@@ -0,0 +1,251 @@
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+##############################################################################
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+    echo "$*"
+} >&2
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
+esac
+
+CLASSPATH="\\\"\\\""
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD=$JAVA_HOME/jre/sh/java
+    else
+        JAVACMD=$JAVA_HOME/bin/java
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
+exec "$JAVACMD" "$@"

gradlew.bat

@@ -0,0 +1,94 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
+
+@if "%DEBUG%"=="" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if %ERRORLEVEL% equ 0 goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if %ERRORLEVEL% equ 0 goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/onixbyte.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>三角洲行动改枪码库</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>

package.json

@@ -1,49 +0,0 @@
-{
-  "name": "delta-force-guide-web",
-  "private": true,
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc -b && vite build",
-    "build:tar": "pnpm build && tar -czf dist.tar.gz dist",
-    "lint": "eslint .",
-    "preview": "vite preview",
-    "deploy": "pnpm build && gh-pages -d dist",
-    "predeploy": "pnpm build"
-  },
-  "dependencies": {
-    "@ant-design/cssinjs": "^2.1.2",
-    "@reduxjs/toolkit": "^2.11.2",
-    "@tailwindcss/vite": "^4.2.4",
-    "@tanstack/react-virtual": "^3.13.24",
-    "antd": "^6.3.6",
-    "axios": "^1.15.2",
-    "dayjs": "^1.11.20",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "react-redux": "^9.2.0",
-    "react-router": "^7.14.2",
-    "react-router-dom": "^7.14.2",
-    "redux-persist": "^6.0.0",
-    "tailwindcss": "^4.2.4"
-  },
-  "devDependencies": {
-    "@types/node": "^22.19.17",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^6.0.1",
-    "globals": "^17.5.0",
-    "prettier": "^3.8.3",
-    "typescript": "~6.0.3",
-    "vite": "^8.0.10"
-  },
-  "pnpm": {
-    "ignoredBuiltDependencies": [
-      "esbuild"
-    ],
-    "onlyBuiltDependencies": [
-      "@tailwindcss/oxide"
-    ]
-  }
-}

public/CNAME

@@ -1 +0,0 @@
-onixbyte.dev

public/onixbyte.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="500" zoomAndPan="magnify" viewBox="0 0 375 374.999991" height="500" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><g/></defs><rect x="-37.5" width="450" fill="#ffffff" y="-37.499999" height="449.999989" fill-opacity="1"/><rect x="-37.5" width="450" fill="#324370" y="-37.499999" height="449.999989" fill-opacity="1"/><g fill="#ffffff" fill-opacity="1"><g transform="translate(27.506677, 211.874986)"><g><path d="M 12.359375 -0.453125 C 8.003906 -1.816406 5.003906 -4.3125 3.359375 -7.9375 C 1.710938 -11.5625 1.550781 -16.253906 2.875 -22.015625 C 4.195312 -27.773438 6.519531 -32.46875 9.84375 -36.09375 C 13.175781 -39.71875 17.34375 -42.210938 22.34375 -43.578125 Z M 27.578125 -34.109375 L 30.015625 -44.796875 L 31.875 -44.796875 C 39.46875 -44.796875 44.882812 -42.851562 48.125 -38.96875 C 51.363281 -35.09375 52.128906 -29.441406 50.421875 -22.015625 C 48.722656 -14.585938 45.351562 -8.929688 40.3125 -5.046875 C 35.28125 -1.171875 28.96875 0.765625 21.375 0.765625 C 20.519531 0.765625 19.898438 0.742188 19.515625 0.703125 L 21.953125 -9.921875 C 22.722656 -9.835938 23.34375 -9.796875 23.8125 -9.796875 C 26.84375 -9.796875 29.367188 -10.710938 31.390625 -12.546875 C 33.421875 -14.378906 34.796875 -16.851562 35.515625 -19.96875 L 36.421875 -24.0625 C 37.140625 -27.175781 36.910156 -29.648438 35.734375 -31.484375 C 34.566406 -33.316406 32.46875 -34.234375 29.4375 -34.234375 C 28.96875 -34.234375 28.347656 -34.191406 27.578125 -34.109375 Z M 27.578125 -34.109375 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(80.815405, 211.874986)"><g><path d="M 31.171875 -34.5625 C 28.816406 -34.5625 26.363281 -34.003906 23.8125 -32.890625 L 21.953125 -24.890625 C 22.460938 -25.066406 23.0625 -25.15625 23.75 -25.15625 C 25.15625 -25.15625 26.125 -24.71875 26.65625 -23.84375 C 27.1875 -22.96875 27.28125 -21.804688 26.9375 -20.359375 L 22.265625 0 L 35 0 L 40.0625 -21.890625 C 41 -25.984375 40.726562 -29.117188 39.25 -31.296875 C 37.78125 -33.472656 35.085938 -34.5625 31.171875 -34.5625 Z M 17.28125 -19.96875 L 17.796875 -28.671875 L 18.171875 -33.796875 L 7.75 -33.796875 L -0.0625 0 L 12.671875 0 L 17.21875 -19.84375 Z M 17.28125 -19.96875 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(123.500788, 211.874986)"><g><path d="M 19.515625 -33.796875 L 11.703125 0 L -1.03125 0 L 6.78125 -33.796875 Z M 22.46875 -46.40625 L 20.484375 -37.765625 L 7.75 -37.765625 L 9.71875 -46.40625 Z M 22.46875 -46.40625 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(144.811483, 211.874986)"><g><path d="M 45.5625 -33.796875 L 29.953125 -17.59375 L 38.53125 0 L 23.671875 0 L 19.703125 -10.625 L 19.453125 -10.625 L 10.5625 0 L -3.578125 0 L 13.5625 -17.921875 L 5.5 -33.796875 L 20.484375 -33.796875 L 23.8125 -24.828125 L 24.0625 -24.828125 L 31.484375 -33.796875 Z M 45.5625 -33.796875 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(187.496867, 211.874986)"><g><path d="M 24 -44.03125 L 13.890625 0 L -0.25 0 L 9.859375 -44.03125 Z M 29.25 -34.375 L 31.421875 -44.03125 L 39.171875 -44.03125 C 42.578125 -44.03125 45.21875 -43.003906 47.09375 -40.953125 C 48.976562 -38.910156 49.554688 -36.332031 48.828125 -33.21875 C 47.585938 -27.800781 44.347656 -24.382812 39.109375 -22.96875 L 39.109375 -22.71875 C 44.390625 -21.4375 46.328125 -17.769531 44.921875 -11.71875 C 44.109375 -8.257812 42.21875 -5.441406 39.25 -3.265625 C 36.289062 -1.085938 33.019531 0 29.4375 0 L 21.3125 0 L 23.671875 -10.234375 L 27 -10.234375 C 27.601562 -10.234375 28.179688 -10.382812 28.734375 -10.6875 C 29.285156 -10.988281 29.765625 -11.40625 30.171875 -11.9375 C 30.578125 -12.46875 30.863281 -13.054688 31.03125 -13.703125 L 31.171875 -14.34375 C 31.421875 -15.320312 31.300781 -16.140625 30.8125 -16.796875 C 30.320312 -17.460938 29.628906 -17.796875 28.734375 -17.796875 L 25.40625 -17.796875 L 27.515625 -26.875 L 29.828125 -26.875 C 30.722656 -26.875 31.5625 -27.203125 32.34375 -27.859375 C 33.132812 -28.523438 33.640625 -29.351562 33.859375 -30.34375 L 33.984375 -30.96875 C 34.191406 -31.914062 34.0625 -32.71875 33.59375 -33.375 C 33.125 -34.039062 32.441406 -34.375 31.546875 -34.375 Z M 29.25 -34.375 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(237.285815, 211.874986)"><g><path d="M 44.609375 -33.796875 L 25.015625 -1.03125 C 24.847656 -0.769531 24.703125 -0.507812 24.578125 -0.25 L 23.671875 -16.890625 L 32.0625 -33.796875 Z M 21.25 4.609375 C 19.03125 7.460938 16.585938 9.644531 13.921875 11.15625 C 11.253906 12.675781 8.148438 13.4375 4.609375 13.4375 C 1.835938 13.4375 -0.53125 13.050781 -2.5 12.28125 L -0.765625 4.671875 L 4.34375 4.671875 C 7.550781 4.671875 9.816406 3.113281 11.140625 0 L 5.5 -33.796875 L 19.203125 -33.796875 Z M 21.25 4.609375 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(276.387414, 211.874986)"><g><pathLine truncated

public/vite.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

settings.gradle.kts

@@ -0,0 +1,14 @@
+pluginManagement {
+    repositories {
+        gradlePluginPortal()
+        mavenCentral()
+    }
+}
+
+dependencyResolutionManagement {
+    repositories {
+        mavenCentral()
+    }
+}
+
+rootProject.name = "delta-force-guide-server"

src/api/auth-api.ts

@@ -1,13 +0,0 @@
-import { LoginRequest, User } from "@/types"
-import { WebClient } from "@/shared/web-client"
-
-export async function login(loginRequest: LoginRequest): Promise<User> {
-  const { data } = await WebClient.post<User>("/auth/login", {
-    ...loginRequest,
-  })
-  return data
-}
-
-export async function logout() {
-  await WebClient.get<void>("/auth/logout")
-}

src/api/firearm-api.ts

@@ -1,56 +0,0 @@
-import { AddFirearmRequest, Direction, Firearm, FirearmType, Page, PageQueryParams } from "@/types"
-import { WebClient } from "@/shared/web-client"
-import { asUrlSearchParam } from "@/utils/query-param-utils.ts"
-
-interface FirearmParams extends PageQueryParams {
-  type?: FirearmType
-}
-
-/**
- * 查询武器列表
- *
- * @param params 分页查询参数¬
- */
-export async function getFirearms(params?: FirearmParams): Promise<Page<Firearm>> {
-  let uri = "/firearms"
-  const urlSearchParam = asUrlSearchParam(params)
-
-  if (params?.type) {
-    urlSearchParam.append("type", params.type)
-  }
-
-  if (urlSearchParam.size > 0) {
-    uri = uri.concat("?", urlSearchParam.toString())
-  }
-
-  const { data } = await WebClient.get<Page<Firearm>>(uri)
-  return data
-}
-
-/**
- * 根据 ID 查询武器
- *
- * @param id 武器 ID
- */
-export async function getFirearm(id: number): Promise<Firearm> {
-  const { data } = await WebClient.get<Firearm>(`/firearms/${id}`)
-  return data
-}
-
-/**
- * 新建武器
- * @param request
- */
-export async function addFirearm(request: AddFirearmRequest): Promise<Firearm> {
-  const { data } = await WebClient.post<Firearm>("/firearms", request)
-  return data
-}
-
-export async function editFirearm(id: number, request: AddFirearmRequest): Promise<Firearm> {
-  const { data } = await WebClient.put<Firearm>(`/firearms/${id}`, request)
-  return data
-}
-
-export async function removeFirearm(id: number) {
-  await WebClient.delete<void>(`/firearms/${id}`)
-}

src/api/index.ts

@@ -1,4 +0,0 @@
-export * as FirearmApi from "./firearm-api"
-export * as ModificationApi from "./modification-api"
-export * as TagApi from "./tag-api"
-export * as AuthApi from "./auth-api"

src/api/modification-api.ts

@@ -1,67 +0,0 @@
-import { Modification, ModificationRequest, Page, PageQueryParams } from "@/types"
-import { WebClient } from "@/shared/web-client"
-import { asUrlSearchParam } from "@/utils/query-param-utils.ts"
-
-interface ModificationParams extends PageQueryParams {
-  firearmId?: string
-  tags?: string[]
-}
-
-export async function getModifications(params?: ModificationParams): Promise<Page<Modification>> {
-  let uri = "/modifications"
-  const urlSearchParams = asUrlSearchParam(params)
-
-  if (params?.firearmId) {
-    urlSearchParams.append("firearmId", "" + params.firearmId)
-  }
-
-  if (params?.tags) {
-    params.tags.forEach((tag) => urlSearchParams.append("tags", tag))
-  }
-
-  if (urlSearchParams.size > 0) {
-    uri = uri.concat("?", urlSearchParams.toString())
-  }
-
-  const { data } = await WebClient.get<Page<Modification>>(uri)
-  return data
-}
-
-export async function getModification(id: number): Promise<Modification> {
-  const { data } = await WebClient.get<Modification>(`/modifications/${id}`)
-  return data
-}
-
-export async function addModification(modification: ModificationRequest): Promise<Modification> {
-  const { data } = await WebClient.post<Modification>("/modifications", modification)
-  return data
-}
-
-export async function addModifications(
-  modifications: ModificationRequest[]
-): Promise<Modification[]> {
-  const { data } = await WebClient.post<Modification[]>("/modifications/batch", {
-    modifications,
-  })
-  return data
-}
-
-export async function editModification(
-  id: number,
-  modification: ModificationRequest
-): Promise<Modification> {
-  const { data } = await WebClient.put<Modification>(`/modifications/${id}`, modification)
-  return data
-}
-
-export async function removeModification(
-  id: number
-): Promise<void> {
-  await WebClient.delete(`/modifications/${id}`)
-}
-
-export async function removeModifications(ids: number[]) {
-  const urlSearchParams = new URLSearchParams()
-  ids.forEach((id) => urlSearchParams.append("ids", "" + id))
-  await WebClient.delete(`/modifications/batch-delete?${urlSearchParams.toString()}`)
-}

src/api/tag-api.ts

@@ -1,18 +0,0 @@
-import { WebClient } from "@/shared/web-client"
-
-export async function getTags(firearmId?: number): Promise<string[]> {
-  let uri = "/tags"
-
-  const urlSearchParam = new URLSearchParams()
-
-  if (firearmId) {
-    urlSearchParam.append("firearmId", "" + firearmId)
-  }
-
-  if (urlSearchParam.size > 0) {
-    uri = uri.concat("?", urlSearchParam.toString())
-  }
-
-  const { data } = await WebClient.get<string[]>(uri)
-  return data
-}

src/assets/OnixByte.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="500" zoomAndPan="magnify" viewBox="0 0 375 374.999991" height="500" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><g/></defs><rect x="-37.5" width="450" fill="#ffffff" y="-37.499999" height="449.999989" fill-opacity="1"/><rect x="-37.5" width="450" fill="#324370" y="-37.499999" height="449.999989" fill-opacity="1"/><g fill="#ffffff" fill-opacity="1"><g transform="translate(27.506677, 211.874986)"><g><path d="M 12.359375 -0.453125 C 8.003906 -1.816406 5.003906 -4.3125 3.359375 -7.9375 C 1.710938 -11.5625 1.550781 -16.253906 2.875 -22.015625 C 4.195312 -27.773438 6.519531 -32.46875 9.84375 -36.09375 C 13.175781 -39.71875 17.34375 -42.210938 22.34375 -43.578125 Z M 27.578125 -34.109375 L 30.015625 -44.796875 L 31.875 -44.796875 C 39.46875 -44.796875 44.882812 -42.851562 48.125 -38.96875 C 51.363281 -35.09375 52.128906 -29.441406 50.421875 -22.015625 C 48.722656 -14.585938 45.351562 -8.929688 40.3125 -5.046875 C 35.28125 -1.171875 28.96875 0.765625 21.375 0.765625 C 20.519531 0.765625 19.898438 0.742188 19.515625 0.703125 L 21.953125 -9.921875 C 22.722656 -9.835938 23.34375 -9.796875 23.8125 -9.796875 C 26.84375 -9.796875 29.367188 -10.710938 31.390625 -12.546875 C 33.421875 -14.378906 34.796875 -16.851562 35.515625 -19.96875 L 36.421875 -24.0625 C 37.140625 -27.175781 36.910156 -29.648438 35.734375 -31.484375 C 34.566406 -33.316406 32.46875 -34.234375 29.4375 -34.234375 C 28.96875 -34.234375 28.347656 -34.191406 27.578125 -34.109375 Z M 27.578125 -34.109375 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(80.815405, 211.874986)"><g><path d="M 31.171875 -34.5625 C 28.816406 -34.5625 26.363281 -34.003906 23.8125 -32.890625 L 21.953125 -24.890625 C 22.460938 -25.066406 23.0625 -25.15625 23.75 -25.15625 C 25.15625 -25.15625 26.125 -24.71875 26.65625 -23.84375 C 27.1875 -22.96875 27.28125 -21.804688 26.9375 -20.359375 L 22.265625 0 L 35 0 L 40.0625 -21.890625 C 41 -25.984375 40.726562 -29.117188 39.25 -31.296875 C 37.78125 -33.472656 35.085938 -34.5625 31.171875 -34.5625 Z M 17.28125 -19.96875 L 17.796875 -28.671875 L 18.171875 -33.796875 L 7.75 -33.796875 L -0.0625 0 L 12.671875 0 L 17.21875 -19.84375 Z M 17.28125 -19.96875 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(123.500788, 211.874986)"><g><path d="M 19.515625 -33.796875 L 11.703125 0 L -1.03125 0 L 6.78125 -33.796875 Z M 22.46875 -46.40625 L 20.484375 -37.765625 L 7.75 -37.765625 L 9.71875 -46.40625 Z M 22.46875 -46.40625 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(144.811483, 211.874986)"><g><path d="M 45.5625 -33.796875 L 29.953125 -17.59375 L 38.53125 0 L 23.671875 0 L 19.703125 -10.625 L 19.453125 -10.625 L 10.5625 0 L -3.578125 0 L 13.5625 -17.921875 L 5.5 -33.796875 L 20.484375 -33.796875 L 23.8125 -24.828125 L 24.0625 -24.828125 L 31.484375 -33.796875 Z M 45.5625 -33.796875 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(187.496867, 211.874986)"><g><path d="M 24 -44.03125 L 13.890625 0 L -0.25 0 L 9.859375 -44.03125 Z M 29.25 -34.375 L 31.421875 -44.03125 L 39.171875 -44.03125 C 42.578125 -44.03125 45.21875 -43.003906 47.09375 -40.953125 C 48.976562 -38.910156 49.554688 -36.332031 48.828125 -33.21875 C 47.585938 -27.800781 44.347656 -24.382812 39.109375 -22.96875 L 39.109375 -22.71875 C 44.390625 -21.4375 46.328125 -17.769531 44.921875 -11.71875 C 44.109375 -8.257812 42.21875 -5.441406 39.25 -3.265625 C 36.289062 -1.085938 33.019531 0 29.4375 0 L 21.3125 0 L 23.671875 -10.234375 L 27 -10.234375 C 27.601562 -10.234375 28.179688 -10.382812 28.734375 -10.6875 C 29.285156 -10.988281 29.765625 -11.40625 30.171875 -11.9375 C 30.578125 -12.46875 30.863281 -13.054688 31.03125 -13.703125 L 31.171875 -14.34375 C 31.421875 -15.320312 31.300781 -16.140625 30.8125 -16.796875 C 30.320312 -17.460938 29.628906 -17.796875 28.734375 -17.796875 L 25.40625 -17.796875 L 27.515625 -26.875 L 29.828125 -26.875 C 30.722656 -26.875 31.5625 -27.203125 32.34375 -27.859375 C 33.132812 -28.523438 33.640625 -29.351562 33.859375 -30.34375 L 33.984375 -30.96875 C 34.191406 -31.914062 34.0625 -32.71875 33.59375 -33.375 C 33.125 -34.039062 32.441406 -34.375 31.546875 -34.375 Z M 29.25 -34.375 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(237.285815, 211.874986)"><g><path d="M 44.609375 -33.796875 L 25.015625 -1.03125 C 24.847656 -0.769531 24.703125 -0.507812 24.578125 -0.25 L 23.671875 -16.890625 L 32.0625 -33.796875 Z M 21.25 4.609375 C 19.03125 7.460938 16.585938 9.644531 13.921875 11.15625 C 11.253906 12.675781 8.148438 13.4375 4.609375 13.4375 C 1.835938 13.4375 -0.53125 13.050781 -2.5 12.28125 L -0.765625 4.671875 L 4.34375 4.671875 C 7.550781 4.671875 9.816406 3.113281 11.140625 0 L 5.5 -33.796875 L 19.203125 -33.796875 Z M 21.25 4.609375 "/></g></g></g><g fill="#ffffff" fill-opacity="1"><g transform="translate(276.387414, 211.874986)"><g><pathLine truncated

src/assets/react.svg

@@ -1,6 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"
-     aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32"
-     preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228">
-    <path fill="#00D8FF"
-          d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z" />
-</svg>

src/components/error-page/index.tsx

@@ -1,69 +0,0 @@
-import { useRouteError, Link } from "react-router-dom"
-
-/**
- * Error page component that displays when routing errors occur.
- * Uses React Router's useRouteError hook to get error information.
- */
-export default function ErrorPage() {
-  const error = useRouteError() as Error & { statusText?: string; status?: number }
-
-  return (
-    <div className="min-h-screen bg-gray-50 flex flex-col justify-center py-12 sm:px-6 lg:px-8">
-      <div className="sm:mx-auto sm:w-full sm:max-w-md">
-        <div className="bg-white py-8 px-4 shadow sm:rounded-lg sm:px-10">
-          <div className="text-center">
-            {/* Error Icon */}
-            <div className="mx-auto flex items-center justify-center h-12 w-12 rounded-full bg-red-100">
-              <svg
-                className="h-6 w-6 text-red-600"
-                fill="none"
-                viewBox="0 0 24 24"
-                stroke="currentColor"
-              >
-                <path
-                  strokeLinecap="round"
-                  strokeLinejoin="round"
-                  strokeWidth={2}
-                  d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.964-.833-2.732 0L3.732 16.5c-.77.833.192 2.5 1.732 2.5z"
-                />
-              </svg>
-            </div>
-
-            {/* Error Title */}
-            <h1 className="mt-4 text-2xl font-bold text-gray-900">
-              页面出现错误
-            </h1>
-
-            {/* Error Message */}
-            <div className="mt-4">
-              <p className="text-sm text-gray-600">
-                {error?.statusText ?? error?.message ?? "发生了未预期的错误"}
-              </p>
-              {error?.status && (
-                <p className="text-xs text-gray-500 mt-1">
-                  错误代码：{error.status}
-                </p>
-              )}
-            </div>
-
-            {/* Action Buttons */}
-            <div className="mt-6 flex flex-col space-y-3">
-              <Link
-                to="/"
-                className="w-full flex justify-center py-2 px-4 border border-transparent rounded-md shadow-sm text-sm font-medium text-white bg-blue-600 hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500"
-              >
-                返回首页
-              </Link>
-              <button
-                onClick={() => window.history.back()}
-                className="w-full flex justify-center py-2 px-4 border border-gray-300 rounded-md shadow-sm text-sm font-medium text-gray-700 bg-white hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500"
-              >
-                返回上一页
-              </button>
-            </div>
-          </div>
-        </div>
-      </div>
-    </div>
-  )
-}

src/components/firearm-create-modal/index.tsx

@@ -1,58 +0,0 @@
-import { useState } from "react"
-import { App, Form, Modal } from "antd"
-import { FirearmApi } from "@/api"
-import FirearmForm from "@/components/firearm-form"
-import { AddFirearmRequest, Firearm } from "@/types"
-
-interface FirearmCreateModalProps {
-  open: boolean
-  onCancel: () => void
-  onSuccess: (firearm: Firearm) => void
-}
-
-function normalizeRequest(values: AddFirearmRequest): AddFirearmRequest {
-  return {
-    ...values,
-    review: values.review?.trim() || null,
-  }
-}
-
-export default function FirearmCreateModal({ open, onCancel, onSuccess }: FirearmCreateModalProps) {
-  const { message } = App.useApp()
-  const [form] = Form.useForm<AddFirearmRequest>()
-  const [loading, setLoading] = useState(false)
-
-  async function onFinish(values: AddFirearmRequest) {
-    setLoading(true)
-    try {
-      const firearm = await FirearmApi.addFirearm(normalizeRequest(values))
-      message.success("武器创建成功")
-      form.resetFields()
-      onSuccess(firearm)
-    } catch {
-      message.error("武器创建失败，请稍后重试")
-    } finally {
-      setLoading(false)
-    }
-  }
-
-  return (
-    <Modal
-      title="新建武器"
-      open={open}
-      onCancel={onCancel}
-      onOk={() => form.submit()}
-      okText="创建"
-      cancelText="取消"
-      confirmLoading={loading}
-      destroyOnHidden
-      afterOpenChange={(visible) => {
-        if (!visible) {
-          form.resetFields()
-        }
-      }}>
-      <FirearmForm form={form} onFinish={onFinish} />
-    </Modal>
-  )
-}
-

src/components/firearm-edit-modal/index.tsx

@@ -1,67 +0,0 @@
-import { useEffect, useState } from "react"
-import { App, Form, Modal } from "antd"
-import { FirearmApi } from "@/api"
-import FirearmForm from "@/components/firearm-form"
-import { AddFirearmRequest, Firearm } from "@/types"
-
-interface FirearmEditModalProps {
-  open: boolean
-  firearm: Firearm | null
-  onCancel: () => void
-  onSuccess: (firearm: Firearm) => void
-}
-
-function normalizeRequest(values: AddFirearmRequest): AddFirearmRequest {
-  return {
-    ...values,
-    review: values.review?.trim() || null,
-  }
-}
-
-export default function FirearmEditModal({ open, firearm, onCancel, onSuccess }: FirearmEditModalProps) {
-  const { message } = App.useApp()
-  const [form] = Form.useForm<AddFirearmRequest>()
-  const [loading, setLoading] = useState(false)
-
-  useEffect(() => {
-    if (!open || !firearm) {
-      return
-    }
-
-    const { id: _id, ...editableValues } = firearm
-    form.setFieldsValue(editableValues)
-  }, [open, firearm, form])
-
-  async function onFinish(values: AddFirearmRequest) {
-    if (!firearm) {
-      return
-    }
-
-    setLoading(true)
-    try {
-      const updated = await FirearmApi.editFirearm(firearm.id, normalizeRequest(values))
-      message.success("武器更新成功")
-      onSuccess(updated)
-    } catch {
-      message.error("武器更新失败，请稍后重试")
-    } finally {
-      setLoading(false)
-    }
-  }
-
-  return (
-    <Modal
-      title="编辑武器"
-      open={open}
-      onCancel={onCancel}
-      onOk={() => form.submit()}
-      okText="保存"
-      cancelText="取消"
-      confirmLoading={loading}
-      destroyOnHidden
-    >
-      <FirearmForm form={form} onFinish={onFinish} />
-    </Modal>
-  )
-}
-

src/components/firearm-form/index.tsx

@@ -1,101 +0,0 @@
-import { Form, Input, InputNumber, Select } from "antd"
-import { AddFirearmRequest, FirearmType } from "@/types"
-import calibres from "@/constant/calibres.json"
-
-const firearmTypeText: Record<FirearmType, string> = {
-  RIFLE: "步枪",
-  SUB_MACHINE_GUN: "冲锋枪",
-  SHOTGUN: "霰弹枪",
-  LIGHT_MACHINE_GUN: "轻机枪",
-  DESIGNATED_MARKSMAN_RIFLE: "射手步枪",
-  SNIPER_RIFLE: "狙击步枪",
-  PISTOL: "手枪",
-  SPECIAL: "特殊",
-}
-
-const calibreOptions = calibres.map((calibre) => ({
-  value: calibre,
-  label: calibre,
-}))
-
-interface FirearmFormProps {
-  form: ReturnType<typeof Form.useForm<AddFirearmRequest>>[0]
-  onFinish: (values: AddFirearmRequest) => void
-}
-
-export default function FirearmForm({ form, onFinish }: FirearmFormProps) {
-  return (
-    <Form<AddFirearmRequest> form={form} layout="vertical" onFinish={onFinish} requiredMark={false}>
-      <Form.Item<AddFirearmRequest>
-        name="name"
-        label="武器名称"
-        rules={[{ required: true, message: "请输入武器名称" }]}
-      >
-        <Input placeholder="请输入武器名称" />
-      </Form.Item>
-
-      <Form.Item<AddFirearmRequest>
-        name="type"
-        label="武器类型"
-        rules={[{ required: true, message: "请选择武器类型" }]}
-      >
-        <Select
-          placeholder="请选择武器类型"
-          options={Object.entries(firearmTypeText).map(([value, label]) => ({
-            value,
-            label,
-          }))}
-        />
-      </Form.Item>
-
-      <Form.Item<AddFirearmRequest>
-        name="level"
-        label="武器输出等级"
-        rules={[{ required: true, message: "请输入武器输出等级" }]}
-      >
-        <Input placeholder="例如：T0" />
-      </Form.Item>
-
-      <Form.Item<AddFirearmRequest>
-        name="calibre"
-        label="子弹口径"
-        rules={[{ required: true, message: "请选择子弹口径" }]}
-      >
-        <Select
-          placeholder="请选择子弹口径"
-          showSearch
-          optionFilterProp="label"
-          options={calibreOptions}
-        />
-      </Form.Item>
-
-      <Form.Item<AddFirearmRequest>
-        name="fireRate"
-        label="射速（每分钟发数）"
-        rules={[{ required: true, message: "请输入射速" }]}
-      >
-        <InputNumber className="w-full" min={1} precision={0} placeholder="请输入射速" />
-      </Form.Item>
-
-      <Form.Item<AddFirearmRequest>
-        name="armourDamage"
-        label="甲伤"
-        rules={[{ required: true, message: "请输入甲伤" }]}
-      >
-        <InputNumber className="w-full" min={0} precision={0} placeholder="请输入甲伤" />
-      </Form.Item>
-
-      <Form.Item<AddFirearmRequest>
-        name="bodyDamage"
-        label="肉伤"
-        rules={[{ required: true, message: "请输入肉伤" }]}
-      >
-        <InputNumber className="w-full" min={0} precision={0} placeholder="请输入肉伤" />
-      </Form.Item>
-
-      <Form.Item<AddFirearmRequest> name="review" label="描述">
-        <Input.TextArea rows={4} placeholder="可选：补充武器特点或使用建议" />
-      </Form.Item>
-    </Form>
-  )
-}

src/components/modification-create-modal/index.tsx

@@ -1,97 +0,0 @@
-import { useEffect, useState } from "react"
-import { App, Form, Modal } from "antd"
-import { ModificationApi } from "@/api"
-import ModificationForm from "@/components/modification-form"
-import { Modification, ModificationRequest } from "@/types"
-
-interface ModificationCreateModalProps {
-  open: boolean
-  defaultFirearmId?: number
-  lockedFirearmId?: number
-  onCancel: () => void
-  onSuccess: (modification: Modification) => void
-}
-
-function normalizeRequest(values: ModificationRequest): ModificationRequest {
-  return {
-    firearmId: values.firearmId,
-    name: values.name.trim(),
-    code: values.code.trim(),
-    tags: values.tags?.map((tag) => tag.trim()).filter(Boolean) || [],
-    note: values.note?.trim() || undefined,
-    author: values.author?.trim() || undefined,
-    videoUrl: values.videoUrl?.trim() || undefined,
-    accessories: (values.accessories || []).map((accessory) => ({
-      slotName: accessory.slotName.trim(),
-      accessoryName: accessory.accessoryName.trim(),
-      tunings: (accessory.tunings || []).map((tuning) => ({
-        tuningName: tuning.tuningName.trim(),
-        tuningValue: tuning.tuningValue,
-      })),
-    })),
-  }
-}
-
-export default function ModificationCreateModal({
-  open,
-  defaultFirearmId,
-  lockedFirearmId,
-  onCancel,
-  onSuccess,
-}: ModificationCreateModalProps) {
-  const { message } = App.useApp()
-  const [form] = Form.useForm<ModificationRequest>()
-  const [loading, setLoading] = useState(false)
-
-  useEffect(() => {
-    if (!open) {
-      return
-    }
-
-    form.setFieldsValue({
-      firearmId: lockedFirearmId ?? defaultFirearmId,
-      accessories: [],
-      tags: [],
-    })
-  }, [open, defaultFirearmId, lockedFirearmId, form])
-
-  async function onFinish(values: ModificationRequest) {
-    setLoading(true)
-    try {
-      const modification = await ModificationApi.addModification(
-        normalizeRequest({
-          ...values,
-          firearmId: lockedFirearmId ?? values.firearmId,
-        })
-      )
-      message.success("改枪码创建成功")
-      form.resetFields()
-      onSuccess(modification)
-    } catch {
-      message.error("改枪码创建失败，请稍后重试")
-    } finally {
-      setLoading(false)
-    }
-  }
-
-  return (
-    <Modal
-      title="新建改枪"
-      open={open}
-      onCancel={onCancel}
-      onOk={() => form.submit()}
-      okText="创建"
-      cancelText="取消"
-      confirmLoading={loading}
-      width={820}
-      destroyOnHidden
-      afterOpenChange={(visible) => {
-        if (!visible) {
-          form.resetFields()
-        }
-      }}
-    >
-      <ModificationForm form={form} onFinish={onFinish} lockFirearmId={lockedFirearmId} />
-    </Modal>
-  )
-}

src/components/modification-edit-modal/index.tsx

@@ -1,100 +0,0 @@
-import { useEffect, useState } from "react"
-import { App, Form, Modal } from "antd"
-import { ModificationApi } from "@/api"
-import ModificationForm from "@/components/modification-form"
-import { Modification, ModificationRequest } from "@/types"
-
-interface ModificationEditModalProps {
-  open: boolean
-  modification: Modification | null
-  lockedFirearmId?: number
-  onCancel: () => void
-  onSuccess: (modification: Modification) => void
-}
-
-function normalizeRequest(values: ModificationRequest): ModificationRequest {
-  return {
-    firearmId: values.firearmId,
-    name: values.name.trim(),
-    code: values.code.trim(),
-    tags: values.tags?.map((tag) => tag.trim()).filter(Boolean) || [],
-    note: values.note?.trim() || undefined,
-    author: values.author?.trim() || undefined,
-    videoUrl: values.videoUrl?.trim() || undefined,
-    accessories: (values.accessories || []).map((accessory) => ({
-      slotName: accessory.slotName.trim(),
-      accessoryName: accessory.accessoryName.trim(),
-      tunings: (accessory.tunings || []).map((tuning) => ({
-        tuningName: tuning.tuningName.trim(),
-        tuningValue: tuning.tuningValue,
-      })),
-    })),
-  }
-}
-
-export default function ModificationEditModal({
-  open,
-  modification,
-  lockedFirearmId,
-  onCancel,
-  onSuccess,
-}: ModificationEditModalProps) {
-  const { message } = App.useApp()
-  const [form] = Form.useForm<ModificationRequest>()
-  const [loading, setLoading] = useState(false)
-
-  useEffect(() => {
-    if (!open || !modification) {
-      return
-    }
-
-    const { id: _id, ...editableValues } = modification
-    form.setFieldsValue({
-      ...editableValues,
-      firearmId: lockedFirearmId ?? editableValues.firearmId,
-      tags: editableValues.tags || [],
-      accessories: editableValues.accessories || [],
-    })
-  }, [open, modification, lockedFirearmId, form])
-
-  async function onFinish(values: ModificationRequest) {
-    if (!modification) {
-      return
-    }
-
-    setLoading(true)
-    try {
-      const updated = await ModificationApi.editModification(
-        modification.id,
-        normalizeRequest({
-          ...values,
-          firearmId: lockedFirearmId ?? values.firearmId,
-        })
-      )
-      message.success("改枪码更新成功")
-      onSuccess(updated)
-    } catch {
-      message.error("改枪码更新失败，请稍后重试")
-    } finally {
-      setLoading(false)
-    }
-  }
-
-  return (
-    <Modal
-      title="编辑改枪"
-      open={open}
-      onCancel={onCancel}
-      onOk={() => form.submit()}
-      okText="保存"
-      cancelText="取消"
-      confirmLoading={loading}
-      width={820}
-      destroyOnHidden
-    >
-      <ModificationForm form={form} onFinish={onFinish} lockFirearmId={lockedFirearmId} />
-    </Modal>
-  )
-}
-
-

src/components/modification-form/index.tsx

@@ -1,217 +0,0 @@
-import { useEffect, useMemo, useState } from "react"
-import { FirearmApi } from "@/api"
-import slotNames from "@/constant/slots.json"
-import tuningNames from "@/constant/tunings.json"
-import { Firearm, ModificationRequest } from "@/types"
-import { AutoComplete, Button, Card, Form, Input, InputNumber, Select, Space } from "antd"
-
-interface ModificationFormProps {
-  form: ReturnType<typeof Form.useForm<ModificationRequest>>[0]
-  onFinish: (values: ModificationRequest) => void
-  lockFirearmId?: number
-}
-
-const slotOptions = slotNames.map((slotName) => ({ value: slotName }))
-const tuningOptions = tuningNames.map((tuningName) => ({ value: tuningName }))
-
-export default function ModificationForm({ form, onFinish, lockFirearmId }: ModificationFormProps) {
-  const [firearmOptions, setFirearmOptions] = useState<Array<{ value: number; label: string }>>([])
-  const [firearmLoading, setFirearmLoading] = useState(false)
-
-  useEffect(() => {
-    let active = true
-
-    async function loadAllFirearms() {
-      setFirearmLoading(true)
-      try {
-        const allFirearms: Firearm[] = []
-        let page = 0
-        let totalPages = 1
-
-        while (page < totalPages) {
-          const paged = await FirearmApi.getFirearms({
-            page,
-            size: 100,
-            sortBy: "id",
-            direction: "ASC",
-          })
-
-          allFirearms.push(...paged.items)
-          totalPages = paged.totalPages
-          page += 1
-        }
-
-        if (!active) {
-          return
-        }
-
-        setFirearmOptions(
-          allFirearms.map((firearm) => ({
-            value: firearm.id,
-            label: `${firearm.name}`,
-          }))
-        )
-      } finally {
-        if (active) {
-          setFirearmLoading(false)
-        }
-      }
-    }
-
-    void loadAllFirearms()
-
-    return () => {
-      active = false
-    }
-  }, [])
-
-  const mergedFirearmOptions = useMemo(() => {
-    if (
-      lockFirearmId === undefined ||
-      firearmOptions.some((option) => option.value === lockFirearmId)
-    ) {
-      return firearmOptions
-    }
-
-    return [{ value: lockFirearmId, label: `武器 ID: ${lockFirearmId}` }, ...firearmOptions]
-  }, [firearmOptions, lockFirearmId])
-
-  return (
-    <Form<ModificationRequest>
-      form={form}
-      layout="vertical"
-      onFinish={onFinish}
-      requiredMark={false}>
-      <Form.Item<ModificationRequest>
-        name="firearmId"
-        label="武器"
-        rules={[{ required: true, message: "请输入武器" }]}>
-        <Select<number>
-          className="w-full"
-          placeholder="请选择武器"
-          options={mergedFirearmOptions}
-          loading={firearmLoading}
-          disabled={lockFirearmId !== undefined}
-          showSearch={{
-            filterOption: (input, option) => {
-              const labelText = String(option?.label ?? "")
-              return labelText.toLowerCase().includes(input.toLowerCase())
-            },
-          }}
-        />
-      </Form.Item>
-
-      <Form.Item<ModificationRequest>
-        name="name"
-        label="改装名称"
-        rules={[{ required: true, message: "请输入改装名称" }]}>
-        <Input placeholder="请输入改装名称" />
-      </Form.Item>
-
-      <Form.Item<ModificationRequest>
-        name="code"
-        label="改枪码"
-        rules={[{ required: true, message: "请输入改枪码" }]}>
-        <Input placeholder="请输入改枪码" />
-      </Form.Item>
-
-      <Form.Item<ModificationRequest> name="tags" label="标签">
-        <Select mode="tags" tokenSeparators={[",", " "]} placeholder="可选：输入后回车" />
-      </Form.Item>
-
-      <Form.Item<ModificationRequest> name="author" label="作者">
-        <Input placeholder="可选：请输入作者" />
-      </Form.Item>
-
-      <Form.Item<ModificationRequest> name="videoUrl" label="视频链接">
-        <Input placeholder="可选：请输入视频链接" />
-      </Form.Item>
-
-      <Form.Item<ModificationRequest> name="note" label="备注">
-        <Input.TextArea rows={3} placeholder="可选：补充说明" />
-      </Form.Item>
-
-      <Form.List name="accessories">
-        {(accessoryFields, { add: addAccessory, remove: removeAccessory }) => (
-          <div className="flex flex-col gap-4">
-            {accessoryFields.map((accessoryField) => (
-              <Card
-                key={accessoryField.key}
-                title={`配件 ${accessoryField.name + 1}`}
-                size="small"
-                extra={
-                  <Button
-                    danger
-                    type="link"
-                    size="small"
-                    onClick={() => removeAccessory(accessoryField.name)}>
-                    删除配件
-                  </Button>
-                }>
-                <Form.Item
-                  name={[accessoryField.name, "slotName"]}
-                  label="槽位"
-                  rules={[{ required: true, message: "请选择或输入槽位" }]}>
-                  <AutoComplete options={slotOptions} placeholder="请选择或输入槽位" />
-                </Form.Item>
-
-                <Form.Item
-                  name={[accessoryField.name, "accessoryName"]}
-                  label="配件名称"
-                  rules={[{ required: true, message: "请输入配件名称" }]}>
-                  <Input placeholder="请输入配件名称" />
-                </Form.Item>
-
-                <Form.List name={[accessoryField.name, "tunings"]}>
-                  {(tuningFields, { add: addTuning, remove: removeTuning }) => (
-                    <div className="flex flex-col gap-3">
-                      {tuningFields.map((tuningField) => (
-                        <Space key={tuningField.key} align="start" className="w-full" wrap>
-                          <Form.Item
-                            name={[tuningField.name, "tuningName"]}
-                            label="精校属性"
-                            rules={[{ required: true, message: "请选择或输入精校属性" }]}>
-                            <AutoComplete
-                              options={tuningOptions}
-                              placeholder="例如：后坐控制"
-                              className="w-44"
-                            />
-                          </Form.Item>
-                          <Form.Item
-                            name={[tuningField.name, "tuningValue"]}
-                            label="精校值"
-                            rules={[{ required: true, message: "请输入精校值" }]}>
-                            <InputNumber className="w-32" placeholder="例如：0.35" />
-                          </Form.Item>
-                          <Button
-                            type="link"
-                            danger
-                            className="mt-8"
-                            onClick={() => removeTuning(tuningField.name)}>
-                            删除
-                          </Button>
-                        </Space>
-                      ))}
-                      <Button
-                        type="dashed"
-                        disabled={tuningFields.length >= 2}
-                        onClick={() => addTuning({ tuningName: "", tuningValue: 0 })}>
-                        添加精校
-                      </Button>
-                    </div>
-                  )}
-                </Form.List>
-              </Card>
-            ))}
-            <Button
-              variant="solid"
-              color="lime"
-              onClick={() => addAccessory({ slotName: "", accessoryName: "", tunings: [] })}>
-              添加配件
-            </Button>
-          </div>
-        )}
-      </Form.List>
-    </Form>
-  )
-}

src/constant/calibres.json

@@ -1,23 +0,0 @@
-[
-  ".338 Lap Mag",
-  ".357 Magnum",
-  ".45 ACP",
-  ".50 AE",
-  ".50 BMG",
-  "12 Gauge",
-  "12.7x55mm",
-  "5.45x39mm",
-  "5.56x45mm",
-  "5.7x28mm",
-  "5.8x42mm",
-  "6.8x51mm",
-  "7.62x39mm",
-  "7.62x51mm",
-  "7.62x54mm",
-  "9x19mm",
-  "9x39mm",
-  "4.6x30mm",
-  ".300 BLK",
-  "箭矢",
-  "45-70 Govt"
-]

src/constant/slots.json

@@ -1,23 +0,0 @@
-[
-  "枪口",
-  "左导轨",
-  "右导轨",
-  "枪管",
-  "左贴片",
-  "右贴片",
-  "上导轨",
-  "上贴片",
-  "下导轨",
-  "瞄准镜",
-  "战术设备",
-  "增高座瞄具",
-  "侧瞄具",
-  "枪托",
-  "枪托套件",
-  "后握把",
-  "前握把",
-  "导轨脚架",
-  "弹匣座",
-  "弹匣",
-  "托腮板"
-]

src/constant/tunings.json

@@ -1 +0,0 @@
-["安装位置", "厚度", "缩放倍率", "长度", "瞳距", "配重", "托腮板安装位置"]

src/index.css

@@ -1,36 +0,0 @@
-@layer theme, base, antd, components, utilities;
-
-@import 'tailwindcss';
-
-html, body {
-  margin: 0;
-  padding: 0;
-  width: 100%;
-}
-
-#root {
-  width: 100%;
-}
-
-.mod-codes-grid {
-  display: grid;
-  grid-template-columns: repeat(1, minmax(0, 1fr));
-}
-
-@media (min-width: 640px) {
-  .mod-codes-grid {
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-  }
-}
-
-@media (min-width: 1024px) {
-  .mod-codes-grid {
-    grid-template-columns: repeat(3, minmax(0, 1fr));
-  }
-}
-
-@media (min-width: 1280px) {
-  .mod-codes-grid {
-    grid-template-columns: repeat(4, minmax(0, 1fr));
-  }
-}

src/layout/empty-layout/index.tsx

@@ -1,13 +0,0 @@
-import { Outlet } from "react-router-dom"
-
-/**
- * Empty layout component that provides minimal structure.
- * Useful for pages that need full control over their layout.
- */
-export default function EmptyLayout() {
-  return (
-    <div className="min-h-screen">
-      <Outlet />
-    </div>
-  )
-}

src/layout/hero-layout/index.tsx

@@ -1,106 +0,0 @@
-import { Outlet, Link } from "react-router-dom"
-import { useMemo } from "react"
-import dayjs from "dayjs"
-import { Dropdown } from "antd"
-import { AuthApi } from "@/api"
-import { useAppDispatch, useAppSelector } from "@/store"
-import { clearCurrentUser } from "@/store/auth-slice"
-
-/**
- * Main application component that serves as the root layout.
- * Uses React Router's Outlet to render child routes.
- */
-export default function HeroLayout() {
-  const today = useMemo(() => dayjs(), [])
-  const user = useAppSelector((state) => state.auth.user)
-  const dispatch = useAppDispatch()
-
-  async function handleLogout() {
-    try {
-      await AuthApi.logout()
-    } finally {
-      dispatch(clearCurrentUser())
-    }
-  }
-
-  return (
-    <div className="bg-gray-50">
-      {/* Navigation Header */}
-      <header className="bg-white shadow-sm border-b">
-        <div className="max-w-screen-2xl mx-auto px-4 sm:px-6 lg:px-10">
-          <div className="flex justify-between items-center h-16">
-            <div className="flex items-center">
-              <h1 className="text-xl font-semibold text-gray-900">
-                三角洲行动改枪码库
-              </h1>
-            </div>
-            <nav className="flex space-x-8">
-              <Link
-                to="/firearms"
-                className="text-gray-500 hover:text-gray-900 px-3 py-2 rounded-md text-sm font-medium"
-              >
-                武器列表
-              </Link>
-              <Link
-                to="/mod-codes"
-                className="text-gray-500 hover:text-gray-900 px-3 py-2 rounded-md text-sm font-medium"
-              >
-                改枪码
-              </Link>
-              {user ? (
-                <Dropdown
-                  trigger={["hover"]}
-                  menu={{
-                    items: [
-                      {
-                        key: "logout",
-                        label: "退出登录",
-                        danger: true,
-                        onClick: handleLogout,
-                      },
-                    ],
-                  }}
-                >
-                  <span className="cursor-pointer text-gray-700 px-3 py-2 rounded-md text-sm font-medium">
-                    {user.username}
-                  </span>
-                </Dropdown>
-              ) : (
-                <Link
-                  to="/login"
-                  className="text-gray-500 hover:text-gray-900 px-3 py-2 rounded-md text-sm font-medium"
-                >
-                  登录
-                </Link>
-              )}
-              <a
-                href="https://github.com/zihluwang/delta-force-firearm-modification-codes"
-                target="_blank"
-                rel="noopener noreferrer"
-                className="text-gray-500 hover:text-gray-900 px-3 py-2 rounded-md text-sm font-medium"
-              >
-                GitHub
-              </a>
-            </nav>
-          </div>
-        </div>
-      </header>
-
-      {/* Main Content Area */}
-      <main className="max-w-screen-2xl mx-auto py-6 sm:px-6 lg:px-10">
-        <div className="px-4 py-6 sm:px-0">
-          <Outlet />
-        </div>
-      </main>
-
-      {/* Footer */}
-      <footer className="bg-white border-t">
-        <div className="max-w-screen-2xl mx-auto py-4 px-4 sm:px-6 lg:px-10">
-          <p className="text-center text-sm text-gray-500">
-            © 2024-{today.year()} Zihlu Wang 和 OnixByte。使用 React 与 TypeScript 构建。
-          </p>
-        </div>
-      </footer>
-    </div>
-  )
-}

src/main.tsx

@@ -1,35 +0,0 @@
-import { StrictMode } from "react"
-import { createRoot } from "react-dom/client"
-import { RouterProvider } from "react-router-dom"
-import { Provider } from "react-redux"
-import { PersistGate } from "redux-persist/integration/react"
-import { App as AntApp, ConfigProvider as AntConfigProvider } from "antd"
-import { StyleProvider as AntStyleProvider } from "@ant-design/cssinjs"
-import AntSimplifiedChinese from "antd/locale/zh_CN"
-import router from "@/router"
-import store, { persistor } from "@/store"
-import "./index.css"
-
-/**
- * Main application entry point.
- * Sets up the React app with React Router.
- */
-createRoot(document.getElementById("root")!).render(
-  <StrictMode>
-    <Provider store={store}>
-      <PersistGate loading={null} persistor={persistor}>
-        <AntStyleProvider layer>
-          <AntConfigProvider
-            locale={AntSimplifiedChinese}
-            button={{
-              autoInsertSpace: false,
-            }}>
-            <AntApp className="h-full w-full">
-              <RouterProvider router={router} />
-            </AntApp>
-          </AntConfigProvider>
-        </AntStyleProvider>
-      </PersistGate>
-    </Provider>
-  </StrictMode>
-)

src/main/java/com/onixbyte/deltaforceguide/DeltaForceGuideApplication.java

@@ -0,0 +1,13 @@
+package com.onixbyte.deltaforceguide;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class DeltaForceGuideApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(DeltaForceGuideApplication.class, args);
+    }
+
+}

src/main/java/com/onixbyte/deltaforceguide/config/CacheConfig.java

@@ -0,0 +1,102 @@
+package com.onixbyte.deltaforceguide.config;
+
+import com.onixbyte.deltaforceguide.shared.JacksonRedisSerialiser;
+import org.springframework.cache.annotation.EnableCaching;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.data.redis.cache.RedisCacheConfiguration;
+import org.springframework.data.redis.cache.RedisCacheManager;
+import org.springframework.data.redis.connection.RedisConnectionFactory;
+import org.springframework.data.redis.core.RedisTemplate;
+import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer;
+import org.springframework.data.redis.serializer.RedisSerializationContext;
+import org.springframework.data.redis.serializer.RedisSerializer;
+
+import java.time.Duration;
+
+/**
+ * Configuration class for Redis-based caching components.
+ * <p>
+ * This configuration class provides beans for Redis cache management and template operations
+ * within the Helix application. It configures custom serialisation strategies using
+ * {@link GenericJackson2JsonRedisSerializer} for values and string serialisation for keys,
+ * ensuring optimal performance and compatibility with JSON-based data structures.
+ * <p>
+ * The configuration includes:
+ * <ul>
+ *   <li>Custom {@link RedisCacheManager} with JSON serialisation support</li>
+ *   <li>Configured {@link RedisTemplate} for direct Redis operations</li>
+ * </ul>
+ *
+ * @author zihluwang
+ * @see RedisCacheManager
+ * @see RedisTemplate
+ * @see GenericJackson2JsonRedisSerializer
+ * @since 1.0.0
+ */
+@Configuration
+@EnableCaching
+public class CacheConfig {
+
+    /**
+     * Creates a custom Redis cache manager with JSON serialisation support.
+     * <p>
+     * This method configures a {@link RedisCacheManager} that uses string serialisation for cache
+     * keys and {@link GenericJackson2JsonRedisSerializer} for cache values. This setup ensures that
+     * complex objects can be stored and retrieved from Redis cache whilst maintaining readability
+     * and compatibility with JSON-based systems.
+     *
+     * @param connectionFactory the Redis connection factory used to establish connections
+     * @return a configured {@link RedisCacheManager} with custom serialisation settings
+     * @see RedisCacheManager
+     * @see GenericJackson2JsonRedisSerializer
+     * @see RedisSerializationContext
+     */
+    @Bean
+    public RedisCacheManager cacheManager(
+            RedisConnectionFactory connectionFactory
+    ) {
+        var _keySerializer = RedisSerializer.string();
+
+        var cacheConfiguration = RedisCacheConfiguration.defaultCacheConfig()
+                .serializeKeysWith(RedisSerializationContext.SerializationPair
+                        .fromSerializer(_keySerializer))
+                .serializeValuesWith(RedisSerializationContext.SerializationPair
+                        .fromSerializer(JacksonRedisSerialiser.INSTANCE))
+                .entryTtl(Duration.ofMinutes(90L));
+
+        return RedisCacheManager.RedisCacheManagerBuilder
+                .fromConnectionFactory(connectionFactory)
+                .cacheDefaults(cacheConfiguration)
+                .build();
+    }
+
+    /**
+     * Creates a Redis template for direct Redis operations with custom serialisation.
+     * <p>
+     * This method configures a {@link RedisTemplate} that uses string serialisation for keys
+     * and {@link GenericJackson2JsonRedisSerializer} for values. This template provides low-level
+     * access to Redis operations whilst ensuring consistent serialisation strategies across
+     * the application.
+     * <p>
+     * The template is fully configured and ready for use after bean creation.
+     *
+     * @param connectionFactory the Redis connection factory used to establish connections
+     * @return a fully configured {@link RedisTemplate} for Redis operations
+     * @see RedisTemplate
+     * @see GenericJackson2JsonRedisSerializer
+     * @see RedisSerializer
+     */
+    @Bean
+    public RedisTemplate<String, Object> redisTemplate(
+            RedisConnectionFactory connectionFactory
+    ) {
+        var redisTemplate = new RedisTemplate<String, Object>();
+        redisTemplate.setConnectionFactory(connectionFactory);
+        redisTemplate.setKeySerializer(RedisSerializer.string());
+        redisTemplate.setValueSerializer(JacksonRedisSerialiser.INSTANCE);
+        redisTemplate.afterPropertiesSet();
+        return redisTemplate;
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/config/CorsConfig.java

@@ -0,0 +1,47 @@
+package com.onixbyte.deltaforceguide.config;
+
+import com.onixbyte.deltaforceguide.properties.CorsProperties;
+import org.springframework.boot.context.properties.EnableConfigurationProperties;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.http.HttpMethod;
+import org.springframework.web.servlet.config.annotation.CorsRegistry;
+import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
+
+import java.util.Optional;
+import java.util.stream.Stream;
+
+@Configuration
+@EnableConfigurationProperties({CorsProperties.class})
+public class CorsConfig implements WebMvcConfigurer {
+
+    private final CorsProperties properties;
+
+    public CorsConfig(CorsProperties properties) {
+        this.properties = properties;
+    }
+
+    @Override
+    public void addCorsMappings(CorsRegistry registry) {
+        registry.addMapping("/**")
+                .allowedOrigins(toSafeArray(properties.allowedOrigins()))
+                .allowedHeaders(toSafeArray(properties.allowedHeaders()))
+                .allowedMethods(toHttpMethodNames(properties.allowedMethods()))
+                .allowCredentials(properties.allowCredentials())
+                .maxAge(properties.maxAge().toSeconds())
+                .exposedHeaders(toSafeArray(properties.exposedHeaders()));
+    }
+
+    private static String[] toSafeArray(String[] values) {
+        return values == null ? new String[0] : values;
+    }
+
+    private static String[] toHttpMethodNames(HttpMethod[] methods) {
+        return Optional.ofNullable(methods)
+                .stream()
+                .flatMap(Stream::of)
+                .map(HttpMethod::name)
+                .toList()
+                .toArray(String[]::new);
+    }
+
+}

src/main/java/com/onixbyte/deltaforceguide/config/JacksonConfig.java

@@ -0,0 +1,20 @@
+package com.onixbyte.deltaforceguide.config;
+
+import com.fasterxml.jackson.databind.SerializationFeature;
+import com.onixbyte.deltaforceguide.shared.JacksonModules;
+import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class JacksonConfig {
+
+    @Bean
+    public Jackson2ObjectMapperBuilderCustomizer jacksonCustomiser() {
+        return (builder) -> {
+            builder.modules(JacksonModules.DATE_TIME_MODULE);
+            builder.featuresToDisable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
+        };
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/config/MyBatisConfig.java

@@ -0,0 +1,10 @@
+package com.onixbyte.deltaforceguide.config;
+
+import org.mybatis.spring.annotation.MapperScan;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+@MapperScan(basePackages = {"com.onixbyte.deltaforceguide.mapper"})
+public class MyBatisConfig {
+}
+

src/main/java/com/onixbyte/deltaforceguide/config/SpringDataConfig.java

@@ -0,0 +1,10 @@
+package com.onixbyte.deltaforceguide.config;
+
+import org.springframework.context.annotation.Configuration;
+import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
+
+@Configuration
+@EnableJpaRepositories(basePackages = {"com.onixbyte.deltaforceguide.repository"})
+public class SpringDataConfig {
+}
+

src/main/java/com/onixbyte/deltaforceguide/controller/FirearmController.java

@@ -0,0 +1,45 @@
+package com.onixbyte.deltaforceguide.controller;
+
+import com.onixbyte.deltaforceguide.domain.dto.FirearmResponse;
+import com.onixbyte.deltaforceguide.domain.dto.PageResponse;
+import com.onixbyte.deltaforceguide.enumeration.FirearmType;
+import com.onixbyte.deltaforceguide.service.FirearmService;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Sort;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@Validated
+@RestController
+@RequestMapping("/firearms")
+public class FirearmController {
+
+    private final FirearmService firearmService;
+
+    public FirearmController(FirearmService firearmService) {
+        this.firearmService = firearmService;
+    }
+
+    @GetMapping
+    public PageResponse<FirearmResponse> pageQuery(
+            @RequestParam(defaultValue = "0") @Min(0) int page,
+            @RequestParam(defaultValue = "20") @Min(1) @Max(100) int size,
+            @RequestParam(defaultValue = "id") String sortBy,
+            @RequestParam(defaultValue = "DESC") Sort.Direction direction,
+            @RequestParam(required = false) FirearmType type
+    ) {
+        return firearmService.pageQuery(type, PageRequest.of(page, size, Sort.by(direction, sortBy)));
+    }
+
+    @GetMapping("/{id}")
+    public FirearmResponse queryById(@PathVariable Long id) {
+        return firearmService.queryById(id);
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/controller/ModificationController.java

@@ -0,0 +1,45 @@
+package com.onixbyte.deltaforceguide.controller;
+
+import com.onixbyte.deltaforceguide.domain.dto.ModificationResponse;
+import com.onixbyte.deltaforceguide.domain.dto.PageResponse;
+import com.onixbyte.deltaforceguide.service.ModificationService;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.Positive;
+import org.springframework.data.domain.PageRequest;
+import org.springframework.data.domain.Sort;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+@Validated
+@RestController
+@RequestMapping("/modifications")
+public class ModificationController {
+
+    private final ModificationService modificationService;
+
+    public ModificationController(ModificationService modificationService) {
+        this.modificationService = modificationService;
+    }
+
+    @GetMapping
+    public PageResponse<ModificationResponse> pageQuery(
+            @RequestParam(defaultValue = "0") @Min(0) int page,
+            @RequestParam(defaultValue = "20") @Min(1) @Max(100) int size,
+            @RequestParam(required = false) @Positive Long firearmId,
+            @RequestParam(defaultValue = "id") String sortBy,
+            @RequestParam(defaultValue = "DESC") Sort.Direction direction
+    ) {
+        return modificationService.pageQuery(firearmId, PageRequest.of(page, size, Sort.by(direction, sortBy)));
+    }
+
+    @GetMapping("/{id}")
+    public ModificationResponse queryById(@PathVariable Long id) {
+        return modificationService.queryById(id);
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/domain/converter/FirearmTypeConverter.java

@@ -0,0 +1,21 @@
+package com.onixbyte.deltaforceguide.domain.converter;
+
+import com.onixbyte.deltaforceguide.enumeration.FirearmType;
+import jakarta.persistence.AttributeConverter;
+import jakarta.persistence.Converter;
+
+@Converter
+public class FirearmTypeConverter implements AttributeConverter<FirearmType, Integer> {
+
+    @Override
+    public Integer convertToDatabaseColumn(FirearmType attribute) {
+        return attribute == null ? null : attribute.getCode();
+    }
+
+    @Override
+    public FirearmType convertToEntityAttribute(Integer dbData) {
+        return FirearmType.fromCode(dbData);
+    }
+}
+
+

src/main/java/com/onixbyte/deltaforceguide/domain/dto/FirearmResponse.java

@@ -0,0 +1,23 @@
+package com.onixbyte.deltaforceguide.domain.dto;
+
+import com.onixbyte.deltaforceguide.domain.entity.Firearm;
+import com.onixbyte.deltaforceguide.enumeration.FirearmType;
+
+public record FirearmResponse(
+        Long id,
+        String name,
+        FirearmType type,
+        String level,
+        String review
+) {
+    public static FirearmResponse from(Firearm firearm) {
+        return new FirearmResponse(
+                firearm.getId(),
+                firearm.getName(),
+                firearm.getType(),
+                firearm.getLevel(),
+                firearm.getReview()
+        );
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/domain/dto/ModificationResponse.java

@@ -0,0 +1,30 @@
+package com.onixbyte.deltaforceguide.domain.dto;
+
+import com.onixbyte.deltaforceguide.domain.entity.Modification;
+
+import java.util.List;
+
+public record ModificationResponse(
+        Long id,
+        Long firearmId,
+        String name,
+        String code,
+        List<String> tags,
+        String note,
+        String author,
+        String videoUrl
+) {
+    public static ModificationResponse from(Modification modification) {
+        return new ModificationResponse(
+                modification.getId(),
+                modification.getFirearm().getId(),
+                modification.getName(),
+                modification.getCode(),
+                modification.getTags(),
+                modification.getNote(),
+                modification.getAuthor(),
+                modification.getVideoUrl()
+        );
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/domain/dto/PageResponse.java

@@ -0,0 +1,24 @@
+package com.onixbyte.deltaforceguide.domain.dto;
+
+import org.springframework.data.domain.Page;
+
+import java.util.List;
+
+public record PageResponse<T>(
+        List<T> items,
+        int page,
+        int size,
+        long totalElements,
+        int totalPages
+) {
+    public static <T> PageResponse<T> from(Page<T> source) {
+        return new PageResponse<>(
+                source.getContent(),
+                source.getNumber(),
+                source.getSize(),
+                source.getTotalElements(),
+                source.getTotalPages()
+        );
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/domain/entity/Firearm.java

@@ -0,0 +1,100 @@
+package com.onixbyte.deltaforceguide.domain.entity;
+
+import com.onixbyte.deltaforceguide.domain.converter.FirearmTypeConverter;
+import com.onixbyte.deltaforceguide.enumeration.FirearmType;
+import jakarta.persistence.CascadeType;
+import jakarta.persistence.Column;
+import jakarta.persistence.Convert;
+import jakarta.persistence.Entity;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.OneToMany;
+import jakarta.persistence.Table;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(name = "firearm")
+public class Firearm {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(name = "name", nullable = false, length = 64)
+    private String name;
+
+    @Column(name = "type", nullable = false)
+    @Convert(converter = FirearmTypeConverter.class)
+    private FirearmType type;
+
+    @Column(name = "level", nullable = false)
+    private String level;
+
+    @Column(name = "review", columnDefinition = "TEXT")
+    private String review;
+
+    @OneToMany(mappedBy = "firearm", cascade = CascadeType.ALL, orphanRemoval = true)
+    private List<Modification> modifications = new ArrayList<>();
+
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public FirearmType getType() {
+        return type;
+    }
+
+    public void setType(FirearmType type) {
+        this.type = type;
+    }
+
+    public String getLevel() {
+        return level;
+    }
+
+    public void setLevel(String level) {
+        this.level = level;
+    }
+
+    public String getReview() {
+        return review;
+    }
+
+    public void setReview(String review) {
+        this.review = review;
+    }
+
+    public List<Modification> getModifications() {
+        return modifications;
+    }
+
+    public void setModifications(List<Modification> modifications) {
+        this.modifications = modifications;
+    }
+
+    public void addModification(Modification modification) {
+        this.modifications.add(modification);
+        modification.setFirearm(this);
+    }
+
+    public void removeModification(Modification modification) {
+        this.modifications.remove(modification);
+        modification.setFirearm(null);
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/domain/entity/Modification.java

@@ -0,0 +1,120 @@
+package com.onixbyte.deltaforceguide.domain.entity;
+
+import io.hypersistence.utils.hibernate.type.json.JsonType;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.ForeignKey;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.Index;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.Table;
+import org.hibernate.annotations.Type;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Entity
+@Table(
+    name = "modification",
+    indexes = {
+        @Index(name = "idx_modification_firearm_id", columnList = "firearm_id")
+    }
+)
+public class Modification {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY, optional = false)
+    @JoinColumn(name = "firearm_id", nullable = false, foreignKey = @ForeignKey(name = "fk_modification_firearm"))
+    private Firearm firearm;
+
+    @Column(name = "name", nullable = false, length = 64)
+    private String name;
+
+    @Column(name = "code", nullable = false, length = 64)
+    private String code;
+
+    @Type(JsonType.class)
+    @Column(name = "tags", columnDefinition = "json")
+    private List<String> tags = new ArrayList<>();
+
+    @Column(name = "note", columnDefinition = "TEXT")
+    private String note;
+
+    @Column(name = "author", length = 64)
+    private String author;
+
+    @Column(name = "video_url", length = 512)
+    private String videoUrl;
+
+    public Long getId() {
+        return id;
+    }
+
+    public void setId(Long id) {
+        this.id = id;
+    }
+
+    public Firearm getFirearm() {
+        return firearm;
+    }
+
+    public void setFirearm(Firearm firearm) {
+        this.firearm = firearm;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getCode() {
+        return code;
+    }
+
+    public void setCode(String code) {
+        this.code = code;
+    }
+
+    public List<String> getTags() {
+        return tags;
+    }
+
+    public void setTags(List<String> tags) {
+        this.tags = tags;
+    }
+
+    public String getNote() {
+        return note;
+    }
+
+    public void setNote(String note) {
+        this.note = note;
+    }
+
+    public String getAuthor() {
+        return author;
+    }
+
+    public void setAuthor(String author) {
+        this.author = author;
+    }
+
+    public String getVideoUrl() {
+        return videoUrl;
+    }
+
+    public void setVideoUrl(String videoUrl) {
+        this.videoUrl = videoUrl;
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/enumeration/FirearmType.java

@@ -0,0 +1,37 @@
+package com.onixbyte.deltaforceguide.enumeration;
+
+public enum FirearmType {
+
+    RIFLE(0),
+    SUB_MACHINE_GUN(1),
+    SHOTGUN(2),
+    LIGHT_MACHINE_GUN(3),
+    DESIGNATED_MARKSMAN_RIFLE(4),
+    SNIPER_RIFLE(5),
+    PISTOL(6),
+    SPECIAL(7);
+
+    private final int code;
+
+    FirearmType(int code) {
+        this.code = code;
+    }
+
+    public int getCode() {
+        return code;
+    }
+
+    public static FirearmType fromCode(Integer code) {
+        if (code == null) {
+            return null;
+        }
+
+        for (FirearmType type : values()) {
+            if (type.code == code) {
+                return type;
+            }
+        }
+
+        throw new IllegalArgumentException("Unknown FirearmType code: " + code);
+    }
+}

src/main/java/com/onixbyte/deltaforceguide/properties/CorsProperties.java

@@ -0,0 +1,24 @@
+package com.onixbyte.deltaforceguide.properties;
+
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.boot.context.properties.bind.DefaultValue;
+import org.springframework.http.HttpMethod;
+
+import java.time.Duration;
+
+@ConfigurationProperties(prefix = "app.cors")
+public record CorsProperties(
+        @DefaultValue({"Content-Type", "Authorization"})
+        String[] allowedHeaders,
+        @DefaultValue({"GET", "POST", "PUT", "PATCH", "DELETE"})
+        HttpMethod[] allowedMethods,
+        String[] allowedOrigins,
+        boolean allowCredentials,
+        boolean allowPrivateNetwork,
+        @DefaultValue("PT2H")
+        Duration maxAge,
+        @DefaultValue({"Content-Type", "Authorization"})
+        String[] exposedHeaders
+) {
+}
+

src/main/java/com/onixbyte/deltaforceguide/repository/FirearmRepository.java

@@ -0,0 +1,15 @@
+package com.onixbyte.deltaforceguide.repository;
+
+import com.onixbyte.deltaforceguide.domain.entity.Firearm;
+import com.onixbyte.deltaforceguide.enumeration.FirearmType;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+@Repository
+public interface FirearmRepository extends JpaRepository<Firearm, Long> {
+
+	Page<Firearm> findAllByType(FirearmType type, Pageable pageable);
+}
+

src/main/java/com/onixbyte/deltaforceguide/repository/ModificationRepository.java

@@ -0,0 +1,26 @@
+package com.onixbyte.deltaforceguide.repository;
+
+import com.onixbyte.deltaforceguide.domain.entity.Modification;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.repository.EntityGraph;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import java.util.Optional;
+
+@Repository
+public interface ModificationRepository extends JpaRepository<Modification, Long> {
+
+    @EntityGraph(attributePaths = {"firearm"})
+    Page<Modification> findAllBy(Pageable pageable);
+
+    @EntityGraph(attributePaths = {"firearm"})
+    Page<Modification> findAllByFirearm_Id(Long firearmId, Pageable pageable);
+
+    @Override
+    @EntityGraph(attributePaths = {"firearm"})
+    Optional<Modification> findById(Long id);
+}
+
+

src/main/java/com/onixbyte/deltaforceguide/service/FirearmService.java

@@ -0,0 +1,40 @@
+package com.onixbyte.deltaforceguide.service;
+
+import com.onixbyte.deltaforceguide.domain.dto.FirearmResponse;
+import com.onixbyte.deltaforceguide.domain.dto.PageResponse;
+import com.onixbyte.deltaforceguide.domain.entity.Firearm;
+import com.onixbyte.deltaforceguide.enumeration.FirearmType;
+import com.onixbyte.deltaforceguide.repository.FirearmRepository;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.http.HttpStatus;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.server.ResponseStatusException;
+
+@Service
+public class FirearmService {
+
+    private final FirearmRepository firearmRepository;
+
+    public FirearmService(FirearmRepository firearmRepository) {
+        this.firearmRepository = firearmRepository;
+    }
+
+    @Transactional(readOnly = true)
+    public PageResponse<FirearmResponse> pageQuery(FirearmType type, Pageable pageable) {
+        Page<Firearm> page = type == null
+                ? firearmRepository.findAll(pageable)
+                : firearmRepository.findAllByType(type, pageable);
+
+        return PageResponse.from(page.map(FirearmResponse::from));
+    }
+
+    @Transactional(readOnly = true)
+    public FirearmResponse queryById(Long id) {
+        return firearmRepository.findById(id)
+                .map(FirearmResponse::from)
+                .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "Firearm not found: " + id));
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/service/ModificationService.java

@@ -0,0 +1,39 @@
+package com.onixbyte.deltaforceguide.service;
+
+import com.onixbyte.deltaforceguide.domain.dto.ModificationResponse;
+import com.onixbyte.deltaforceguide.domain.dto.PageResponse;
+import com.onixbyte.deltaforceguide.domain.entity.Modification;
+import com.onixbyte.deltaforceguide.repository.ModificationRepository;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.http.HttpStatus;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.web.server.ResponseStatusException;
+
+@Service
+public class ModificationService {
+
+    private final ModificationRepository modificationRepository;
+
+    public ModificationService(ModificationRepository modificationRepository) {
+        this.modificationRepository = modificationRepository;
+    }
+
+    @Transactional(readOnly = true)
+    public PageResponse<ModificationResponse> pageQuery(Long firearmId, Pageable pageable) {
+        Page<Modification> page = firearmId == null
+                ? modificationRepository.findAllBy(pageable)
+                : modificationRepository.findAllByFirearm_Id(firearmId, pageable);
+
+        return PageResponse.from(page.map(ModificationResponse::from));
+    }
+
+    @Transactional(readOnly = true)
+    public ModificationResponse queryById(Long id) {
+        return modificationRepository.findById(id)
+                .map(ModificationResponse::from)
+                .orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND, "Modification not found: " + id));
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/shared/DateTimeFormatters.java

@@ -0,0 +1,46 @@
+package com.onixbyte.deltaforceguide.shared;
+
+import java.time.format.DateTimeFormatter;
+
+/**
+ * Utility class providing predefined {@link DateTimeFormatter} instances for common date and
+ * time patterns. These formatters can be used to parse and format {@code java.time} objects
+ * consistently throughout an application.
+ *
+ * @author zihluwang
+ */
+public class DateTimeFormatters {
+
+    /**
+     * A {@link DateTimeFormatter} for formatting and parsing full date and time with seconds, using
+     * the pattern "yyyy-MM-dd HH:mm:ss".
+     * <p>
+     * Example: "{@code 2023-10-27 15:30:45}"
+     */
+    public static final DateTimeFormatter DATE_TIME_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
+
+    /**
+     * A {@link DateTimeFormatter} for formatting and parsing dates only, using the
+     * pattern "yyyy-MM-dd".
+     * <p>
+     * Example: "{@code 2023-10-27}"
+     */
+    public static final DateTimeFormatter DATE_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd");
+
+    /**
+     * A {@link DateTimeFormatter} for formatting and parsing times only, using the
+     * pattern "HH:mm:ss".
+     * <p>
+     * Example: "{@code 15:30:45}"
+     */
+    public static final DateTimeFormatter TIME_FORMATTER = DateTimeFormatter.ofPattern("HH:mm:ss");
+
+    /**
+     * A {@link DateTimeFormatter} for formatting and parsing year and month only, using the
+     * pattern "yyyy-MM".
+     * <p>
+     * Example: "{@code 2023-10}"
+     */
+    public static final DateTimeFormatter YEAR_MONTH_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM");
+}
+

src/main/java/com/onixbyte/deltaforceguide/shared/JacksonModules.java

@@ -0,0 +1,34 @@
+package com.onixbyte.deltaforceguide.shared;
+
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
+import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateDeserializer;
+import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer;
+import com.fasterxml.jackson.datatype.jsr310.deser.LocalTimeDeserializer;
+import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateSerializer;
+import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer;
+import com.fasterxml.jackson.datatype.jsr310.ser.LocalTimeSerializer;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+
+public class JacksonModules {
+
+    public static final SimpleModule DATE_TIME_MODULE = initialiseDateTimeModule();
+
+    private static SimpleModule initialiseDateTimeModule() {
+        var javaTimeModule = new JavaTimeModule();
+        javaTimeModule.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatters.DATE_TIME_FORMATTER));
+        javaTimeModule.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatters.DATE_TIME_FORMATTER));
+
+        javaTimeModule.addSerializer(LocalDate.class, new LocalDateSerializer(DateTimeFormatters.DATE_FORMATTER));
+        javaTimeModule.addDeserializer(LocalDate.class, new LocalDateDeserializer(DateTimeFormatters.DATE_FORMATTER));
+
+        javaTimeModule.addSerializer(LocalTime.class, new LocalTimeSerializer(DateTimeFormatters.TIME_FORMATTER));
+        javaTimeModule.addDeserializer(LocalTime.class, new LocalTimeDeserializer(DateTimeFormatters.TIME_FORMATTER));
+
+        return javaTimeModule;
+    }
+}
+

src/main/java/com/onixbyte/deltaforceguide/shared/JacksonRedisSerialiser.java

@@ -0,0 +1,22 @@
+package com.onixbyte.deltaforceguide.shared;
+
+import com.fasterxml.jackson.databind.SerializationFeature;
+import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
+import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer;
+
+public class JacksonRedisSerialiser {
+
+    public static final GenericJackson2JsonRedisSerializer INSTANCE = initialiseSerializer();
+
+    private static GenericJackson2JsonRedisSerializer initialiseSerializer() {
+        var serializer = new GenericJackson2JsonRedisSerializer();
+
+        serializer.configure((configurer) -> {
+            configurer.registerModule(new JavaTimeModule());
+            configurer.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
+        });
+
+        return serializer;
+    }
+}
+

src/main/resources/application.yaml

@@ -0,0 +1,46 @@
+spring:
+  application:
+    name: delta-force-guide
+  cache:
+    type: redis
+    redis:
+      time-to-live: PT2H
+  data:
+    redis:
+      repositories:
+        # Disable redis repositories
+        enabled: false
+  jta:
+    # Disable JTA support
+    enabled: false
+  jpa:
+    properties:
+      hibernate:
+        transaction:
+          jta:
+            # No need to use distributed transaction manager for 1 datasource.
+            platform: org.hibernate.engine.transaction.jta.platform.internal.NoJtaPlatform
+    hibernate:
+      ddl-auto: none
+    open-in-view: false
+  datasource:
+    hikari:
+      minimum-idle: 1
+      maximum-pool-size: 10
+  flyway:
+    enabled: true
+    baseline-on-migrate: true
+
+mybatis:
+  configuration:
+    log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl
+    map-underscore-to-camel-case: true
+  type-aliases-package: com.onixbyte.deltaforceguide.domain.entity
+  type-handlers-package: com.onixbyte.deltaforceguide.mapper.handler
+  mapper-locations: classpath:/mapper/*.xml
+
+logging:
+  level:
+    org.hibernate:
+      orm.connections.pooling: off
+

src/main/resources/db/migration/V2__init.sql

@@ -0,0 +1,34 @@
+DROP TABLE IF EXISTS firearm CASCADE;
+DROP TABLE IF EXISTS modification CASCADE;
+
+
+CREATE TABLE IF NOT EXISTS firearm
+(
+    id     BIGSERIAL   NOT NULL PRIMARY KEY,
+    name   VARCHAR(64) NOT NULL,
+    type   INT         NOT NULL,
+    level  VARCHAR(10) NOT NULL,
+    review TEXT        NULL
+);
+
+
+CREATE TABLE IF NOT EXISTS modification
+(
+    id         BIGSERIAL    NOT NULL PRIMARY KEY,
+    firearm_id BIGINT       NOT NULL,
+    name       VARCHAR(64)  NOT NULL,
+    code       VARCHAR(64)  NOT NULL,
+    tags       JSONB        NULL,
+    note       TEXT         NULL,
+    author     VARCHAR(64)  NULL,
+    video_url  VARCHAR(512) NULL,
+    CONSTRAINT fk_modification_firearm
+        FOREIGN KEY (firearm_id)
+            REFERENCES firearm (id)
+            ON DELETE CASCADE
+            ON UPDATE RESTRICT
+);
+
+CREATE INDEX idx_modification_firearm_id ON modification (firearm_id);
+
+

src/page/firearms/index.tsx

@@ -1,214 +0,0 @@
-import { useCallback, useEffect, useState } from "react"
-import { Link } from "react-router-dom"
-import { FirearmApi } from "@/api"
-import FirearmCreateModal from "@/components/firearm-create-modal"
-import FirearmEditModal from "@/components/firearm-edit-modal"
-import { useAppSelector } from "@/store"
-import { Firearm, FirearmType } from "@/types"
-import { Button, Card, Col, Pagination, Popconfirm, Row, Select, Tag, Typography, App } from "antd"
-
-const firearmTypeText: Record<FirearmType, string> = {
-  RIFLE: "步枪",
-  SUB_MACHINE_GUN: "冲锋枪",
-  SHOTGUN: "霰弹枪",
-  LIGHT_MACHINE_GUN: "轻机枪",
-  DESIGNATED_MARKSMAN_RIFLE: "射手步枪",
-  SNIPER_RIFLE: "狙击步枪",
-  PISTOL: "手枪",
-  SPECIAL: "特殊",
-}
-
-const allTypeValue = "ALL"
-type FirearmTypeFilter = FirearmType | typeof allTypeValue
-
-function asDps(fireRate: number, damage: number) {
-  return ((fireRate / 60) * damage).toFixed(2)
-}
-
-export default function FirearmsPage() {
-  const user = useAppSelector((state) => state.auth.user)
-  const { message } = App.useApp()
-  const [page, setPage] = useState<number>(1)
-  const [typeFilter, setTypeFilter] = useState<FirearmTypeFilter>(allTypeValue)
-  const [firearms, setFirearms] = useState<Firearm[]>([])
-  const [total, setTotal] = useState<number>(0)
-  const [createModalOpen, setCreateModalOpen] = useState(false)
-  const [editingFirearm, setEditingFirearm] = useState<Firearm | null>(null)
-  const [deletingId, setDeletingId] = useState<number | null>(null)
-
-  const loadFirearms = useCallback(async () => {
-    const pagedData = await FirearmApi.getFirearms({
-      page: page - 1,
-      size: 12,
-      sortBy: "id",
-      direction: "ASC",
-      type: typeFilter === allTypeValue ? undefined : typeFilter,
-    })
-    setFirearms(pagedData.items)
-    setTotal(pagedData.totalElements)
-  }, [page, typeFilter])
-
-  useEffect(() => {
-    void loadFirearms()
-  }, [loadFirearms])
-
-  async function handleDelete(firearm: Firearm) {
-    setDeletingId(firearm.id)
-    try {
-      await FirearmApi.removeFirearm(firearm.id)
-      message.success("武器删除成功")
-      if (firearms.length === 1 && page > 1) {
-        setPage(page - 1)
-      } else {
-        void loadFirearms()
-      }
-    } catch {
-      message.error("武器删除失败，请稍后重试")
-    } finally {
-      setDeletingId(null)
-    }
-  }
-
-  return (
-    <>
-      <div className="mb-4 flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
-        <div>
-          {user && (
-            <Button type="primary" onClick={() => setCreateModalOpen(true)}>
-              新建武器
-            </Button>
-          )}
-        </div>
-        <Select<FirearmTypeFilter>
-          className="w-full sm:w-64"
-          value={typeFilter}
-          options={[
-            { value: allTypeValue, label: "全部类型" },
-            ...Object.entries(firearmTypeText).map(([value, label]) => ({
-              value,
-              label,
-            })),
-          ]}
-          onChange={(nextType) => {
-            setPage(1)
-            setTypeFilter(nextType)
-          }}
-        />
-      </div>
-      <div className="mb-6">
-        <Row gutter={[16, 16]}>
-          {firearms.map((firearm) => (
-            <Col key={firearm.id} xs={24} md={12} lg={8}>
-              <Card
-                title={firearm.name}
-                extra={
-                  user ? (
-                    <div className="flex items-center gap-1">
-                      <Button type="link" size="small" onClick={() => setEditingFirearm(firearm)}>
-                        编辑
-                      </Button>
-                      <Popconfirm
-                        title="确认删除武器"
-                        description={`确定要删除 ${firearm.name} 吗？该操作不可撤销。`}
-                        okText="删除"
-                        cancelText="取消"
-                        okButtonProps={{ danger: true, loading: deletingId === firearm.id }}
-                        onConfirm={() => handleDelete(firearm)}>
-                        <Button type="link" danger size="small" loading={deletingId === firearm.id}>
-                          删除
-                        </Button>
-                      </Popconfirm>
-                    </div>
-                  ) : null
-                }
-                variant="outlined"
-                styles={{
-                  header: { minHeight: 56 },
-                }}
-                actions={[
-                  <Link key={`mod-codes-${firearm.id}`} to={`/mod-codes?firearmId=${firearm.id}`}>
-                    <Button type="link">查看改枪码</Button>
-                  </Link>,
-                ]}>
-                <div className="flex flex-col gap-3">
-                  <div className="flex items-center justify-between">
-                    <Tag color="blue">{firearmTypeText[firearm.type]}</Tag>
-                  </div>
-                  <Typography.Text>
-                    <strong>武器输出等级：</strong>
-                    {firearm.level}
-                  </Typography.Text>
-                  <Typography.Text>
-                    <strong>子弹口径：</strong>
-                    {firearm.calibre}
-                  </Typography.Text>
-                  <Typography.Text>
-                    <strong>每秒甲伤：</strong>
-                    {asDps(firearm.fireRate, firearm.armourDamage)}
-                  </Typography.Text>
-                  <Typography.Text>
-                    <strong>每秒肉伤：</strong>
-                    {asDps(firearm.fireRate, firearm.bodyDamage)}
-                  </Typography.Text>
-                  <Typography.Paragraph
-                    style={{ marginBottom: 0 }}
-                    type="secondary"
-                    ellipsis={{
-                      rows: 3,
-                      tooltip: firearm.review
-                        ? {
-                            title: <div style={{ whiteSpace: "pre-line" }}>{firearm.review}</div>,
-                            placement: "topLeft",
-                          }
-                        : false,
-                    }}
-                    className="whitespace-pre-line">
-                    {firearm.review || "暂无描述"}
-                  </Typography.Paragraph>
-                </div>
-              </Card>
-            </Col>
-          ))}
-          {firearms.length === 0 && (
-            <Col span={24}>
-              <Card>
-                <Typography.Text type="secondary">暂无武器数据</Typography.Text>
-              </Card>
-            </Col>
-          )}
-        </Row>
-      </div>
-      <div className="flex justify-end">
-        <Pagination
-          align="end"
-          current={page}
-          pageSize={12}
-          total={total}
-          onChange={(nextPage) => {
-            setPage(nextPage)
-          }}
-          showSizeChanger={false}
-        />
-      </div>
-
-      <FirearmCreateModal
-        open={createModalOpen}
-        onCancel={() => setCreateModalOpen(false)}
-        onSuccess={() => {
-          setCreateModalOpen(false)
-          void loadFirearms()
-        }}
-      />
-
-      <FirearmEditModal
-        open={!!editingFirearm}
-        firearm={editingFirearm}
-        onCancel={() => setEditingFirearm(null)}
-        onSuccess={() => {
-          setEditingFirearm(null)
-          void loadFirearms()
-        }}
-      />
-    </>
-  )
-}

src/page/login/index.tsx

@@ -1,67 +0,0 @@
-import { useState } from "react"
-import { useNavigate } from "react-router-dom"
-import { App, Button, Card, Form, Input, Typography } from "antd"
-import { AuthApi } from "@/api"
-import { useAppDispatch } from "@/store"
-import { setCurrentUser } from "@/store/auth-slice"
-import { LoginRequest } from "@/types"
-
-export default function LoginPage() {
-  const navigate = useNavigate()
-  const { message } = App.useApp()
-  const dispatch = useAppDispatch()
-  const [loading, setLoading] = useState(false)
-
-  async function onFinish(values: LoginRequest) {
-    setLoading(true)
-    try {
-      const user = await AuthApi.login(values)
-      dispatch(setCurrentUser(user))
-      message.success(`欢迎回来，${user.username}`)
-      navigate("/firearms")
-    } catch {
-      message.error("登录失败，请检查帐号或密码")
-    } finally {
-      setLoading(false)
-    }
-  }
-
-  return (
-    <div className="min-h-screen bg-gray-100 px-4 py-10 sm:py-16">
-      <div className="mx-auto max-w-md">
-        <Card bordered={false} className="shadow-sm">
-          <Typography.Title level={3} className="!mb-2 text-center">
-            登录
-          </Typography.Title>
-          <Typography.Paragraph className="!mb-6 text-center !text-gray-500">
-            使用你的帐号登录后即可继续操作
-          </Typography.Paragraph>
-
-          <Form<LoginRequest> layout="vertical" onFinish={onFinish} requiredMark={false}>
-            <Form.Item<LoginRequest>
-              name="principle"
-              label="帐号"
-              rules={[{ required: true, message: "请输入帐号" }]}
-            >
-              <Input autoComplete="username" placeholder="请输入帐号" />
-            </Form.Item>
-
-            <Form.Item<LoginRequest>
-              name="credential"
-              label="密码"
-              rules={[{ required: true, message: "请输入密码" }]}
-            >
-              <Input.Password autoComplete="current-password" placeholder="请输入密码" />
-            </Form.Item>
-
-            <Form.Item className="!mb-0">
-              <Button type="primary" htmlType="submit" loading={loading} block>
-                登录
-              </Button>
-            </Form.Item>
-          </Form>
-        </Card>
-      </div>
-    </div>
-  )
-}

src/page/mod-codes/index.tsx

@@ -1,313 +0,0 @@
-import {
-  App,
-  Button,
-  Card,
-  Col,
-  Pagination,
-  Popconfirm,
-  Row,
-  Select,
-  Space,
-  Tag,
-  Typography,
-} from "antd"
-import { useCallback, useEffect, useMemo, useState } from "react"
-import { Link, useSearchParams } from "react-router-dom"
-import { ModificationApi, TagApi } from "@/api"
-import ModificationCreateModal from "@/components/modification-create-modal"
-import ModificationEditModal from "@/components/modification-edit-modal"
-import { useAppSelector } from "@/store"
-import { Modification } from "@/types"
-
-const pageSize = 12
-
-export default function ModCodesPage() {
-  const user = useAppSelector((state) => state.auth.user)
-  const { message } = App.useApp()
-  const [searchParams] = useSearchParams()
-  const firearmId = useMemo(() => searchParams.get("firearmId") || undefined, [searchParams])
-  const parsedFirearmId = useMemo(() => {
-    if (!firearmId) {
-      return undefined
-    }
-
-    const value = Number(firearmId)
-    return Number.isFinite(value) ? value : undefined
-  }, [firearmId])
-
-  const [page, setPage] = useState<number>(1)
-  const [modifications, setModifications] = useState<Modification[]>([])
-  const [tagOptions, setTagOptions] = useState<string[]>([])
-  const [selectedTags, setSelectedTags] = useState<string[]>([])
-  const [total, setTotal] = useState<number>(0)
-  const [deletingId, setDeletingId] = useState<number | null>(null)
-  const [createModalOpen, setCreateModalOpen] = useState(false)
-  const [editingModification, setEditingModification] = useState<Modification | null>(null)
-
-  useEffect(() => {
-    const _firearmId = firearmId ? +firearmId : void 0
-    TagApi.getTags(_firearmId).then((tags) => {
-      setTagOptions(tags)
-    })
-  }, [firearmId])
-
-  const loadModifications = useCallback(async () => {
-    return ModificationApi.getModifications({
-      page: page - 1,
-      size: pageSize,
-      sortBy: "id",
-      direction: "ASC",
-      firearmId,
-      tags: selectedTags,
-    }).then((pagedData) => {
-      setModifications(pagedData.items)
-      setTotal(pagedData.totalElements)
-    })
-  }, [page, firearmId, selectedTags])
-
-  useEffect(() => {
-    void loadModifications()
-  }, [loadModifications])
-
-  async function handleDelete(modification: Modification) {
-    if (!user) {
-      return
-    }
-
-    setDeletingId(modification.id)
-    try {
-      await ModificationApi.removeModification(modification.id)
-      message.success("改枪码删除成功")
-      if (modifications.length === 1 && page > 1) {
-        setPage(page - 1)
-      } else {
-        void loadModifications()
-      }
-    } catch {
-      message.error("改枪码删除失败，请稍后重试")
-    } finally {
-      setDeletingId(null)
-    }
-  }
-
-  useEffect(() => {
-    setPage(1)
-  }, [firearmId])
-
-  useEffect(() => {
-    setPage(1)
-  }, [selectedTags])
-
-  return (
-    <>
-      <div className="mb-4 flex items-start justify-between gap-4">
-        <Typography.Title level={4} className="mb-0!">
-          改枪码列表
-        </Typography.Title>
-        <div className="flex flex-wrap items-center justify-end gap-3">
-          <Space wrap>
-            <span>标签：</span>
-            <Select<string[]>
-              mode="multiple"
-              allowClear
-              placeholder="请选择标签"
-              className="w-64"
-              value={selectedTags}
-              options={tagOptions.map((tag) => ({ value: tag, label: tag }))}
-              onChange={(values) => {
-                setSelectedTags(values)
-              }}
-            />
-            {firearmId && <Tag color="geekblue">武器 ID: {firearmId}</Tag>}
-            {(firearmId || selectedTags.length > 0) && (
-              <Link to="/mod-codes">
-                <Button
-                  type="link"
-                  onClick={() => {
-                    setSelectedTags([])
-                    setPage(1)
-                  }}>
-                  清除筛选
-                </Button>
-              </Link>
-            )}
-          </Space>
-          {user && (
-            <Button type="primary" onClick={() => setCreateModalOpen(true)}>
-              添加改装
-            </Button>
-          )}
-        </div>
-      </div>
-
-      <div className="mb-6">
-        <Row gutter={[16, 16]}>
-          {modifications.map((modification) => (
-            <Col key={modification.id} span={24}>
-              <Card
-                title={modification.name}
-                extra={
-                  user ? (
-                    <div className="flex items-center gap-1">
-                      <Button
-                        type="link"
-                        size="small"
-                        onClick={() => setEditingModification(modification)}>
-                        编辑
-                      </Button>
-                      <Popconfirm
-                        title="确认删除改枪码"
-                        description={`确定要删除 ${modification.name} 吗？该操作不可撤销。`}
-                        okText="删除"
-                        cancelText="取消"
-                        okButtonProps={{ danger: true, loading: deletingId === modification.id }}
-                        onConfirm={() => handleDelete(modification)}>
-                        <Button
-                          type="link"
-                          danger
-                          size="small"
-                          loading={deletingId === modification.id}>
-                          删除
-                        </Button>
-                      </Popconfirm>
-                    </div>
-                  ) : null
-                }
-                variant="outlined"
-                styles={{
-                  header: { minHeight: 56 },
-                }}>
-                <div className="flex flex-col gap-3">
-                  <div className="flex items-center justify-between gap-2">
-                    <span>
-                      <strong>改枪码：</strong>
-                      <code className="bg-gray-400 px-2 py-1 rounded text-sm text-white">
-                        {modification.code}
-                      </code>
-                    </span>
-                    <Button
-                      type="text"
-                      size="small"
-                      onClick={() => navigator.clipboard.writeText(modification.code)}>
-                      复制
-                    </Button>
-                  </div>
-
-                  <Typography.Text>
-                    <strong>作者：</strong>
-                    {modification.author || "未知"}
-                  </Typography.Text>
-
-                  {(modification.tags?.length || 0) > 0 && (
-                    <div className="flex flex-wrap gap-2">
-                      {(modification.tags || []).map((tag) => (
-                        <Tag key={`${modification.id}-${tag}`}>{tag}</Tag>
-                      ))}
-                    </div>
-                  )}
-
-                  <div>
-                    <Typography.Text strong>配件配置：</Typography.Text>
-                    {(modification.accessories?.length || 0) > 0 ? (
-                      <div className="mt-2 overflow-x-auto">
-                        <div className="grid min-w-275 grid-cols-5 gap-2">
-                          {(modification.accessories || []).map((accessory, accessoryIndex) => (
-                            <div
-                              key={`${modification.id}-accessory-${accessoryIndex}`}
-                              className="rounded border border-gray-100 p-2">
-                              <div className="flex items-center justify-between gap-2 rounded bg-gray-50 px-2 py-1">
-                                <Typography color="blue" className="mr-0">
-                                  {accessory.slotName || "未填写槽位"}
-                                </Typography>
-                                <Typography className="mr-0 text-[#4C1D95]">
-                                  {accessory.accessoryName || "未填写配件"}
-                                </Typography>
-                              </div>
-                              {(accessory.tunings?.length || 0) > 0 ? (
-                                <div className="mt-2 flex flex-wrap gap-1">
-                                  {accessory.tunings.map((tuning, tuningIndex) => (
-                                    <Tag
-                                      key={`${modification.id}-${accessoryIndex}-tuning-${tuningIndex}`}
-                                      color="geekblue">
-                                      {tuning.tuningName || "未命名"}: {tuning.tuningValue ?? "-"}
-                                    </Tag>
-                                  ))}
-                                </div>
-                              ) : null}
-                            </div>
-                          ))}
-                        </div>
-                      </div>
-                    ) : (
-                      <Typography.Text type="secondary" className="block mt-1">
-                        暂无配件信息
-                      </Typography.Text>
-                    )}
-                  </div>
-
-                  <Typography.Paragraph
-                    style={{ marginBottom: 0 }}
-                    type="secondary"
-                    ellipsis={{ rows: 3 }}>
-                    {modification.note || "暂无备注"}
-                  </Typography.Paragraph>
-
-                  {modification.videoUrl && (
-                    <div>
-                      <a href={modification.videoUrl} target="_blank" rel="noopener noreferrer">
-                        查看视频
-                      </a>
-                    </div>
-                  )}
-                </div>
-              </Card>
-            </Col>
-          ))}
-
-          {modifications.length === 0 && (
-            <Col span={24}>
-              <Card>
-                <Typography.Text type="secondary">暂无改枪码数据</Typography.Text>
-              </Card>
-            </Col>
-          )}
-        </Row>
-      </div>
-
-      <div className="flex justify-end">
-        <Pagination
-          align="end"
-          current={page}
-          pageSize={pageSize}
-          total={total}
-          onChange={(nextPage) => {
-            setPage(nextPage)
-          }}
-          showSizeChanger={false}
-        />
-      </div>
-
-      <ModificationCreateModal
-        open={createModalOpen}
-        defaultFirearmId={parsedFirearmId}
-        lockedFirearmId={parsedFirearmId}
-        onCancel={() => setCreateModalOpen(false)}
-        onSuccess={() => {
-          setCreateModalOpen(false)
-          void loadModifications()
-        }}
-      />
-
-      <ModificationEditModal
-        open={!!editingModification}
-        modification={editingModification}
-        lockedFirearmId={parsedFirearmId}
-        onCancel={() => setEditingModification(null)}
-        onSuccess={() => {
-          setEditingModification(null)
-          void loadModifications()
-        }}
-      />
-    </>
-  )
-}

src/router/index.tsx

@@ -1,57 +0,0 @@
-import { ComponentType } from "react"
-import { createBrowserRouter } from "react-router-dom"
-import ErrorPage from "@/components/error-page"
-import EmptyLayout from "@/layout/empty-layout"
-import HeroLayout from "@/layout/hero-layout"
-
-function lazy<T extends { default: ComponentType<unknown> }>(importer: () => Promise<T>) {
-  return async () => {
-    const module = await importer()
-    return {
-      Component: module.default,
-    }
-  }
-}
-
-/**
- * Main application router configuration using React Router v6.
- * Defines all routes and their corresponding components.
- */
-const router = createBrowserRouter(
-  [
-    {
-      path: "/",
-      element: <HeroLayout />,
-      errorElement: <ErrorPage />,
-      children: [
-        {
-          index: true,
-          lazy: lazy(() => import("@/page/firearms")),
-        },
-        {
-          path: "firearms",
-          lazy: lazy(() => import("@/page/firearms")),
-        },
-        {
-          path: "mod-codes",
-          lazy: lazy(() => import("@/page/mod-codes")),
-        },
-      ],
-    },
-    {
-      element: <EmptyLayout />,
-      errorElement: <ErrorPage />,
-      children: [
-        {
-          path: "login",
-          lazy: lazy(() => import("@/page/login")),
-        },
-      ],
-    },
-  ],
-  {
-    basename: "/",
-  }
-)
-
-export default router

src/shared/dayjs/index.ts

@@ -1,6 +0,0 @@
-import dayjs from "dayjs"
-import duration from "dayjs/plugin/duration"
-
-dayjs.extend(duration)
-
-export default dayjs

src/shared/web-client/index.ts

@@ -1,10 +0,0 @@
-import axios from "axios"
-import dayjs from "@/shared/dayjs"
-
-const WebClient = axios.create({
-  baseURL: import.meta.env.VITE_API_BASE_URL,
-  timeout: dayjs.duration({ seconds: 10 }).asMilliseconds(),
-  withCredentials: true
-})
-
-export { WebClient }

src/store/auth-slice.ts

@@ -1,26 +0,0 @@
-import { createSlice, PayloadAction } from "@reduxjs/toolkit"
-import { User } from "@/types"
-
-interface AuthState {
-  user: User | null
-}
-
-const initialState: AuthState = {
-  user: null,
-}
-
-const authSlice = createSlice({
-  name: "auth",
-  initialState,
-  reducers: {
-    setCurrentUser(state, action: PayloadAction<User>) {
-      state.user = action.payload
-    },
-    clearCurrentUser(state) {
-      state.user = null
-    },
-  },
-})
-
-export const { setCurrentUser, clearCurrentUser } = authSlice.actions
-export const authReducer = authSlice.reducer

src/store/firearms-slice.ts

@@ -1,42 +0,0 @@
-import { createSlice, PayloadAction } from "@reduxjs/toolkit"
-import { Firearm, Page } from "@/types"
-
-interface FirearmsState {
-  items: Firearm[]
-  page: number
-  size: number
-  totalPages: number
-  totalElements: number
-}
-
-const initialState: FirearmsState = {
-  items: [],
-  page: 0,
-  size: 12,
-  totalPages: 0,
-  totalElements: 0,
-}
-
-const firearmsSlice = createSlice({
-  name: "firearms",
-  initialState,
-  reducers: {
-    setFirearmsPage(state, action: PayloadAction<Page<Firearm>>) {
-      state.items = action.payload.items
-      state.page = action.payload.page
-      state.size = action.payload.size
-      state.totalPages = action.payload.totalPages
-      state.totalElements = action.payload.totalElements
-    },
-    clearFirearms(state) {
-      state.items = []
-      state.page = 0
-      state.size = 12
-      state.totalPages = 0
-      state.totalElements = 0
-    },
-  },
-})
-
-export const { setFirearmsPage, clearFirearms } = firearmsSlice.actions
-export const firearmsReducer = firearmsSlice.reducer

src/store/index.ts

@@ -1,50 +0,0 @@
-import { configureStore, combineReducers } from "@reduxjs/toolkit"
-import { useDispatch, useSelector } from "react-redux"
-import {
-  persistStore,
-  persistReducer,
-  FLUSH,
-  REHYDRATE,
-  PAUSE,
-  PERSIST,
-  PURGE,
-  REGISTER,
-} from "redux-persist"
-import createWebStorage from "redux-persist/es/storage/createWebStorage"
-import { authReducer } from "./auth-slice"
-import { firearmsReducer } from "./firearms-slice"
-
-const storage = createWebStorage(import.meta.env.VITE_REDUX_STORAGE ?? "local")
-
-const persistConfig = {
-  key: "root",
-  storage,
-  whitelist: ["auth", "firearms"],
-}
-
-const rootReducer = combineReducers({
-  auth: authReducer,
-  firearms: firearmsReducer
-})
-
-const persistedReducer = persistReducer(persistConfig, rootReducer)
-
-const store = configureStore({
-  reducer: persistedReducer,
-  middleware: (getDefaultMiddleware) =>
-    getDefaultMiddleware({
-      serializableCheck: {
-        ignoredActions: [FLUSH, REHYDRATE, PAUSE, PERSIST, PURGE, REGISTER],
-      },
-    }),
-})
-
-export const persistor = persistStore(store)
-
-export default store
-export type RootState = ReturnType<typeof rootReducer>
-export type AppDispatch = typeof store.dispatch
-export type AppStore = typeof store
-
-export const useAppDispatch = useDispatch.withTypes<AppDispatch>()
-export const useAppSelector = useSelector.withTypes<RootState>()

src/types/auth.ts

@@ -1,11 +0,0 @@
-export interface LoginRequest {
-  principle: string
-  credential: string
-}
-
-export interface User {
-  id: number
-  username: string
-  email: string
-}
-

src/types/common.ts

@@ -1,17 +0,0 @@
-export type Direction = "ASC" | "DESC"
-
-export interface Page<T> {
-  items: T[]
-  page: number
-  size: number
-  totalElements: number
-  totalPages: number
-}
-
-export interface PageQueryParams {
-  page?: number
-  size?: number
-  sortBy?: string
-  direction?: Direction
-}
-

src/types/firearm.ts

@@ -1,24 +0,0 @@
-export type FirearmType =
-  | "RIFLE"
-  | "SUB_MACHINE_GUN"
-  | "SHOTGUN"
-  | "LIGHT_MACHINE_GUN"
-  | "DESIGNATED_MARKSMAN_RIFLE"
-  | "SNIPER_RIFLE"
-  | "PISTOL"
-  | "SPECIAL"
-
-export interface Firearm {
-  id: number
-  name: string
-  type: FirearmType
-  level: string
-  calibre: string
-  fireRate: number
-  armourDamage: number
-  bodyDamage: number
-  review: string | null
-}
-
-export interface AddFirearmRequest extends Omit<Firearm, "id"> {}
-

src/types/index.ts

@@ -1,4 +0,0 @@
-export * from "./common"
-export * from "./firearm"
-export * from "./modification"
-export * from "./auth"

src/types/modification.ts

@@ -1,24 +0,0 @@
-export interface Tuning {
-  tuningName: string
-  tuningValue: number
-}
-
-export interface Accessory {
-  slotName: string
-  accessoryName: string
-  tunings: Tuning[]
-}
-
-export interface Modification {
-  id: number
-  firearmId: number
-  name: string
-  code: string
-  tags?: string[]
-  note?: string
-  author?: string
-  videoUrl?: string,
-  accessories: Accessory[]
-}
-
-export interface ModificationRequest extends Omit<Modification, "id"> {}

src/utils/index.ts

@@ -1 +0,0 @@
-export * as QueryParamUtils from "./query-param-utils"

src/utils/query-param-utils.ts

@@ -1,23 +0,0 @@
-import { PageQueryParams } from "@/types"
-
-export function asUrlSearchParam(pageQueryParams?: PageQueryParams) {
-  const urlSearchParams = new URLSearchParams()
-
-  if (pageQueryParams?.page) {
-    urlSearchParams.append("page", "" + pageQueryParams.page)
-  }
-
-  if (pageQueryParams?.size) {
-    urlSearchParams.append("size", "" + pageQueryParams.size)
-  }
-
-  if (pageQueryParams?.sortBy) {
-    urlSearchParams.append("sortBy", pageQueryParams.sortBy)
-  }
-
-  if (pageQueryParams?.direction) {
-    urlSearchParams.append("direction", pageQueryParams.direction)
-  }
-
-  return urlSearchParams
-}

src/vite-env.d.ts

@@ -1,9 +0,0 @@
-/// <reference types="vite/client" />
-interface ImportMetaEnv {
-  readonly VITE_REDUX_STORAGE: "local" | "session"
-  readonly VITE_API_BASE_URL: string
-}
-
-interface ImportMeta {
-  readonly env: ImportMetaEnv
-}

tsconfig.app.json

@@ -1,31 +0,0 @@
-{
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "target": "ES2020",
-    "useDefineForClassFields": true,
-    "lib": ["ES2020", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "skipLibCheck": true,
-
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "isolatedModules": true,
-    "moduleDetection": "force",
-    "noEmit": true,
-    "jsx": "react-jsx",
-
-    /* Linting */
-    "strict": true,
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedSideEffectImports": true,
-    "paths": {
-      "@/*": [
-        "./src/*"
-      ]
-    }
-  },
-  "include": ["src"]
-}

tsconfig.json

@@ -1,7 +0,0 @@
-{
-  "files": [],
-  "references": [
-    { "path": "./tsconfig.app.json" },
-    { "path": "./tsconfig.node.json" }
-  ]
-}

tsconfig.node.json

@@ -1,26 +0,0 @@
-{
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
-    "target": "ES2022",
-    "lib": [
-      "ES2023"
-    ],
-    "module": "ESNext",
-    "skipLibCheck": true,
-    /* Bundler mode */
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "isolatedModules": true,
-    "moduleDetection": "force",
-    "noEmit": true,
-    /* Linting */
-    "strict": true,
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedSideEffectImports": true
-  },
-  "include": [
-    "vite.config.ts"
-  ]
-}

vite.config.ts

@@ -1,24 +0,0 @@
-import { fileURLToPath, URL } from "node:url"
-import { defineConfig } from "vite"
-import react from "@vitejs/plugin-react"
-import tailwindcss from "@tailwindcss/vite"
-
-// https://vite.dev/config/
-export default defineConfig({
-  plugins: [react(), tailwindcss()],
-  base: "/",
-  resolve: {
-    alias: {
-      "@": fileURLToPath(new URL("./src", import.meta.url)),
-    },
-  },
-  server: {
-    proxy: {
-      '/api': {
-        target: 'http://localhost:8080',
-        changeOrigin: true,
-        rewrite: (path) => path.replace(/^\/api/, '')
-      }
-    }
-  }
-})