1.4 KiB
Tabularium working agreements
-
本仓库专门维护 Endor 文档与制图脚本。支持本地开发;CI/CD 使用现有 ces-control Runner,在 main 通过验证后自动部署。不得修改其他项目、共享 Runner 配置或清理共享 Docker 缓存。
-
Web 技术栈为 TypeScript、React、Tailwind CSS、Next.js Pages Router;不要切换到 App Router。
-
使用 pnpm 管理 JavaScript workspace,使用 uv 管理
tools/figures的 Python 项目,保留两套锁文件。 -
Markdown 正文放在
content/docs,Python 图形源码放在tools/figures/src/endor_figures,可复现的 SVG 输出放在apps/docs/public/figures。 -
未确认的架构提议明确标注为草案,不能表述为现有实现。
-
本地开发与预览只监听
127.0.0.1。部署容器监听0.0.0.0:3000,服务器入口默认 18135,可通过独立 production.env 配置。 -
对 gitea.entroia.com 仅使用 codex-bot,提交身份为 Codex Bot codex-bot@gitea.entroia.local。SSH 使用隔离配置:
ssh -F /dev/null -o IdentitiesOnly=yes -i /Users/zzyang/.codex/credentials/gitea-entroia/codex_entroia_ed25519 -p 22222。 -
每个可验证阶段完成后提交并推送当前远程分支;远程尚未创建时保留本地提交并说明原因。不借用其他账户、不强推。
-
构建按输入内容摘要复用已验证镜像。pnpm、uv、Next.js 缓存按 main/PR 隔离并持久保留;部署与回退只使用
--no-build。