diff --git a/CN/modules/ROOT/nav.adoc b/CN/modules/ROOT/nav.adoc
index 0e2a67b..4845201 100644
--- a/CN/modules/ROOT/nav.adoc
+++ b/CN/modules/ROOT/nav.adoc
@@ -1,98 +1,99 @@
-* xref:master/about_ivorysql.adoc[关于IvorySQL]
-** xref:master/welcome.adoc[欢迎]
-** xref:master/release_notes.adoc[发行说明]
-* 快速上手
-** xref:master/getting-started/quick_start.adoc[快速开始]
-* 安装部署
-** xref:master/installation_guide.adoc[安装指南]
-** xref:master/cluster_setup.adoc[集群搭建]
-* Oracle兼容功能
-** xref:master/oracle_compatibility/compat_case_conversion.adoc[1、大小写转换]
-** xref:master/oracle_compatibility/compat_like_operator.adoc[2、LIKE操作符]
-** xref:master/oracle_compatibility/anonymous_block.adoc[3、匿名块]
-** xref:master/oracle_compatibility/compat_function_procedure.adoc[4、函数与存储过程]
-** xref:master/oracle_compatibility/builtin_types_functions.adoc[5、内置数据类型与内置函数]
-** xref:master/oracle_compatibility/port_ip.adoc[6、端口与IP]
-** xref:master/oracle_compatibility/xml_functions.adoc[7、XML函数]
-** xref:master/oracle_compatibility/sequence.adoc[8、sequence]
-** xref:master/oracle_compatibility/package.adoc[9、包]
-** xref:master/oracle_compatibility/invisible_column.adoc[10、不可见列]
-** xref:master/oracle_compatibility/compat_rowid.adoc[11、RowID]
-** xref:master/oracle_compatibility/compat_out_parameter.adoc[12、OUT 参数]
-** xref:master/oracle_compatibility/compat_type_rowtype.adoc[13、%TYPE、%ROWTYPE]
-** xref:master/oracle_compatibility/compat_nls_parameter.adoc[14、NLS 参数]
-** xref:master/oracle_compatibility/compat_force_view.adoc[15、Force View]
-** xref:master/oracle_compatibility/compat_nested_function.adoc[16、嵌套子函数]
-** xref:master/oracle_compatibility/compat_sys_guid.adoc[17、sys_guid 函数]
-** xref:master/oracle_compatibility/compat_empty_string_to_null.adoc[18、空字符串转null]
-** xref:master/oracle_compatibility/compat_call_into.adoc[19、CALL INTO]
-* 容器化与云服务
-** 容器化指南
-*** xref:master/containerization/k8s_deployment.adoc[K8S部署]
-*** xref:master/containerization/operator_deployment.adoc[Operator部署]
-*** xref:master/containerization/docker_podman_deployment.adoc[Docker & Podman部署]
-*** xref:master/containerization/docker_swarm_compose_deployment.adoc[Docker Swarm & Docker Compose部署]
-** 云服务平台指南
-*** xref:master/cloud_platform/ivorysql_cloud_installation.adoc[IvorySQL Cloud安装]
-*** xref:master/cloud_platform/ivorysql_cloud_usage.adoc[IvorySQL Cloud使用]
-* IvorySQL生态
-** xref:master/cpu_os_adaptation/cpu_architecture_adaptation.adoc[芯片架构适配]
-** xref:master/cpu_os_adaptation/os_architecture_adaptation.adoc[操作系统适配]
-** 生态组件适配
-*** xref:master/ecosystem_components/ecosystem_overview.adoc[概述]
-*** xref:master/ecosystem_components/postgis.adoc[postgis]
-*** xref:master/ecosystem_components/pgvector.adoc[pgvector]
-*** xref:master/ecosystem_components/pgddl.adoc[pgddl(DDL Extractor)]
-*** xref:master/ecosystem_components/pg_cron.adoc[pg_cron]
-*** xref:master/ecosystem_components/pgsql_http.adoc[pgsql-http]
-*** xref:master/ecosystem_components/plpgsql_check.adoc[plpgsql_check]
-*** xref:master/ecosystem_components/pgroonga.adoc[pgroonga]
-*** xref:master/ecosystem_components/pgaudit.adoc[pgaudit]
-*** xref:master/ecosystem_components/pgrouting.adoc[pgrouting]
-*** xref:master/ecosystem_components/system_stats.adoc[system_stats]
-*** xref:master/ecosystem_components/wal2json.adoc[wal2json]
-*** xref:master/ecosystem_components/pg_stat_monitor.adoc[pg_stat_monitor]
-*** xref:master/ecosystem_components/pg_ai_query.adoc[pg_ai_query]
-*** xref:master/ecosystem_components/pg_curl.adoc[pg_curl]
-* 监控运维
-** xref:master/getting-started/daily_monitoring.adoc[日常监控]
-** xref:master/getting-started/daily_maintenance.adoc[日常维护]
-** xref:master/operation_guide.adoc[运维管理指南]
-* 数据迁移
-** xref:master/migration_guide.adoc[迁移指南]
-* IvorySQL开发者
-** xref:master/contribution/community_contribution_guide.adoc[社区贡献指南]
-** xref:master/developer_guide.adoc[开发者指南]
-** IvorySQL架构设计
-*** 查询处理
-**** xref:master/architecture/dual_parser.adoc[双parser]
-*** 兼容框架
-**** xref:master/architecture/framework_design.adoc[框架设计]
-**** xref:master/architecture/guc_framework.adoc[GUC框架]
-**** xref:master/architecture/dual_mode_design.adoc[双模式设计]
-**** xref:master/architecture/initdb_process.adoc[initdb过程]
-*** 兼容特性
-**** xref:master/compatibility_features_design/like_operator.adoc[like]
-**** xref:master/compatibility_features_design/rowid.adoc[RowID]
-**** xref:master/compatibility_features_design/out_parameter.adoc[OUT 参数]
-**** xref:master/compatibility_features_design/type_rowtype.adoc[%TYPE、%ROWTYPE]
-**** xref:master/compatibility_features_design/nls_parameter.adoc[NLS 参数]
-**** xref:master/compatibility_features_design/function_procedure.adoc[函数与存储过程]
-**** xref:master/compatibility_features_design/nested_function.adoc[嵌套子函数]
-**** xref:master/compatibility_features_design/force_view.adoc[Force View]
-**** xref:master/compatibility_features_design/case_conversion.adoc[大小写转换]
-**** xref:master/compatibility_features_design/sys_guid_function.adoc[sys_guid 函数]
-**** xref:master/compatibility_features_design/empty_string_to_null.adoc[空字符串转null]
-**** xref:master/compatibility_features_design/call_into.adoc[CALL INTO]
-*** 内置函数
-**** xref:master/oracle_builtin_functions/sys_context.adoc[sys_context]
-**** xref:master/oracle_builtin_functions/userenv.adoc[userenv]
-*** xref:master/gb18030.adoc[国标GB18030]
-* 参考指南
-** xref:master/tools_reference.adoc[工具参考]
-** xref:master/contribution/asciidoc_syntax_reference.adoc[asciidoc语法快速参考]
-** xref:master/pg_reference/pg_parameters_reference.adoc[PG参数参考手册]
-** xref:master/pg_reference/pg_functions_reference.adoc[PG函数参考手册]
-* 常见问题解答
-** xref:master/contribution/faq.adoc[FAQ]
-
+* xref:master/about_ivorysql.adoc[关于IvorySQL]
+** xref:master/welcome.adoc[欢迎]
+** xref:master/release_notes.adoc[发行说明]
+* 快速上手
+** xref:master/getting-started/quick_start.adoc[快速开始]
+* 安装部署
+** xref:master/installation_guide.adoc[安装指南]
+** xref:master/cluster_setup.adoc[集群搭建]
+* Oracle兼容功能
+** xref:master/oracle_compatibility/compat_case_conversion.adoc[1、大小写转换]
+** xref:master/oracle_compatibility/compat_like_operator.adoc[2、LIKE操作符]
+** xref:master/oracle_compatibility/anonymous_block.adoc[3、匿名块]
+** xref:master/oracle_compatibility/compat_function_procedure.adoc[4、函数与存储过程]
+** xref:master/oracle_compatibility/builtin_types_functions.adoc[5、内置数据类型与内置函数]
+** xref:master/oracle_compatibility/port_ip.adoc[6、端口与IP]
+** xref:master/oracle_compatibility/xml_functions.adoc[7、XML函数]
+** xref:master/oracle_compatibility/sequence.adoc[8、sequence]
+** xref:master/oracle_compatibility/package.adoc[9、包]
+** xref:master/oracle_compatibility/invisible_column.adoc[10、不可见列]
+** xref:master/oracle_compatibility/compat_rowid.adoc[11、RowID]
+** xref:master/oracle_compatibility/compat_out_parameter.adoc[12、OUT 参数]
+** xref:master/oracle_compatibility/compat_type_rowtype.adoc[13、%TYPE、%ROWTYPE]
+** xref:master/oracle_compatibility/compat_nls_parameter.adoc[14、NLS 参数]
+** xref:master/oracle_compatibility/compat_force_view.adoc[15、Force View]
+** xref:master/oracle_compatibility/compat_nested_function.adoc[16、嵌套子函数]
+** xref:master/oracle_compatibility/compat_sys_guid.adoc[17、sys_guid 函数]
+** xref:master/oracle_compatibility/compat_empty_string_to_null.adoc[18、空字符串转null]
+** xref:master/oracle_compatibility/compat_call_into.adoc[19、CALL INTO]
+* 容器化与云服务
+** 容器化指南
+*** xref:master/containerization/k8s_deployment.adoc[K8S部署]
+*** xref:master/containerization/operator_deployment.adoc[Operator部署]
+*** xref:master/containerization/docker_podman_deployment.adoc[Docker & Podman部署]
+*** xref:master/containerization/docker_swarm_compose_deployment.adoc[Docker Swarm & Docker Compose部署]
+** 云服务平台指南
+*** xref:master/cloud_platform/ivorysql_cloud_installation.adoc[IvorySQL Cloud安装]
+*** xref:master/cloud_platform/ivorysql_cloud_usage.adoc[IvorySQL Cloud使用]
+* IvorySQL生态
+** xref:master/cpu_os_adaptation/cpu_architecture_adaptation.adoc[芯片架构适配]
+** xref:master/cpu_os_adaptation/os_architecture_adaptation.adoc[操作系统适配]
+** 生态组件适配
+*** xref:master/ecosystem_components/ecosystem_overview.adoc[概述]
+*** xref:master/ecosystem_components/postgis.adoc[postgis]
+*** xref:master/ecosystem_components/pgvector.adoc[pgvector]
+*** xref:master/ecosystem_components/pgddl.adoc[pgddl(DDL Extractor)]
+*** xref:master/ecosystem_components/pg_cron.adoc[pg_cron]
+*** xref:master/ecosystem_components/pgsql_http.adoc[pgsql-http]
+*** xref:master/ecosystem_components/plpgsql_check.adoc[plpgsql_check]
+*** xref:master/ecosystem_components/pgroonga.adoc[pgroonga]
+*** xref:master/ecosystem_components/pgaudit.adoc[pgaudit]
+*** xref:master/ecosystem_components/pgrouting.adoc[pgrouting]
+*** xref:master/ecosystem_components/system_stats.adoc[system_stats]
+*** xref:master/ecosystem_components/wal2json.adoc[wal2json]
+*** xref:master/ecosystem_components/pg_stat_monitor.adoc[pg_stat_monitor]
+*** xref:master/ecosystem_components/pg_ai_query.adoc[pg_ai_query]
+*** xref:master/ecosystem_components/pgbouncer.adoc[pgbouncer]
+*** xref:master/ecosystem_components/pg_curl.adoc[pg_curl]
+* 监控运维
+** xref:master/getting-started/daily_monitoring.adoc[日常监控]
+** xref:master/getting-started/daily_maintenance.adoc[日常维护]
+** xref:master/operation_guide.adoc[运维管理指南]
+* 数据迁移
+** xref:master/migration_guide.adoc[迁移指南]
+* IvorySQL开发者
+** xref:master/contribution/community_contribution_guide.adoc[社区贡献指南]
+** xref:master/developer_guide.adoc[开发者指南]
+** IvorySQL架构设计
+*** 查询处理
+**** xref:master/architecture/dual_parser.adoc[双parser]
+*** 兼容框架
+**** xref:master/architecture/framework_design.adoc[框架设计]
+**** xref:master/architecture/guc_framework.adoc[GUC框架]
+**** xref:master/architecture/dual_mode_design.adoc[双模式设计]
+**** xref:master/architecture/initdb_process.adoc[initdb过程]
+*** 兼容特性
+**** xref:master/compatibility_features_design/like_operator.adoc[like]
+**** xref:master/compatibility_features_design/rowid.adoc[RowID]
+**** xref:master/compatibility_features_design/out_parameter.adoc[OUT 参数]
+**** xref:master/compatibility_features_design/type_rowtype.adoc[%TYPE、%ROWTYPE]
+**** xref:master/compatibility_features_design/nls_parameter.adoc[NLS 参数]
+**** xref:master/compatibility_features_design/function_procedure.adoc[函数与存储过程]
+**** xref:master/compatibility_features_design/nested_function.adoc[嵌套子函数]
+**** xref:master/compatibility_features_design/force_view.adoc[Force View]
+**** xref:master/compatibility_features_design/case_conversion.adoc[大小写转换]
+**** xref:master/compatibility_features_design/sys_guid_function.adoc[sys_guid 函数]
+**** xref:master/compatibility_features_design/empty_string_to_null.adoc[空字符串转null]
+**** xref:master/compatibility_features_design/call_into.adoc[CALL INTO]
+*** 内置函数
+**** xref:master/oracle_builtin_functions/sys_context.adoc[sys_context]
+**** xref:master/oracle_builtin_functions/userenv.adoc[userenv]
+*** xref:master/gb18030.adoc[国标GB18030]
+* 参考指南
+** xref:master/tools_reference.adoc[工具参考]
+** xref:master/contribution/asciidoc_syntax_reference.adoc[asciidoc语法快速参考]
+** xref:master/pg_reference/pg_parameters_reference.adoc[PG参数参考手册]
+** xref:master/pg_reference/pg_functions_reference.adoc[PG函数参考手册]
+* 常见问题解答
+** xref:master/contribution/faq.adoc[FAQ]
+
diff --git a/CN/modules/ROOT/pages/master/ecosystem_components/pgbouncer.adoc b/CN/modules/ROOT/pages/master/ecosystem_components/pgbouncer.adoc
new file mode 100644
index 0000000..64dae0b
--- /dev/null
+++ b/CN/modules/ROOT/pages/master/ecosystem_components/pgbouncer.adoc
@@ -0,0 +1,220 @@
+:sectnums:
+:sectnumlevels: 5
+
+= PgBouncer
+
+== 概述
+
+PgBouncer 是轻量级连接池中间件，部署在应用层与数据库之间，通过复用后端连接来降低连接开销、保护数据库资源、提高应用并发性能。
+
+PgBouncer 使用标准 PostgreSQL 通信协议，IvorySQL 完全兼容该协议。
+
+*三种连接池模式：*
+
+[cols="1,2,2"]
+|===
+| 模式 | 说明 | 适用场景
+
+| session
+| 客户端连接期间独占一个后端连接
+| 需要过程内 COMMIT、完整会话特性
+
+| transaction
+| 每个事务结束后归还连接
+| 最常用，连接复用率最高
+
+| statement
+| 每条语句后归还连接
+| 限制最多，不支持显式事务
+|===
+
+== 安装
+
+[TIP]
+源码测试安装环境为 Ubuntu 24.04。
+
+=== 依赖
+
+[literal]
+----
+# Ubuntu / Debian
+sudo apt install libevent-dev libssl-dev pkg-config
+
+# RHEL / Rocky Linux
+sudo dnf install libevent-devel openssl-devel pkgconfig
+----
+
+=== 源码安装
+
+[literal]
+----
+git clone https://github.com/pgbouncer/pgbouncer.git
+cd pgbouncer
+
+./autogen.sh
+
+./configure \
+    --prefix=/usr/ivory-5 \
+    --with-openssl \
+    --with-pam
+
+make -j4
+make install
+cp pgbouncer /usr/ivory-5/bin/
+----
+
+=== 验证安装
+
+[literal]
+----
+pgbouncer --version
+# PgBouncer 1.25.1
+# libevent 2.1.12-stable
+# tls: OpenSSL 3.0.2 15 Mar 2022
+----
+
+== 配置
+
+=== 连接 IvorySQL PG 模式（端口 5432）
+
+创建 `/etc/pgbouncer/pgbouncer.ini`：
+
+[literal]
+----
+[databases]
+postgres = host=127.0.0.1 port=5432 dbname=postgres
+
+[pgbouncer]
+listen_addr = 127.0.0.1
+listen_port = 6432
+auth_type = trust
+auth_file = /etc/pgbouncer/userlist.txt
+pool_mode = transaction
+max_client_conn = 200
+default_pool_size = 20
+logfile = /var/log/pgbouncer/pgbouncer.log
+pidfile = /var/run/pgbouncer/pgbouncer.pid
+----
+
+=== 连接 IvorySQL Oracle 兼容模式（端口 1521）
+
+[literal]
+----
+[databases]
+postgres = host=127.0.0.1 port=1521 dbname=postgres
+
+[pgbouncer]
+listen_addr = 127.0.0.1
+listen_port = 2521
+auth_type = trust
+auth_file = /etc/pgbouncer/userlist.txt
+
+# Oracle 兼容模式建议使用 session 模式
+pool_mode = session
+
+max_client_conn = 200
+default_pool_size = 20
+logfile = /var/log/pgbouncer/pgbouncer_oracle.log
+pidfile = /var/run/pgbouncer/pgbouncer_oracle.pid
+----
+
+=== 用户认证文件
+
+[literal]
+----
+# /etc/pgbouncer/userlist.txt
+# 格式："用户名" "密码"（trust 模式密码留空）
+"postgres" ""
+"app_user" "app_password"
+----
+
+=== 启动与停止
+
+[literal]
+----
+# 前台启动（调试）
+pgbouncer /etc/pgbouncer/pgbouncer.ini
+
+# 后台启动
+pgbouncer -d /etc/pgbouncer/pgbouncer.ini
+
+# 重载配置（不中断连接）
+kill -HUP $(cat /var/run/pgbouncer/pgbouncer.pid)
+
+# 停止
+kill -INT $(cat /var/run/pgbouncer/pgbouncer.pid)
+----
+
+== 使用
+
+=== 客户端连接
+
+通过 PgBouncer 连接与直连 IvorySQL 语法完全一致，只需修改端口：
+
+[literal]
+----
+# PG 模式（经由 PgBouncer）
+psql -U postgres -p 6432 -d postgres
+
+# Oracle 兼容模式（经由 PgBouncer）
+psql -U postgres -p 2521 -d postgres
+----
+
+=== 管理控制台
+
+PgBouncer 提供内置管理数据库：
+
+[literal]
+----
+psql -U postgres -p 6432 -d pgbouncer
+----
+
+[literal]
+----
+-- 查看连接池状态
+SHOW POOLS;
+
+-- 查看统计信息
+SHOW STATS;
+
+-- 查看客户端连接
+SHOW CLIENTS;
+
+-- 查看后端连接
+SHOW SERVERS;
+
+-- 重载配置
+RELOAD;
+----
+
+=== Oracle 兼容模式
+
+[literal]
+----
+-- 确认 Oracle 模式已激活
+SHOW ivorysql.compatible_mode;
+--  ivorysql.compatible_mode
+-- --------------------------
+--  oracle
+
+-- Oracle 数据类型与函数
+CREATE TABLE bouncer_test (
+    id     NUMBER(10) PRIMARY KEY,
+    name   VARCHAR2(100),
+    hired  DATE DEFAULT SYSDATE
+);
+
+INSERT INTO bouncer_test VALUES (1, 'Alice', SYSDATE);
+
+SELECT id,
+       NVL(name, 'N/A')                   AS name,
+       DECODE(id, 1, 'CEO', 'Staff')       AS title,
+       TO_CHAR(hired, 'YYYY-MM-DD')        AS hire_date
+FROM bouncer_test;
+
+-- Oracle 序列
+CREATE SEQUENCE ora_seq START WITH 100 INCREMENT BY 10;
+SELECT ora_seq.NEXTVAL FROM DUAL;   -- 100
+SELECT ora_seq.NEXTVAL FROM DUAL;   -- 110
+SELECT ora_seq.CURRVAL FROM DUAL;   -- 110
+----
diff --git a/EN/modules/ROOT/nav.adoc b/EN/modules/ROOT/nav.adoc
index f346d29..1072627 100644
--- a/EN/modules/ROOT/nav.adoc
+++ b/EN/modules/ROOT/nav.adoc
@@ -53,6 +53,7 @@
 *** xref:master/ecosystem_components/pg_ai_query.adoc[pg_ai_query]
 *** xref:master/ecosystem_components/wal2json.adoc[wal2json]
 *** xref:master/ecosystem_components/pg_stat_monitor.adoc[pg_stat_monitor]
+*** xref:master/ecosystem_components/pgbouncer.adoc[pgbouncer]
 *** xref:master/ecosystem_components/pg_curl.adoc[pg_curl]
 * Monitor and O&M
 ** xref:master/getting-started/daily_monitoring.adoc[Monitoring]
diff --git a/EN/modules/ROOT/pages/master/ecosystem_components/pgbouncer.adoc b/EN/modules/ROOT/pages/master/ecosystem_components/pgbouncer.adoc
new file mode 100644
index 0000000..15a58dd
--- /dev/null
+++ b/EN/modules/ROOT/pages/master/ecosystem_components/pgbouncer.adoc
@@ -0,0 +1,220 @@
+:sectnums:
+:sectnumlevels: 5
+
+= PgBouncer
+
+== Overview
+
+PgBouncer is a lightweight connection pooling middleware that sits between the application layer and the database. It reduces connection overhead, protects database resources, and improves application concurrency performance by reusing backend connections.
+
+PgBouncer uses the standard PostgreSQL communication protocol, which IvorySQL fully supports.
+
+*Three Connection Pooling Modes:*
+
+[cols="1,2,2"]
+|===
+| Mode | Description | Use Case
+
+| session
+| Client exclusively holds one backend connection for the duration of the session
+| Required for in-process COMMIT and full session features
+
+| transaction
+| Connection is returned to the pool after each transaction
+| Most commonly used, highest connection reuse rate
+
+| statement
+| Connection is returned after each statement
+| Most restrictive, does not support explicit transactions
+|===
+
+== Installation
+
+[TIP]
+Source installation was tested on Ubuntu 24.04.
+
+=== Dependencies
+
+[literal]
+----
+# Ubuntu / Debian
+sudo apt install libevent-dev libssl-dev pkg-config
+
+# RHEL / Rocky Linux
+sudo dnf install libevent-devel openssl-devel pkgconfig
+----
+
+=== Source Installation
+
+[literal]
+----
+git clone https://github.com/pgbouncer/pgbouncer.git
+cd pgbouncer
+
+./autogen.sh
+
+./configure \
+    --prefix=/usr/ivory-5 \
+    --with-openssl \
+    --with-pam
+
+make -j4
+make install
+cp pgbouncer /usr/ivory-5/bin/
+----
+
+=== Verify Installation
+
+[literal]
+----
+pgbouncer --version
+# PgBouncer 1.25.1
+# libevent 2.1.12-stable
+# tls: OpenSSL 3.0.2 15 Mar 2022
+----
+
+== Configuration
+
+=== Connecting to IvorySQL PG Mode (Port 5432)
+
+Create `/etc/pgbouncer/pgbouncer.ini`:
+
+[literal]
+----
+[databases]
+postgres = host=127.0.0.1 port=5432 dbname=postgres
+
+[pgbouncer]
+listen_addr = 127.0.0.1
+listen_port = 6432
+auth_type = trust
+auth_file = /etc/pgbouncer/userlist.txt
+pool_mode = transaction
+max_client_conn = 200
+default_pool_size = 20
+logfile = /var/log/pgbouncer/pgbouncer.log
+pidfile = /var/run/pgbouncer/pgbouncer.pid
+----
+
+=== Connecting to IvorySQL Oracle Compatible Mode (Port 1521)
+
+[literal]
+----
+[databases]
+postgres = host=127.0.0.1 port=1521 dbname=postgres
+
+[pgbouncer]
+listen_addr = 127.0.0.1
+listen_port = 2521
+auth_type = trust
+auth_file = /etc/pgbouncer/userlist.txt
+
+# Oracle compatible mode recommends session mode
+pool_mode = session
+
+max_client_conn = 200
+default_pool_size = 20
+logfile = /var/log/pgbouncer/pgbouncer_oracle.log
+pidfile = /var/run/pgbouncer/pgbouncer_oracle.pid
+----
+
+=== User Authentication File
+
+[literal]
+----
+# /etc/pgbouncer/userlist.txt
+# Format: "username" "password" (trust mode can leave password empty)
+"postgres" ""
+"app_user" "app_password"
+----
+
+=== Start and Stop
+
+[literal]
+----
+# Foreground mode (for debugging)
+pgbouncer /etc/pgbouncer/pgbouncer.ini
+
+# Daemon mode
+pgbouncer -d /etc/pgbouncer/pgbouncer.ini
+
+# Reload configuration (without interrupting connections)
+kill -HUP $(cat /var/run/pgbouncer/pgbouncer.pid)
+
+# Stop
+kill -INT $(cat /var/run/pgbouncer/pgbouncer.pid)
+----
+
+== Usage
+
+=== Client Connection
+
+Connecting through PgBouncer uses the exact same syntax as connecting directly to IvorySQL, only the port changes:
+
+[literal]
+----
+# PG mode (via PgBouncer)
+psql -U postgres -p 6432 -d postgres
+
+# Oracle compatible mode (via PgBouncer)
+psql -U postgres -p 2521 -d postgres
+----
+
+=== Admin Console
+
+PgBouncer provides a built-in administration database:
+
+[literal]
+----
+psql -U postgres -p 6432 -d pgbouncer
+----
+
+[literal]
+----
+-- View pool status
+SHOW POOLS;
+
+-- View statistics
+SHOW STATS;
+
+-- View client connections
+SHOW CLIENTS;
+
+-- View backend connections
+SHOW SERVERS;
+
+-- Reload configuration
+RELOAD;
+----
+
+=== Oracle Compatible Mode
+
+[literal]
+----
+-- Verify Oracle mode is active
+SHOW ivorysql.compatible_mode;
+--  ivorysql.compatible_mode
+-- --------------------------
+--  oracle
+
+-- Oracle data types and functions
+CREATE TABLE bouncer_test (
+    id     NUMBER(10) PRIMARY KEY,
+    name   VARCHAR2(100),
+    hired  DATE DEFAULT SYSDATE
+);
+
+INSERT INTO bouncer_test VALUES (1, 'Alice', SYSDATE);
+
+SELECT id,
+       NVL(name, 'N/A')                   AS name,
+       DECODE(id, 1, 'CEO', 'Staff')       AS title,
+       TO_CHAR(hired, 'YYYY-MM-DD')        AS hire_date
+FROM bouncer_test;
+
+-- Oracle sequences
+CREATE SEQUENCE ora_seq START WITH 100 INCREMENT BY 10;
+SELECT ora_seq.NEXTVAL FROM DUAL;   -- 100
+SELECT ora_seq.NEXTVAL FROM DUAL;   -- 110
+SELECT ora_seq.CURRVAL FROM DUAL;   -- 110
+----
\ No newline at end of file