feat: 初始化项目结构并添加核心功能模块

- 新增文档模板和导航结构
- 实现服务器基础API路由和控制器
- 添加扩展插件配置和前端框架
- 引入多租户和权限管理模块
- 集成日志和数据库配置
- 添加核心业务模型和类型定义

archive/handover/README (23).md

@@ -0,0 +1,151 @@
+# Building `libv8` Debian Package
+
+This guide explains how to build the `libv8` Debian package.
+
+## Prerequisites:
+- Git
+- Debian-based system (native or Docker)
+- Only supported platform is AMD64
+
+## Build Steps
+
+### Clone the repository:
+```bash
+git clone git@github.com:freeswitch/libv8-packaging.git
+```
+
+### (Optionally) Use Docker to build packages for Debian `Bookworm`:
+```bash
+docker run -it -v $(pwd):/usr/src/ debian:bookworm bash -c "cd /usr/src/ && bash"
+```
+
+### Set non-interactive frontend for APT:
+```bash
+export DEBIAN_FRONTEND=noninteractive
+```
+
+### Install required build tools:
+```bash
+apt-get update \
+&& apt-get -y upgrade \
+&& apt-get -y install \
+    build-essential \
+    cmake \
+    devscripts \
+    lsb-release \
+    docbook-xsl \
+    pkg-config
+```
+
+### Set build number (modify as needed):
+```bash
+export BUILD_NUMBER=42
+```
+> Note: The build number (42) used in this guide is arbitrary. You can modify it as needed for your build process.
+
+### Set Debian codename:
+```bash
+export CODENAME=$(lsb_release -sc)
+```
+
+### Configure git safety setting:
+```bash
+git config --global --add safe.directory '*'
+```
+
+### Navigate to the source directory:
+```bash
+cd libv8-packaging/
+```
+-- or --
+```bash
+cd /usr/src/libv8-packaging/
+```
+
+### Install build dependencies:
+```bash
+apt-get update -y \
+&& apt-get install -y \
+    libbz2-dev \
+    libffi-dev \
+    libglib2.0-dev \
+    liblzma-dev \
+    libncurses5-dev \
+    libncursesw5-dev \
+    libreadline-dev \
+    libsqlite3-dev \
+    libssl-dev \
+    libtinfo5 \
+    llvm \
+    ninja-build \
+    tk-dev \
+    zlib1g-dev
+```
+
+### Configure build parameters:
+```bash
+export PYENV_VERSION_TAG=v2.4.0
+export PYTHON_VERSION=2.7.18
+export V8_GIT_VERSION=6.1.298
+export PYENV_ROOT="/opt/pyenv"
+export PATH="$PYENV_ROOT/shims:$PYENV_ROOT/bin:$BUILD_DIR/depot_tools:$PATH"
+export BUILD_DIR=$(realpath $(pwd))/BUILD
+```
+
+### Clone, build and configure `pyenv`:
+```bash
+git clone --branch $PYENV_VERSION_TAG https://github.com/pyenv/pyenv.git $PYENV_ROOT \
+    && sed -i 's|PATH="/|PATH="$PYENV_ROOT/bin/:/|g' /etc/profile \
+    && $PYENV_ROOT/bin/pyenv init - | tee -a /etc/profile \
+    && echo "export PATH=\"$BUILD_DIR/depot_tools:${PATH}\"" | tee -a /etc/profile
+```
+
+### Install `pyenv`:
+```bash
+pyenv install $PYTHON_VERSION \
+    && pyenv global $PYTHON_VERSION
+```
+
+### Configure build:
+```bash
+mkdir -p $BUILD_DIR \
+    && cp ./stub-gclient-spec $BUILD_DIR/.gclient \
+    && cp -av ./debian/ $BUILD_DIR/ \
+    && cd $BUILD_DIR
+```
+
+### Build binaries:
+```bash
+git clone --depth=1 https://chromium.googlesource.com/chromium/tools/depot_tools.git \
+    && gclient sync --verbose -r $V8_GIT_VERSION \
+    && cd v8 \
+    && gn gen out.gn --args="is_debug=true symbol_level=2 blink_symbol_level=1 v8_symbol_level=1 v8_static_library=true is_component_build=false v8_enable_i18n_support=false v8_use_external_startup_data=false" \
+    && gn args out.gn --list | tee out.gn/gn_args.txt \
+    && ninja -v d8 -C out.gn \
+&& cd $BUILD_DIR
+```
+
+### Build Debian package:
+```bash
+sed -i -e "s/GIT_VERSION/$V8_GIT_VERSION/g" debian/v8-6.1_static.pc \
+    && sed -i -e "s/GIT_VERSION/$V8_GIT_VERSION/g" debian/changelog \
+    && sed -i -e "s/DATE/$(env LC_ALL=en_US.utf8 date '+%a, %d %b %Y %H:%M:%S %z')/g" debian/changelog \
+    && sed -i -e "s/DISTRO/$(lsb_release -sc | tr -d '\n')/g" debian/changelog \
+    && sed -i -e "s/BUILD_NUMBER/$BUILD_NUMBER/g" debian/changelog \
+&& debuild -b -us -uc
+```
+
+### Move built packages to the output directory:
+```bash
+mkdir -p OUT \
+&& mv -v ../*.{deb,changes} OUT/.
+```
+-- or --
+```bash
+mkdir -p /usr/src/OUT \
+&& mv -v ../*.{deb,changes} /usr/src/OUT/.
+```
+
+## Output
+
+After a successful build, the Debian packages will be available in the `OUT` directory.