mjava-ai/openspec/changes/init-project-baseline/proposal.md

状态（2026-04-18 新建）：文档提案，无代码动作

Why

mjava-ai 仓库已稳定承载三个生产客户（mcli / shunfeng / guangming），基座 mjava 的核心能力（UtilHttp / UtilToken / McR / JPA+QueryDSL / 全局异常 / TraceId）已经形成事实规范但没有被文档化。新成员或新客户接入时，缺少一份"权威基线"文档可以指向。

同时，openspec/specs/ 目录此前为空，OpenSpec 工作流缺少稳态规范锚点。现需要沉淀一份指针式的 baseline spec，把开发规范主权交给文档中心 /Users/malk/Desktop/Tech/claude/后端/mjava-baseline.md，仓库内只保留"差异 + 代码锚点"。

What Changes

本提案不改任何 Java 源码、不改 pom、不 push git，仅沉淀规范与索引：

• 新建 openspec/specs/project-baseline.md —— 一页纸稳态 spec，指向文档中心的权威规范，并列出仓库内关键代码锚点
• 新建仓库根 CLAUDE.md —— 给未来在该仓库工作的 AI / 新成员一个 40 行以内的入口，链到 openspec 工作流与文档中心
• 通过 /Users/malk/Desktop/Tech/claude/后端/mjava-baseline.md 权威化 11 项规范（HTTP / Token / 配置 / 响应异常 / 持久化 / 日志链路 / 子项目接入 / 构建 / YAGNI 清单 等）

Capabilities

New Capabilities

• project-baseline: 项目基线规范锚点（仓库内 specs/ 层），定义"什么是 mjava-ai 的标准开发方式"

Modified Capabilities

Impact

• 代码影响：零
• pom 影响：零
• 配置影响：零
• 对生产：零（mcli/shunfeng/guangming 运行不受任何影响）
• 对新客户接入：有正向指引——按 mjava-baseline.md 第 9 章复制 mjava-mcli 模板即可
• 对 OpenSpec 工作流：openspec/specs/ 不再为空，后续新 change 可以 reference baseline

Non-Goals

显式声明本次不做：

• ❌ 删除或改造 mjava-shunfeng / mjava-guangming 子模块（保障生产可用）
• ❌ 修改根 pom 的 <modules> 聚合
• ❌ 升级 mjava.version
• ❌ 引入 Redis / Docker / 消息队列 / K8s（见 mjava-baseline.md 第 11 章）
• ❌ 为新客户搭空脚手架（等实际需求来临再走 /opsx:propose）
• ❌ git commit / push / 设置 remote