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

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

server/src/api/routes/finance.ts

@@ -0,0 +1,134 @@
+import { Router } from 'express';
+import { requirePermission } from '../../core/guards/rbac.guard';
+import { requireTraceContext } from '../../core/guards/trace-context.guard';
+import { CommodityHedgingService } from '../../services/CommodityHedgingService';
+import { PoolSourcingService } from '../../services/PoolSourcingService';
+import { SovereignCreditPoolService } from '../../services/SovereignCreditPoolService';
+import { SovereigntySettlementService } from '../../services/SovereigntySettlementService';
+import { PricingController } from '../controllers/PricingController';
+import { SettlementController } from '../controllers/SettlementController';
+
+const router = Router();
+
+/**
+ * [BIZ_ARB_01] 统一净利测算与风控
+ */
+router.post('/calculate', requireTraceContext, PricingController.calculate);
+
+/**
+ * [BIZ_FIN_12] 多币种汇率避险接口
+ */
+router.post('/fx/lock-rate', requireTraceContext, requirePermission('finance:write'), PricingController.lockRate);
+router.get('/fx/gain-loss', requireTraceContext, requirePermission('finance:read'), PricingController.getFXGainLoss);
+
+/**
+ * [BIZ_FIN_08] 实时毛利计算与分账引擎 (Settlement)
+ */
+router.get('/settlement/summary', requireTraceContext, requirePermission('finance:read'), SettlementController.getSummary);
+router.get('/settlement/:orderId', requireTraceContext, requirePermission('finance:read'), SettlementController.settleOrder);
+
+/**
+ * [BIZ_FIN_01] 财务对账链路
+ */
+router.get('/reconcile/:orderId', requireTraceContext, PricingController.reconcile);
+
+/**
+ * [BIZ_FIN_01] 租户账单回放
+ */
+router.get('/playback', requireTraceContext, PricingController.getPlayback);
+
+/**
+ * [BIZ_SOV_03] 跨平台资金主权结算 (Sovereignty Settlement)
+ */
+router.post('/sovereignty/settle', requireTraceContext, requirePermission('finance:write'), async (req, res) => {
+  try {
+    const { tenantId, traceId } = (req as any).traceContext;
+    const { amount, currency } = req.body;
+    const hash = await SovereigntySettlementService.initiateSettlement(tenantId, amount, currency, traceId);
+    res.json({ success: true, data: { settlementHash: hash } });
+  } catch (err: any) {
+    res.status(500).json({ success: false, error: err.message });
+  }
+});
+
+router.get('/sovereignty/history', requireTraceContext, requirePermission('finance:read'), async (req, res) => {
+  try {
+    const { tenantId } = (req as any).traceContext;
+    const history = await SovereigntySettlementService.getSettlementHistory(tenantId);
+    res.json({ success: true, data: history });
+  } catch (err: any) {
+    res.status(500).json({ success: false, error: err.message });
+  }
+});
+
+/**
+ * [BIZ_FIN_20] 基于主权身份的全球授信池 (Sovereign Credit Pool)
+ */
+router.post('/sovereignty/credit/init', requireTraceContext, requirePermission('finance:admin'), async (req, res) => {
+  try {
+    const { tenantId, traceId } = (req as any).traceContext;
+    await SovereignCreditPoolService.initializeCreditPool(tenantId, traceId);
+    res.json({ success: true, message: 'Sovereign credit pool initialized' });
+  } catch (err: any) {
+    res.status(500).json({ success: false, error: err.message });
+  }
+});
+
+router.post('/sovereignty/credit/refresh', requireTraceContext, requirePermission('finance:admin'), async (req, res) => {
+  try {
+    const { tenantId, traceId } = (req as any).traceContext;
+    await SovereignCreditPoolService.refreshCreditLimit(tenantId, traceId);
+    res.json({ success: true, message: 'Sovereign credit limit refreshed based on latest reputation' });
+  } catch (err: any) {
+    res.status(500).json({ success: false, error: err.message });
+  }
+});
+
+/**
+ * [BIZ_FIN_14] 大宗商品价格对冲 (Commodity Hedging)
+ */
+router.post('/hedging/create', requireTraceContext, requirePermission('finance:write'), async (req, res) => {
+  try {
+    const { tenantId, traceId } = (req as any).traceContext;
+    const { commodityType, quantity, strikePrice, expiryDate } = req.body;
+    const id = await CommodityHedgingService.createHedgingPosition(tenantId, commodityType, quantity, strikePrice, new Date(expiryDate), traceId);
+    res.json({ success: true, data: { positionId: id } });
+  } catch (err: any) {
+    res.status(500).json({ success: false, error: err.message });
+  }
+});
+
+router.get('/hedging/active', requireTraceContext, requirePermission('finance:read'), async (req, res) => {
+  try {
+    const { tenantId } = (req as any).traceContext;
+    const positions = await CommodityHedgingService.getActivePositions(tenantId);
+    res.json({ success: true, data: positions });
+  } catch (err: any) {
+    res.status(500).json({ success: false, error: err.message });
+  }
+});
+
+/**
+ * [BIZ_FIN_18] 跨租户集中采购议价池 (Pool Sourcing)
+ */
+router.post('/pool/join', requireTraceContext, requirePermission('finance:write'), async (req, res) => {
+  try {
+    const { tenantId, traceId } = (req as any).traceContext;
+    const { commodityType, quantity } = req.body;
+    await PoolSourcingService.joinPool(tenantId, commodityType, quantity, traceId);
+    res.json({ success: true, message: 'Joined procurement pool successfully' });
+  } catch (err: any) {
+    res.status(500).json({ success: false, error: err.message });
+  }
+});
+
+router.get('/pool/active', requireTraceContext, requirePermission('finance:read'), async (req, res) => {
+  try {
+    const pools = await PoolSourcingService.getActivePools();
+    res.json({ success: true, data: pools });
+  } catch (err: any) {
+    res.status(500).json({ success: false, error: err.message });
+  }
+});
+
+export default router;