M0: 工作区骨架 + 五道门禁 + 环境自举

- pnpm workspaces / tsconfig 双工程(node · web)/ 路径别名(§11.1) - eslint flat(§11.3 + §12.5 可机检项)/ dependency-cruiser 基线八条 + JCAI 增补(§11.4) - tools/module-tiers.json + gen-depcruise-tiers.ts 生成 tier-order 逐层规则 - tools/api-report.mjs 契约快照只留契约面(ADR-005) - docker-compose(PG16)+ db/init 四 schema;种子数据五岗位五员工冻结为常量 - docs/debt.md · docs/adr/ADR-005 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2026-07-27 00:18:58 +08:00
commit 7cd664af3a
50 changed files with 9052 additions and 0 deletions
@@ -0,0 +1,12 @@
+{
+  "name": "@app/api",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "exports": { ".": "./src/app/main.ts" },
+  "scripts": {
+    "dev": "tsup --watch --onSuccess \"node dist/main.js\"",
+    "build": "tsup",
+    "seed": "node dist/seed.js"
+  }
+}
@@ -0,0 +1,19 @@
+/**
+ * 环境配置 —— 只在 app/ 层读环境变量;模块内一律经 port 注入(§5.3)。
+ */
+export type AppConfig = {
+  readonly nodeEnv: 'development' | 'test' | 'production';
+  readonly port: number;
+  readonly databaseUrl: string;
+};
+
+const DEFAULT_DATABASE_URL = 'postgres://jcai:jcai@localhost:54329/jcai';
+
+export function loadConfig(env: NodeJS.ProcessEnv = process.env): AppConfig {
+  const nodeEnv = env['NODE_ENV'];
+  return {
+    nodeEnv: nodeEnv === 'production' || nodeEnv === 'test' ? nodeEnv : 'development',
+    port: Number(env['PORT'] ?? 8787),
+    databaseUrl: env['DATABASE_URL'] ?? DEFAULT_DATABASE_URL,
+  };
+}
@@ -0,0 +1,18 @@
+/**
+ * apps/api 唯一组装层入口(编码规范 §5.2)。
+ * 只有 app/ 能同时认识多个模块:new adapter、注入 port、注册路由 / worker / Mastra 实例。
+ *
+ * M0:骨架 —— 门禁跑通即可,业务装配自 M1 起逐层填入。
+ */
+import { loadConfig } from './config.ts';
+
+export async function boot(): Promise<void> {
+  const config = loadConfig();
+  process.stdout.write(
+    `JCAI api · M0 骨架 · env=${config.nodeEnv} · port=${config.port} · db=${config.databaseUrl.replace(/:[^:@]*@/, ':***@')}\n`,
+  );
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  await boot();
+}
@@ -0,0 +1,49 @@
+/**
+ * 种子数据与播种入口(编码规范 §15 · M0)。
+ *
+ * 数据是常量、写入是端口 —— M0 立骨架:数据在此冻结,写入实现随 M1 的 `org` 模块落地。
+ * 部署边界:单次部署 ≤50 人、单组织、不做多租户(OS 0.3)。
+ */
+
+/** 岗位:编排层声明岗位,起单时按四策略解析出人(OS 03) */
+export const POSITION_SEED = [
+  { code: 'PM', name: '项目经理', note: '定价审批、策略拍板' },
+  { code: 'BD', name: '商务', note: 'RFQ 受理、成本定价、报价议价、情报归档' },
+  { code: 'FAE', name: '现场应用', note: '替代选型' },
+  { code: 'PRM', name: '采购/寻源', note: '渠道寻源' },
+  { code: 'OP', name: '运营', note: '运营支持' },
+] as const;
+
+/** 员工五人;登录者 = 冯兵(BD) */
+export const STAFF_SEED = [
+  { account: 'dingziqiao', name: '丁子乔', position: 'PM' },
+  { account: 'fengbing', name: '冯兵', position: 'BD' },
+  { account: 'wangziming', name: '王梓名', position: 'FAE' },
+  { account: 'linpeixuan', name: '林佩萱', position: 'PRM' },
+  { account: 'liyuanchu', name: '李元初', position: 'OP' },
+] as const;
+
+/** 默认登录者(MVP 单组织 cookie session,§4 鉴权定调) */
+export const DEFAULT_LOGIN_ACCOUNT = 'fengbing';
+
+export type PositionSeed = (typeof POSITION_SEED)[number];
+export type StaffSeed = (typeof STAFF_SEED)[number];
+
+/** 播种端口 —— 实现由 app/ 在 M1 注入(org 模块出口) */
+export type OrgSeeder = {
+  upsertPosition(position: PositionSeed): Promise<void>;
+  upsertStaff(staff: StaffSeed): Promise<void>;
+};
+
+export async function runSeed(seeder: OrgSeeder): Promise<void> {
+  for (const position of POSITION_SEED) await seeder.upsertPosition(position);
+  for (const staff of STAFF_SEED) await seeder.upsertStaff(staff);
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  process.stdout.write(
+    `种子数据:${POSITION_SEED.length} 个岗位 / ${STAFF_SEED.length} 名员工;` +
+      `登录者=${DEFAULT_LOGIN_ACCOUNT}\n` +
+      '写入实现随 M1 `org` 模块落地(docs/debt.md · M0-1)。\n',
+  );
+}
@@ -0,0 +1,13 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: { main: 'src/app/main.ts', seed: 'src/app/seed.ts' },
+  format: ['esm'],
+  target: 'node22',
+  platform: 'node',
+  outDir: 'dist',
+  clean: true,
+  sourcemap: true,
+  skipNodeModulesBundle: true,
+  tsconfig: '../../tsconfig.node.json',
+});
@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>JCAI · 任务操作系统</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/app/main.tsx"></script>
+  </body>
+</html>
@@ -0,0 +1,21 @@
+{
+  "name": "@app/web",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.1",
+    "@vitejs/plugin-react": "^5.0.4",
+    "vite": "^7.1.12"
+  }
+}
@@ -0,0 +1,10 @@
+/**
+ * 应用壳 —— M0 骨架。工作台五要素 / 治理台九功能的 features 自 M6 起挂入。
+ */
+export function AppShell() {
+  return (
+    <div className="proto-root">
+      <main className="app-shell">JCAI · 任务操作系统 —— M0 骨架</main>
+    </div>
+  );
+}
@@ -0,0 +1,16 @@
+/**
+ * apps/web 唯一组装层(编码规范 §9):路由、Provider、鉴权壳、SSE 连接。
+ * M0:骨架 —— 两台原型的 1:1 平移自 M6 起(README《前端 UI · 原型 1:1 平移》)。
+ */
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import { AppShell } from './app-shell.tsx';
+
+const container = document.getElementById('root');
+if (!container) throw new Error('#root 缺失');
+
+createRoot(container).render(
+  <StrictMode>
+    <AppShell />
+  </StrictMode>,
+);
@@ -0,0 +1 @@
+/// <reference types="vite/client" />
@@ -0,0 +1,26 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import { fileURLToPath } from 'node:url';
+
+const root = fileURLToPath(new URL('../..', import.meta.url));
+const p = (rel: string) => fileURLToPath(new URL(rel, import.meta.url));
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      '@contracts': `${root}packages/contracts/src/index.ts`,
+      '@sfeel': `${root}packages/sfeel/src/index.ts`,
+      '@ui': `${root}packages/ui-kit/src/index.ts`,
+      '@utils': `${root}packages/utils/src/index.ts`,
+      '@features': p('./src/features'),
+      '@web-shared': p('./src/shared'),
+    },
+  },
+  server: {
+    port: 5173,
+    proxy: {
+      '/api': { target: 'http://localhost:8787', changeOrigin: true },
+    },
+  },
+});