# 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` 保持空数组
- 任何部署或域名变化，都要先改元数据，再视为任务完成

## 注意事项
- 待补充