init: project scaffold

RULES.md

@@ -0,0 +1,49 @@
+# FreeMoCap 源码解析
+
+## 启动
+- `python3 -m http.server 4720` — 端口 4720
+
+## 环境一致性
+- Web / API / 后台服务 / 全栈 App 项目必须以本地 Docker 为准：`docker compose up --build`
+- 宿主机 `npm run dev` / `pnpm dev` / `python main.py` 只能作为临时开发辅助，不算交付验证
+- 第一次形成可运行代码时，必须补齐 `Dockerfile`、`docker-compose.yml` 或等价 compose 文件、`.dockerignore`、`.env.example`
+- 线上部署必须复用同一套 Docker 构建逻辑；`git push` 本身不等于线上容器更新
+- 如果本项目属于静态研究页、纯文档、macOS / iOS 原生 App、GPU / GUI / 特殊硬件例外，必须在这里写清原因和实际运行环境
+
+## 部署事实
+- 平台：待定
+- 发布状态：未部署
+- 主站 / 前端：待定
+- API / 后端：待定
+- 文档 / 解析：待定
+- 管理后台：待定
+
+## 快捷登录
+- 登录地址：待补充
+- 用户名：待补充
+- 密码：待补充
+- 说明：这里只写项目专属网页登录；数据库密码、API Key、服务器 root 密码不要写这里
+
+## 元数据回写清单
+- 新增或变更公网地址后，必须同步更新 `.project.json.urls`
+- 仓库内存在 App 源码或构建入口时，必须能在看板显示 `App` 标记；自动检测不准时，手动写 `.project.json.app_artifacts`
+- 如果有网页后台登录：
+  - 可直接入库：写 `.project.json.quick_login`
+  - 不应入库：写 `.project.json.credentials` 引用
+- 部署完成后，`RULES.md` 和 `.project.json` 必须同一次任务一起更新
+
+## 环境变量
+- `.env.example` 必须列出项目运行所需变量名
+- 本地 `.env` 可作为部署运行时配置来源，但不得提交进 Git
+- 部署时默认可以携带本地测试运行数据和密钥；助手只需先提醒风险，除非用户明确说“不带密钥 / 不带数据”
+- 密钥只能进入服务器 env / Coolify 加密变量 / 运行时配置，不得写入 `.project.json.quick_login` 或聊天日志
+
+## 规则
+- 全项目规则真源：`/Users/kangwan/Projects/code/20260317-rules-dashboard/RULES.md`
+- 版本发布规则：`/Users/kangwan/Projects/code/20260317-rules-dashboard/rules/04-版本发布规则.md`
+- 不允许编造不存在的部署域名、账号、密码
+- 没有公网地址时，`.project.json.urls` 保持空数组
+- 任何部署或域名变化，都要先改元数据，再视为任务完成
+
+## 注意事项
+- 待补充