# Task A: Template Audit + Convention Freeze

## ALLA OS CRM vNext / Organization-based

คุณคือ Senior Full-stack Engineer + System Architect
ให้สำรวจ template project ปัจจุบันก่อนเริ่ม production code สำหรับ ALLA OS CRM vNext

## Context สำคัญ

ระบบนี้ต้องยึด **organization-based / workspace-based** เป็นแกนหลัก

```txt
organizationId = tenant / workspace / company group scope
membership = user role + permissions ภายใน organization
branchId = business branch / document scope ภายใน organization
```

ห้ามตีความ `branchId` เป็น tenant หลัก
ห้ามออกแบบแบบ branch-first

## ไฟล์/Skill ที่ต้องอ่านก่อน

ก่อนสรุป convention ต้องอ่าน:

```txt
.agents/skills/kiranism-shadcn-dashboard
Layout.md
AGENTS.md
README.md
package.json
src/db/schema.ts
src/lib/auth
src/app/dashboard
src/features
src/components
```

ถ้า path บางรายการไม่มี ให้ระบุใน audit ว่า “not found” ห้ามเดา

## เป้าหมาย

สร้างเอกสาร audit เพื่อ freeze convention ก่อนทำ Task B

## สิ่งที่ต้องตรวจ

1. Project structure
2. App Router structure
3. Dashboard layout
4. Layout rule จาก `Layout.md`
5. Skill rule จาก `.agents/skills/kiranism-shadcn-dashboard`
6. Sidebar / navigation pattern
7. PageContainer pattern
8. Server component / client component pattern
9. Data fetching pattern
10. TanStack Query / Hydration pattern
11. Form pattern
12. DataTable pattern
13. Sheet / Dialog / Drawer pattern
14. Drizzle schema convention
15. API route / server action convention
16. Feature folder convention
17. Auth convention
18. Organization context
19. Membership / permission / RBAC pattern
20. Active organization handling
21. Existing dashboard visual tone
22. Design token / theme usage
23. Files that should not be touched
24. Risk before Task B

## ข้อกำหนดสำคัญ

* ห้าม implement feature
* ห้าม refactor
* ห้ามเปลี่ยน config
* ห้ามเพิ่ม dependency
* ห้าม run build/test/lint จนกว่าจะได้รับคำสั่ง
* ห้ามสร้าง design system ใหม่
* ห้ามสร้าง layout ใหม่ถ้า template มีอยู่แล้ว
* ต้องยึด `Layout.md` และ dashboard skill เป็น source of truth ด้าน UI

## Output

สร้างไฟล์:

```txt
docs/implementation/task-a-template-audit.md
```

โครงสร้างเอกสาร:

```md
# Task A Template Audit

## 1. Executive Summary

## 2. Project Structure

## 3. Layout.md Findings

## 4. kiranism-shadcn-dashboard Skill Findings

## 5. Routing Convention

## 6. Dashboard Layout Convention

## 7. Feature Folder Convention

## 8. Component Convention

## 9. Form Convention

## 10. Table Convention

## 11. API / Server Action Convention

## 12. Drizzle / Database Convention

## 13. Auth Convention

## 14. Organization / Membership / Permission Convention

## 15. Branch Scope Convention

## 16. UI / Design Token Convention

## 17. CRM vNext Recommended Convention

## 18. Files That Should Not Be Touched

## 19. Risks / Concerns

## 20. Task B Implementation Plan
```

## Definition of Done

Task A ถือว่าเสร็จเมื่อ:

* มี audit document ครบ
* ยืนยันว่า organization-based เป็นแกนหลัก
* ยืนยันว่า branch เป็น sub-scope ภายใน organization
* ระบุ path สำหรับวาง Task B ได้ชัดเจน
* ระบุ convention UI จาก Layout.md และ dashboard skill แล้ว
* ยังไม่มี production feature ถูก implement