9bff46a1b0
Sentry Integration (補強 SignOz): - Add @sentry/nextjs for frontend error tracking + session replay - Add sentry-sdk[fastapi] for backend error tracking - Create sentry.client/server/edge.config.ts - Integrate with next.config.js + instrumentation.ts - Add Sentry exception capture in FastAPI error handler - Create deployment scripts for Self-Hosted @ 192.168.0.110 CI/CD Fixes: - Fix F821 Undefined name 'Field' in incidents.py - Add NEXT_PUBLIC_API_URL env var to CI build step - Add build-arg to Docker build verification E2E Test Improvements: - Fix strict mode violations in dashboard-acceptance tests - Add timeout increase for Phase 4 demo tests - Make tests more resilient to UI variations Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
109 lines
3.2 KiB
Markdown
109 lines
3.2 KiB
Markdown
# AWOOOI Project Configuration
|
||
|
||
> Claude Code 自動載入，定義核心原則
|
||
|
||
---
|
||
|
||
## 🚨🚨🚨 強制提醒 (每小時自我檢查)
|
||
|
||
**你有確實執行以下動作嗎？沒有就立刻執行！**
|
||
|
||
```
|
||
□ 讀過 MEMORY.md 索引？
|
||
□ 讀過 docs/LOGBOOK.md 最新進度？
|
||
□ 讀過 docs/HARD_RULES.md 絕對禁止規則？
|
||
□ 涉及特定主題時，讀過對應 feedback_*.md？
|
||
□ 修改檔案前，讀過該檔案的所有註解？ 🔴 NEW
|
||
```
|
||
|
||
**違反後果**: 重複犯錯、統帥需要反覆提醒、信任度下降
|
||
|
||
---
|
||
|
||
## 🔴 絕對禁止 (Hard Rules)
|
||
|
||
**做任何修改前，先讀對應的鐵律文件：**
|
||
|
||
→ [HARD_RULES.md](docs/HARD_RULES.md)
|
||
|
||
---
|
||
|
||
## ⚠️ Session 啟動第一步
|
||
|
||
**在做任何事之前，先讀：**
|
||
1. `MEMORY.md` - 記憶索引
|
||
2. `docs/LOGBOOK.md` - 最新進度
|
||
3. `docs/HARD_RULES.md` - 絕對禁止規則
|
||
4. 涉及主題的 `feedback_*.md`
|
||
|
||
**不要讓統帥說「你讀過 Memory 了嗎？」**
|
||
|
||
---
|
||
|
||
## 四大核心原則
|
||
|
||
1. **變更前 → 先讀註解** (理解設計意圖再動手) 🔴 NEW
|
||
2. **不可逆操作 → 人工確認** (刪除、logOut、DROP、force push)
|
||
3. **有疑問 → 先問統帥** (不確定就停下來)
|
||
4. **任務完成 → 更新 Memory** (不等被問)
|
||
|
||
## 專案架構
|
||
|
||
- `apps/api/` - FastAPI 後端
|
||
- `apps/web/` - Next.js 前端
|
||
- `k8s/` - Kubernetes 配置
|
||
|
||
## 🛑 修改前
|
||
|
||
修改以下檔案前，**必須先讀** [HARD_RULES.md](docs/HARD_RULES.md)：
|
||
|
||
- `.github/workflows/*` → GitHub Billing 章節
|
||
- `*telegram*` → Telegram Token 章節
|
||
- `apps/web/**` → i18n 章節
|
||
- Incident/Approval 流程 → 確認 Telegram + DB 鏈路
|
||
|
||
---
|
||
|
||
## 任務前必讀
|
||
|
||
涉及以下主題時，**先讀取對應 Memory**：
|
||
|
||
| 主題 | Memory 路徑 |
|
||
|------|-------------|
|
||
| **變更前必讀** | `feedback_read_comments_first.md` 🔴 先讀註解 |
|
||
| **重大變更** | `feedback_product_survival_principles.md` |
|
||
| Telegram | `feedback_telegram_token_disaster.md` |
|
||
| OpenClaw | `feedback_architecture_openclaw_core.md` |
|
||
| 命名規範 | `feedback_openclaw_naming.md` |
|
||
| i18n | `feedback_i18n_zero_hardcode.md` |
|
||
| 防禦性工程 | `feedback_defensive_engineering.md` |
|
||
| 模組化 | `feedback_modular_architecture.md` |
|
||
| API 整合 | `feedback_api_response_verification.md` |
|
||
| 構建部署 | `feedback_build_from_git_only.md` |
|
||
| **測試** | `feedback_no_mock_testing.md` 🔴🔴 禁止 Mock |
|
||
| **API 路徑** | `feedback_api_path_naming.md` 🔴 修改需同步前端 |
|
||
| **部署驗證** | `feedback_deployment_verification.md` 🔴🔴 必須驗證 Pod 版本 |
|
||
|
||
## Skills 載入
|
||
|
||
| 任務類型 | Skill 路徑 |
|
||
|---------|-----------|
|
||
| 前端 | `.agents/skills/01-awoooi-frontend-aesthetics.md` |
|
||
| 後端 | `.agents/skills/02-lewooogo-backend-core.md` |
|
||
| AI/決策 | `.agents/skills/03-openclaw-cognitive-expert.md` |
|
||
| DevOps | `.agents/skills/04-awoooi-devops-commander.md` |
|
||
| 測試 | `.agents/skills/05-awoooi-sre-qa.md` |
|
||
| Git | `.agents/skills/06-awoooi-monorepo-master.md` |
|
||
|
||
## Memory 系統
|
||
|
||
- 長期記憶：`~/.claude/projects/-Users-ogt-awoooi/memory/`
|
||
- 索引：`MEMORY.md`
|
||
- 進度：`docs/LOGBOOK.md`
|
||
|
||
## Session 協議
|
||
|
||
**啟動時**：讀 MEMORY.md → LOGBOOK.md → 確認當前任務
|
||
|
||
**結束前**：更新相關 Memory → 更新 LOGBOOK → 標記下一步
|