refactor(stage7): 后端目录分层、架构守护测试与文档

后端目录
- db/：mysql / hydrogen / heatmap 连接与氢能只读 SQL 守卫收拢到一处。
- middleware/：auth（JWT → 注入 user）与 read-only 归位。
- 相关测试随文件移动（middleware/read-only.test.ts、db/hydrogen-read-only.test.ts）。
  import 改写由一次性 codemod 完成，未改变任何逻辑。

架构守护
- 新增 src/architecture.test.ts，断言 6 条分层铁律：
  server 不依赖 modules、前端不依赖 server、shared 为叶子层、
  无 vendor 引用、model.ts 不依赖 react、@ts-nocheck 仅限已登记的原型快照。
  豁免清单只减不增。

测试基建
- npm test 的 glob 同时匹配 .test.ts 与 .test.tsx（此前 .tsx 测试会被静默漏掉）。

文档
- 新增根 README.md：入口、快速开始、命令、目录、部署注意事项
  （JWT_SECRET 必须注入且 >=32 字符，否则拒绝启动）。
- 新增 docs/ARCHITECTURE.md：依赖方向、6 条硬规则、业务域形状、
  中间件顺序、新增模块步骤，以及"已知未尽事项"的诚实清单。

lint / test(134) / build 全绿。

src/server/routes/ele/index.ts

@@ -1,7 +1,7 @@
 import { Hono } from 'hono';
 import type { RowDataPacket, ResultSetHeader } from 'mysql2';
 import * as XLSX from 'xlsx';
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import type { AuthUser } from '../../auth/types.js';
 import { canAccessEnergy } from '../../auth/types.js';
 import { ensureChargeRecordTable } from './migration.js';

src/server/routes/ele/migration.ts

@@ -1,4 +1,4 @@
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 
 const CREATE_TABLE_SQL = `
 CREATE TABLE IF NOT EXISTS bi_ele_charge_record (

src/server/routes/energy/electric.ts

@@ -1,6 +1,6 @@
 import type { Hono } from 'hono';
 import type { RowDataPacket } from 'mysql2';
-import type pool from '../../db.js';
+import type pool from '../../db/mysql.js';
 import type { cached } from './cache.js';
 import {
   dateRangeClause,

src/server/routes/energy/etc.ts

@@ -1,6 +1,6 @@
 import type { Hono } from 'hono';
 import type { RowDataPacket } from 'mysql2';
-import type pool from '../../db.js';
+import type pool from '../../db/mysql.js';
 import type { cached } from './cache.js';
 
 export interface EtcOverviewDependencies {

src/server/routes/energy/hydrogen-bi-v2.ts

@@ -1,6 +1,6 @@
 import type { Hono } from "hono";
 import type { RowDataPacket } from "mysql2";
-import type hydrogenPool from "../../hydrogen-db.js";
+import type hydrogenPool from "../../db/hydrogen.js";
 import {
   HYDROGEN_FUEL_ONLY_WHERE,
   HYDROGEN_FUEL_ONLY_WHERE_B,

src/server/routes/energy/hydrogen-station-board.ts

@@ -1,6 +1,6 @@
 import type { Hono } from 'hono';
 import type { RowDataPacket } from 'mysql2';
-import type hydrogenPool from '../../hydrogen-db.js';
+import type hydrogenPool from '../../db/hydrogen.js';
 import type { cached } from './cache.js';
 import { HYDROGEN_BASE_WHERE, HYDROGEN_BASE_WHERE_B, HYDROGEN_LOCAL, HYDROGEN_TABLE } from './constants.js';
 import { dateRangeClause, enumerateDateRange, resolveDateRange } from './query-model.js';

src/server/routes/energy/index.ts

@@ -1,8 +1,8 @@
 import { Hono } from 'hono';
 import type { AuthUser } from '../../auth/types.js';
 import { canAccessEnergy } from '../../auth/types.js';
-import pool from '../../db.js';
-import hydrogenPool from '../../hydrogen-db.js';
+import pool from '../../db/mysql.js';
+import hydrogenPool from '../../db/hydrogen.js';
 import { cached } from './cache.js';
 import {
   registerElectricMonthlyRoute,

src/server/routes/feedback/index.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
 import type { ResultSetHeader, RowDataPacket } from 'mysql2';
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import type { AuthUser } from '../../auth/types.js';
 import { canManageFeedback } from '../../auth/types.js';
 import { uploadFeedbackImage } from './oss.js';

src/server/routes/hydrogen-heatmap.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
 import type { RowDataPacket } from 'mysql2';
-import pool from '../db.js';
+import pool from '../db/mysql.js';
 import type { AuthUser } from '../auth/types.js';
 import { canAccessEnergy } from '../auth/types.js';
 import {

src/server/routes/mileage/cache.ts

@@ -1,7 +1,7 @@
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import { fetchVehicleInfoMap } from './vehicle-info.js';
 import { fetchOneOsDailyMileage, fetchOneOsMileageDates } from './oneos-api.js';
 import {

src/server/routes/mileage/daily-report-service.ts

@@ -1,5 +1,5 @@
 import type { RowDataPacket } from 'mysql2';
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import type {
   DailyMileageReport,
   MileageReportBreakdown,

src/server/routes/mileage/daily-report-store.ts

@@ -1,5 +1,5 @@
 import type { ResultSetHeader, RowDataPacket } from 'mysql2';
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import type {
   DailyMileageReport,
   MileageReportHistoryItem,

src/server/routes/mileage/targets.ts

@@ -1,5 +1,5 @@
 import { Hono } from 'hono';
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import { getCache } from './cache.js';
 import { fetchOneOsDailyMileage } from './oneos-api.js';
 import { fetchVehicleInfoByPlates } from './vehicle-info.js';

src/server/routes/mileage/trend.ts

@@ -1,5 +1,5 @@
 import { Hono } from 'hono';
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import { fetchOneOsMileageDates } from './oneos-api.js';
 
 const app = new Hono();

src/server/routes/mileage/vehicle-info.ts

@@ -1,4 +1,4 @@
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import type { VehicleInfoRow } from './types.js';
 
 /** 车辆关联信息 SQL（客户名、部门、经理、租赁状态、主体、项目、品牌） */

src/server/routes/scheduling/db-schema.ts

@@ -1,4 +1,4 @@
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 
 const CREATE_NOTIFICATIONS_TABLE = `
 CREATE TABLE IF NOT EXISTS tab_scheduling_notifications (

src/server/routes/scheduling/notify.ts

@@ -1,5 +1,5 @@
 import { Hono } from 'hono';
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import type { AuthUser } from '../../auth/types.js';
 import type {
   NotifyRequest,

src/server/routes/scheduling/suggestions.ts

@@ -1,5 +1,5 @@
 import { Hono } from 'hono';
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import { fetchVehicleInfoMap } from '../mileage/vehicle-info.js';
 import { fetchOneOsMileageDates } from '../mileage/oneos-api.js';
 import { mapRegion } from '../vehicles.js';

src/server/routes/vehicle-heatmap.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import pool from '../db.js';
-import heatmapPool from '../heatmap-db.js';
+import pool from '../db/mysql.js';
+import heatmapPool from '../db/heatmap.js';
 import { getCache } from './mileage/cache.js';
 import {
   buildVehicleGrid,

src/server/routes/vehicles/repository.ts

@@ -1,4 +1,4 @@
-import pool from '../../db.js';
+import pool from '../../db/mysql.js';
 import type { Vehicle, VehicleRow } from '../../types.js';
 import { transformRow } from './model.js';
 import type { WeeklyTruckIds } from './types.js';