95 lines
4.8 KiB
Markdown
95 lines
4.8 KiB
Markdown
# Sprint 6 Phase 3 Announcement Review
|
|
|
|
## 1. Summary
|
|
|
|
เพิ่ม Announcement Module ครบทั้งฝั่ง HRD และ Employee โดยเชื่อมกับ Auth.js, Drizzle, Notification Service และ Audit Log Service ตาม architecture เดิมของระบบ
|
|
|
|
## 2. Files Changed
|
|
|
|
- `src/app/api/announcements/route.ts`
|
|
- `src/app/api/announcements/[id]/route.ts`
|
|
- `src/app/dashboard/announcements/page.tsx`
|
|
- `src/app/dashboard/announcements/[id]/page.tsx`
|
|
- `src/features/announcements/api/types.ts`
|
|
- `src/features/announcements/api/service.ts`
|
|
- `src/features/announcements/api/queries.ts`
|
|
- `src/features/announcements/api/mutations.ts`
|
|
- `src/features/announcements/schemas/announcement.ts`
|
|
- `src/features/announcements/server/announcement-data.ts`
|
|
- `src/features/announcements/components/announcements-listing.tsx`
|
|
- `src/features/announcements/components/announcements-page.tsx`
|
|
- `src/features/announcements/components/announcement-view-page.tsx`
|
|
- `src/features/announcements/components/announcement-form.tsx`
|
|
- `src/features/audit-logs/server/audit-service.ts`
|
|
- `src/features/audit-logs/constants/audit-log-options.ts`
|
|
- `src/features/notifications/server/notification-data.ts`
|
|
- `src/lib/announcement-storage.ts`
|
|
- `src/lib/searchparams.ts`
|
|
- `src/proxy.ts`
|
|
|
|
## 3. Database Changes
|
|
|
|
ไม่มีการเปลี่ยน schema และไม่มี migration เพิ่ม ใช้งานตาราง `announcements` ที่มีอยู่แล้ว
|
|
|
|
## 4. Routes Added
|
|
|
|
- `GET /api/announcements`
|
|
- `POST /api/announcements`
|
|
- `GET /api/announcements/[id]`
|
|
- `PATCH /api/announcements/[id]`
|
|
- `/dashboard/announcements`
|
|
- `/dashboard/announcements/[id]`
|
|
|
|
## 5. Notification Integration
|
|
|
|
- เมื่อประกาศถูกเผยแพร่ ระบบจะเรียก `createAnnouncementNotification()`
|
|
- Notification เก็บ `referenceType = announcement` และ `referenceId = announcement.id`
|
|
- ปรับปลายทาง notification ให้เปิดไปยังหน้ารายละเอียดประกาศโดยตรง
|
|
|
|
## 6. Audit Events Added
|
|
|
|
- `ANNOUNCEMENT_CREATE`
|
|
- `ANNOUNCEMENT_UPDATE`
|
|
- `ANNOUNCEMENT_PUBLISH`
|
|
- `ANNOUNCEMENT_ARCHIVE`
|
|
|
|
## 7. Permission Rules
|
|
|
|
- HRD: สร้าง แก้ไข เผยแพร่ ปักหมุด และเก็บถาวรได้
|
|
- Employee: ดูได้เฉพาะประกาศที่ `published` และอยู่ในช่วงวันที่อนุญาตให้แสดง
|
|
- การบังคับสิทธิ์ทำที่ server route
|
|
|
|
## 8. Responsive Notes
|
|
|
|
- หน้า list ใช้ card layout รองรับ mobile และ tablet
|
|
- filter bar ยุบเป็นแนวตั้งบนจอเล็ก
|
|
- action buttons และ pagination รองรับการใช้งานบนหน้าจอแคบ
|
|
|
|
## 9. Thai Localization Notes
|
|
|
|
- ข้อความหลักในหน้า list, detail, form, loading, empty, error และ toast เป็นภาษาไทย
|
|
|
|
## 10. Manual Test Checklist
|
|
|
|
- HRD เปิด `/dashboard/announcements` แล้วเห็นรายการทั้งหมด
|
|
- HRD สร้างประกาศแบบ draft ได้
|
|
- HRD สร้างประกาศแบบ published ได้และเกิด notification
|
|
- HRD แก้ไขประกาศและแทนที่ไฟล์แนบได้
|
|
- HRD ปักหมุดและยกเลิกปักหมุดได้
|
|
- HRD เก็บถาวรประกาศได้
|
|
- Employee เห็นเฉพาะประกาศที่เผยแพร่แล้ว
|
|
- Employee เปิด notification แล้วเข้าหน้ารายละเอียดประกาศได้
|
|
- ค้นหา กรอง และเปลี่ยนหน้าใน announcement list ได้
|
|
|
|
## 11. Known Limitations
|
|
|
|
- ยังไม่มี rich text editor สำหรับ content
|
|
- attachment upload ใช้ local file storage ตามแนวทางเดียวกับ certificate
|
|
- ยังไม่มี route ยกเลิกเผยแพร่ถาวร เพราะ requirement ไม่ได้ระบุ
|
|
|
|
## 12. Next Phase Recommendation
|
|
|
|
- เพิ่ม announcement analytics เช่นยอดอ่านหรือ acknowledgement
|
|
- เพิ่ม scheduling UX สำหรับประกาศที่จะเผยแพร่ล่วงหน้า
|
|
- พิจารณาเพิ่ม editor ที่รองรับรูปแบบข้อความ หากมี requirement ด้าน communication มากขึ้น
|