@leejungkiin/awkit 1.0.0

package/templates/brain.example.json

@@ -0,0 +1,321 @@
+{
+  "meta": {
+    "schemaVersion": "1.1.0",
+    "awfVersion": "3.4.0",
+    "createdAt": "2026-01-15T09:00:00Z",
+    "updatedAt": "2026-01-17T18:30:00Z"
+  },
+  "project": {
+    "name": "coffee-shop-manager",
+    "description": "Quản lý tiệm cà phê - đơn hàng, nhân viên, doanh thu",
+    "type": "fullstack",
+    "status": "development",
+    "repository": "https://github.com/user/coffee-shop-manager",
+    "urls": {
+      "local": "http://localhost:3000",
+      "staging": "https://staging.coffee-shop.com",
+      "production": "https://coffee-shop.com"
+    }
+  },
+  "techStack": {
+    "frontend": {
+      "framework": "Next.js 14",
+      "language": "TypeScript",
+      "uiLibrary": "shadcn/ui",
+      "stateManagement": "Zustand",
+      "styling": "TailwindCSS"
+    },
+    "backend": {
+      "framework": "Next.js API Routes",
+      "language": "TypeScript",
+      "runtime": "Node.js 20"
+    },
+    "database": {
+      "type": "PostgreSQL",
+      "orm": "Prisma",
+      "name": "coffee_shop_db"
+    },
+    "infrastructure": {
+      "hosting": "Vercel",
+      "cdn": "Vercel Edge",
+      "ciCd": "GitHub Actions"
+    },
+    "dependencies": [
+      { "name": "next-auth", "version": "^5.0.0", "purpose": "Authentication" },
+      { "name": "react-hook-form", "version": "^7.0.0", "purpose": "Form handling" },
+      { "name": "recharts", "version": "^2.0.0", "purpose": "Dashboard charts" },
+      { "name": "zod", "version": "^3.0.0", "purpose": "Validation" }
+    ]
+  },
+  "architecture": {
+    "pattern": "Feature-based modular",
+    "modules": [
+      {
+        "name": "auth",
+        "path": "src/features/auth",
+        "responsibility": "Authentication & authorization",
+        "dependencies": ["next-auth", "prisma"]
+      },
+      {
+        "name": "orders",
+        "path": "src/features/orders",
+        "responsibility": "Order management CRUD",
+        "dependencies": ["prisma", "zustand"]
+      },
+      {
+        "name": "menu",
+        "path": "src/features/menu",
+        "responsibility": "Menu items & categories",
+        "dependencies": ["prisma"]
+      },
+      {
+        "name": "reports",
+        "path": "src/features/reports",
+        "responsibility": "Revenue & analytics",
+        "dependencies": ["prisma", "recharts"]
+      }
+    ],
+    "externalServices": [
+      {
+        "name": "VNPay",
+        "purpose": "Payment processing",
+        "envVars": [
+          "VNPAY_TMN_CODE",
+          "VNPAY_HASH_SECRET"
+        ]
+      },
+      {
+        "name": "Resend",
+        "purpose": "Email notifications",
+        "envVars": [
+          "RESEND_API_KEY"
+        ]
+      }
+    ]
+  },
+  "databaseSchema": {
+    "tables": [
+      {
+        "name": "users",
+        "description": "Nhân viên & Admin",
+        "columns": [
+          { "name": "id", "type": "uuid", "primary": true },
+          { "name": "email", "type": "string", "nullable": false },
+          { "name": "name", "type": "string", "nullable": false },
+          { "name": "role", "type": "enum(ADMIN,STAFF)", "nullable": false },
+          {
+            "name": "createdAt",
+            "type": "datetime",
+            "nullable": false
+          }
+        ]
+      },
+      {
+        "name": "orders",
+        "description": "Đơn hàng",
+        "columns": [
+          { "name": "id", "type": "uuid", "primary": true },
+          {
+            "name": "userId",
+            "type": "uuid",
+            "foreignKey": "users.id"
+          },
+          { "name": "total", "type": "decimal", "nullable": false },
+          { "name": "status", "type": "enum(PENDING,COMPLETED,CANCELLED)", "nullable": false },
+          {
+            "name": "createdAt",
+            "type": "datetime",
+            "nullable": false
+          }
+        ]
+      },
+      {
+        "name": "order_items",
+        "description": "Chi tiết đơn hàng",
+        "columns": [
+          { "name": "id", "type": "uuid", "primary": true },
+          {
+            "name": "orderId",
+            "type": "uuid",
+            "foreignKey": "orders.id"
+          },
+          {
+            "name": "menuItemId",
+            "type": "uuid",
+            "foreignKey": "menu_items.id"
+          },
+          { "name": "quantity", "type": "int", "nullable": false },
+          { "name": "price", "type": "decimal", "nullable": false }
+        ]
+      },
+      {
+        "name": "menu_items",
+        "description": "Món trong menu",
+        "columns": [
+          { "name": "id", "type": "uuid", "primary": true },
+          { "name": "name", "type": "string", "nullable": false },
+          { "name": "price", "type": "decimal", "nullable": false },
+          { "name": "category", "type": "string", "nullable": false },
+          { "name": "available", "type": "boolean", "nullable": false }
+        ]
+      }
+    ],
+    "relationships": [
+      { "from": "orders", "to": "users", "type": "many-to-one", "description": "Mỗi order thuộc 1 user" },
+      { "from": "order_items", "to": "orders", "type": "many-to-one", "description": "Mỗi order có nhiều items" },
+      { "from": "order_items", "to": "menu_items", "type": "many-to-one", "description": "Mỗi item tham chiếu 1 menu item" }
+    ]
+  },
+  "apiEndpoints": [
+    {
+      "method": "POST",
+      "path": "/api/auth/login",
+      "description": "Đăng nhập",
+      "authRequired": false,
+      "requestBody": {
+        "email": "string",
+        "password": "string"
+      },
+      "response": { "token": "string", "user": "object" }
+    },
+    {
+      "method": "GET",
+      "path": "/api/orders",
+      "description": "Lấy danh sách orders",
+      "authRequired": true,
+      "roles": ["ADMIN", "STAFF"],
+      "response": { "orders": "array", "total": "number", "page": "number" }
+    },
+    {
+      "method": "POST",
+      "path": "/api/orders",
+      "description": "Tạo order mới",
+      "authRequired": true,
+      "roles": ["STAFF"],
+      "requestBody": {
+        "items": "array",
+        "note": "string?"
+      }
+    },
+    {
+      "method": "GET",
+      "path": "/api/reports/revenue",
+      "description": "Báo cáo doanh thu",
+      "authRequired": true,
+      "roles": ["ADMIN"],
+      "response": { "daily": "array", "total": "number" }
+    }
+  ],
+  "businessRules": [
+    {
+      "id": "BR001",
+      "domain": "orders",
+      "rule": "Đơn hàng > 500,000 VND được giảm 5%",
+      "implementation": "src/features/orders/utils/calculate-discount.ts",
+      "exceptions": ["Không áp dụng cho combo"]
+    },
+    {
+      "id": "BR002",
+      "domain": "orders",
+      "rule": "Không thể hủy đơn đã COMPLETED",
+      "implementation": "src/features/orders/actions/cancel-order.ts",
+      "exceptions": ["Admin có thể override"]
+    },
+    {
+      "id": "BR003",
+      "domain": "menu",
+      "rule": "Món hết hàng tự động ẩn khỏi menu",
+      "implementation": "src/features/menu/hooks/use-available-items.ts",
+      "exceptions": []
+    }
+  ],
+  "features": [
+    {
+      "name": "Authentication",
+      "status": "deployed",
+      "specFile": "docs/specs/auth_spec.md",
+      "files": ["src/features/auth/**"],
+      "notes": "NextAuth v5 với Credentials provider"
+    },
+    {
+      "name": "Order Management",
+      "status": "implemented",
+      "specFile": "docs/specs/orders_spec.md",
+      "files": ["src/features/orders/**"],
+      "notes": "CRUD hoàn chỉnh, đang test"
+    },
+    {
+      "name": "Revenue Reports",
+      "status": "in_progress",
+      "specFile": "docs/specs/reports_spec.md",
+      "files": ["src/features/reports/**"],
+      "notes": "Đang làm chart daily revenue"
+    },
+    {
+      "name": "VNPay Integration",
+      "status": "planned",
+      "specFile": null,
+      "files": [],
+      "notes": "Phase 2"
+    }
+  ],
+  "knowledgeItems": {
+    "patterns": [
+      {
+        "name": "Server Actions",
+        "description": "Dùng Next.js Server Actions cho mutations",
+        "exampleFile": "src/features/orders/actions/create-order.ts"
+      },
+      {
+        "name": "Optimistic Updates",
+        "description": "Zustand + optimistic UI cho UX mượt",
+        "exampleFile": "src/features/orders/stores/order-store.ts"
+      }
+    ],
+    "gotchas": [
+      {
+        "issue": "Prisma client not found in production",
+        "cause": "Vercel cần generate prisma client trong build",
+        "solution": "Thêm 'prisma generate' vào postinstall script",
+        "affectedFiles": [
+          "package.json"
+        ]
+      },
+      {
+        "issue": "NextAuth session null trên API routes",
+        "cause": "Cần wrap với auth() helper",
+        "solution": "Import auth từ @/lib/auth thay vì getServerSession",
+        "affectedFiles": [
+          "src/features/*/api/*.ts"
+        ]
+      }
+    ],
+    "conventions": [
+      {
+        "area": "file naming",
+        "convention": "kebab-case cho files, PascalCase cho components",
+        "example": "revenue-chart.tsx exports RevenueChart"
+      },
+      {
+        "area": "API responses",
+        "convention": "Luôn wrap trong { data, error, message }",
+        "example": "return { data: orders, error: null, message: 'Success' }"
+      }
+    ]
+  },
+  "environment": {
+    "variables": [
+      { "name": "DATABASE_URL", "description": "PostgreSQL connection string", "required": true, "example": "postgresql://user:pass@localhost:5432/db" },
+      { "name": "NEXTAUTH_SECRET", "description": "Secret for JWT signing", "required": true, "example": "random-32-char-string" },
+      { "name": "NEXTAUTH_URL", "description": "App URL for auth callbacks", "required": true, "example": "http://localhost:3000" },
+      { "name": "RESEND_API_KEY", "description": "Resend email API key", "required": false, "example": "re_xxxxx" }
+    ],
+    "scripts": {
+      "dev": "next dev",
+      "build": "prisma generate && next build",
+      "test": "vitest",
+      "lint": "eslint . --fix"
+    }
+  },
+  "updatedAt": "2026-01-17T18:30:00Z"
+}

package/templates/preferences.example.json

@@ -0,0 +1,21 @@
+{
+  "updatedAt": "2026-01-17T18:30:00Z",
+  "communication": {
+    "tone": "friendly",
+    "persona": "assistant"
+  },
+  "technical": {
+    "detailLevel": "simple",
+    "autonomy": "ask_often",
+    "quality": "production"
+  },
+  "workingStyle": {
+    "pace": "careful",
+    "feedback": "gentle"
+  },
+  "customRules": [
+    "Always use TypeScript instead of JavaScript",
+    "Include unit tests when writing code",
+    "Prefer performance over clean code"
+  ]
+}

package/templates/project-identity/android.json

@@ -0,0 +1,28 @@
+{
+  "projectName": "MyAndroidApp",
+  "projectType": "android",
+  "packageName": "com.company.myandroidapp",
+  "primaryLanguage": "en",
+  "techStack": {
+    "platform": "Android",
+    "language": "Kotlin",
+    "minSdk": "24",
+    "targetSdk": "34",
+    "framework": "Jetpack Compose",
+    "architecture": "MVVM + Clean Architecture",
+    "dependencyInjection": "Hilt",
+    "networking": "Retrofit + Coroutines",
+    "storage": "Room",
+    "testing": "JUnit + Espresso",
+    "buildSystem": "Gradle (KTS)"
+  },
+  "projectStage": "planning",
+  "codingStandards": {
+    "language": "en",
+    "namingConvention": "camelCase",
+    "indentation": "spaces-4",
+    "lineLength": 120
+  },
+  "createdDate": "{{DATE}}",
+  "lastUpdated": "{{DATE}}"
+}

package/templates/project-identity/backend-nestjs.json

@@ -0,0 +1,24 @@
+{
+  "projectName": "MyBackendAPI",
+  "projectType": "backend",
+  "primaryLanguage": "en",
+  "techStack": {
+    "platform": "Backend",
+    "language": "TypeScript",
+    "framework": "NestJS",
+    "database": "PostgreSQL + Prisma",
+    "auth": "JWT + Passport",
+    "validation": "class-validator",
+    "testing": "Jest",
+    "deployment": "Docker + Cloud Run"
+  },
+  "projectStage": "planning",
+  "codingStandards": {
+    "language": "en",
+    "namingConvention": "camelCase",
+    "indentation": "spaces-2",
+    "lineLength": 100
+  },
+  "createdDate": "{{DATE}}",
+  "lastUpdated": "{{DATE}}"
+}

package/templates/project-identity/expo.json

@@ -0,0 +1,27 @@
+{
+  "projectName": "MyExpoApp",
+  "projectType": "expo",
+  "bundleIdentifier": "com.company.myexpoapp",
+  "primaryLanguage": "en",
+  "techStack": {
+    "platform": "Expo",
+    "language": "TypeScript",
+    "framework": "Expo SDK 51+",
+    "router": "Expo Router",
+    "styling": "NativeWind (Tailwind)",
+    "stateManagement": "Zustand",
+    "networking": "TanStack Query",
+    "storage": "Expo SQLite",
+    "testing": "Jest + Detox",
+    "build": "EAS Build"
+  },
+  "projectStage": "planning",
+  "codingStandards": {
+    "language": "en",
+    "namingConvention": "camelCase",
+    "indentation": "spaces-2",
+    "lineLength": 100
+  },
+  "createdDate": "{{DATE}}",
+  "lastUpdated": "{{DATE}}"
+}

package/templates/project-identity/ios.json

@@ -0,0 +1,27 @@
+{
+  "projectName": "MyiOSApp",
+  "projectType": "ios",
+  "bundleIdentifier": "com.company.myiosapp",
+  "primaryLanguage": "en",
+  "techStack": {
+    "platform": "iOS",
+    "language": "Swift",
+    "minVersion": "iOS 17.0",
+    "framework": "SwiftUI",
+    "architecture": "MVVM + Clean Architecture",
+    "dependencyInjection": "Manual DI",
+    "networking": "URLSession + async/await",
+    "storage": "SwiftData",
+    "testing": "XCTest",
+    "packageManager": "SPM"
+  },
+  "projectStage": "planning",
+  "codingStandards": {
+    "language": "en",
+    "namingConvention": "camelCase",
+    "indentation": "spaces-4",
+    "lineLength": 120
+  },
+  "createdDate": "{{DATE}}",
+  "lastUpdated": "{{DATE}}"
+}

package/templates/project-identity/web-nextjs.json

@@ -0,0 +1,24 @@
+{
+  "projectName": "MyWebApp",
+  "projectType": "react_web",
+  "primaryLanguage": "en",
+  "techStack": {
+    "platform": "Web",
+    "language": "TypeScript",
+    "framework": "Next.js 14+ (App Router)",
+    "styling": "TailwindCSS",
+    "stateManagement": "Zustand",
+    "database": "PostgreSQL + Prisma",
+    "auth": "NextAuth.js",
+    "deployment": "Vercel"
+  },
+  "projectStage": "planning",
+  "codingStandards": {
+    "language": "en",
+    "namingConvention": "camelCase",
+    "indentation": "spaces-2",
+    "lineLength": 100
+  },
+  "createdDate": "{{DATE}}",
+  "lastUpdated": "{{DATE}}"
+}

package/templates/session.example.json

@@ -0,0 +1,53 @@
+{
+  "updatedAt": "2026-01-17T18:30:00Z",
+  "workingOn": {
+    "feature": "Revenue Reports",
+    "task": "Implement daily revenue chart",
+    "status": "coding",
+    "files": [
+      "src/features/reports/components/revenue-chart.tsx",
+      "src/features/reports/api/get-revenue.ts"
+    ],
+    "blockers": [],
+    "notes": "Using recharts for visualization"
+  },
+  "pendingTasks": [
+    {
+      "task": "Add date range filter to revenue chart",
+      "priority": "medium",
+      "notes": "User request from demo"
+    },
+    {
+      "task": "Fix timezone issue in report",
+      "priority": "high",
+      "notes": "Report shows UTC, need GMT+7"
+    }
+  ],
+  "recentChanges": [
+    {
+      "timestamp": "2026-01-17T15:00:00Z",
+      "type": "feature",
+      "description": "Added revenue API endpoint",
+      "files": ["src/features/reports/api/get-revenue.ts"]
+    },
+    {
+      "timestamp": "2026-01-16T10:00:00Z",
+      "type": "bugfix",
+      "description": "Fixed order total calculation",
+      "files": ["src/features/orders/utils/calculate-total.ts"]
+    }
+  ],
+  "errorsEncountered": [
+    {
+      "error": "Prisma client not found in production",
+      "solution": "Add 'prisma generate' to postinstall script",
+      "resolved": true
+    }
+  ],
+  "decisionsMade": [
+    {
+      "decision": "Use recharts instead of Chart.js",
+      "reason": "Better React integration, smaller bundle size"
+    }
+  ]
+}