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/app.ts

@@ -1,9 +1,9 @@
 import { serveStatic } from '@hono/node-server/serve-static';
 import { Hono } from 'hono';
-import { readOnlyMiddleware } from './read-only-middleware.js';
+import { readOnlyMiddleware } from './middleware/read-only.js';
 import { cors } from 'hono/cors';
 import authRouter from './auth/login.js';
-import { authMiddleware } from './auth/middleware.js';
+import { authMiddleware } from './middleware/auth.js';
 import eleRouter from './routes/ele/index.js';
 import energyRouter from './routes/energy/index.js';
 import feedbackRouter from './routes/feedback/index.js';

src/server/auth/login.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
 import jwt from 'jsonwebtoken';
-import pool from '../db.js';
+import pool from '../db/mysql.js';
 import type { AuthUser, JwtPayload, PermissionLevel } from './types.js';
 import { FULL_ACCESS_ROLES, DEPT_ACCESS_ROLES } from './types.js';
 import { authMode, verifyAuthToken } from './config.js';

src/server/auth/password.test.ts

@@ -3,8 +3,8 @@ import test from 'node:test';
 import { Hono } from 'hono';
 import jwt from 'jsonwebtoken';
 import { passwordRouter } from './password.js';
-import { authMiddleware } from './middleware.js';
-import { readOnlyMiddleware } from '../read-only-middleware.js';
+import { authMiddleware } from '../middleware/auth.js';
+import { readOnlyMiddleware } from '../middleware/read-only.js';
 import { verifyAuthToken } from './config.js';
 
 test('固定密码模式默认关闭、失败限流、只读权限及换密失效', async () => {

src/server/middleware/auth.ts

@@ -1,6 +1,6 @@
 import type { Context, Next } from 'hono';
-import type { AuthUser } from './types.js';
-import { authMode, verifyAuthToken } from './config.js';
+import type { AuthUser } from '../auth/types.js';
+import { authMode, verifyAuthToken } from '../auth/config.js';
 
 
 // 临时：跳过所有认证（保留完整逻辑便于快速恢复）

src/server/middleware/read-only.test.ts

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
 import { Hono } from 'hono';
-import { readOnlyMiddleware } from './read-only-middleware.js';
+import { readOnlyMiddleware } from './read-only.js';
 
 test('read-only preview blocks write handlers but permits reads; normal mode is unchanged', async () => {
   const previous = process.env.DB_READ_ONLY;

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';