99 lines
3.3 KiB
Markdown
99 lines
3.3 KiB
Markdown
# 列表页筛选补全 + 考勤预警 + 同步对接
|
|
|
|
> **For agentic workers:** Use subagent-driven-development. Steps use checkbox syntax.
|
|
|
|
**Goal:** Add missing filter dropdowns to 7 list pages, implement attendance anomaly detection, and wire up real DingTalk/WeCom sync API calls.
|
|
|
|
**Architecture:** Frontend: add Ant Design `<Select>` + `<DatePicker>` components to existing filter bars. Backend: add anomaly detection query to AttendanceService, implement sync stubs.
|
|
|
|
**Tech Stack:** React 19 + Ant Design 6 + NestJS 11 + TypeORM
|
|
|
|
## Global Constraints
|
|
|
|
- Follow existing filter patterns (Input.Search + Select + Space wrap)
|
|
- Each filter change resets to page 1
|
|
- Status filter options must match entity `status` field values
|
|
- Sync stubs must check env vars before attempting API calls
|
|
|
|
---
|
|
|
|
### Task 1: Students Page — Status + Tenant Filter
|
|
|
|
**Files:**
|
|
- Modify: `apps/admin/src/pages/Students/index.tsx`
|
|
|
|
- [ ] Add `filterStatus` state + `<Select>` dropdown (active/graduated/withdrawn/archived)
|
|
- [ ] Add `filterTenantId` state + `<Select>` dropdown (loaded from `/tenants`)
|
|
- [ ] Wire `fetchData()` to pass `status` + `tenantId` query params
|
|
- [ ] Verify: select status → list filters, select tenant → list filters
|
|
|
|
---
|
|
|
|
### Task 2: Rooms Page — Status Filter
|
|
|
|
**Files:**
|
|
- Modify: `apps/admin/src/pages/Rooms/index.tsx`
|
|
|
|
- [ ] Add `filterStatus` + `<Select>` (available/in_use/maintenance/archived)
|
|
- [ ] Wire to API query param
|
|
|
|
---
|
|
|
|
### Task 3: Occupancies Page — Status + Date Range
|
|
|
|
**Files:**
|
|
- Modify: `apps/admin/src/pages/Occupancies/index.tsx`
|
|
|
|
- [ ] Add `filterStatus` (checked_in/checked_out)
|
|
- [ ] Add `<RangePicker>` for check-in date range
|
|
- [ ] Wire to API params
|
|
|
|
---
|
|
|
|
### Task 4: Remaining Pages — Status Filters
|
|
|
|
**Files:**
|
|
- Modify: `apps/admin/src/pages/Classrooms/index.tsx` — status dropdown
|
|
- Modify: `apps/admin/src/pages/Expenses/index.tsx` — status filter
|
|
- Modify: `apps/admin/src/pages/Tenants/index.tsx` — status dropdown
|
|
|
|
- [ ] Each page: add `<Select>` with appropriate status options
|
|
- [ ] Wire to API params
|
|
|
|
---
|
|
|
|
### Task 5: Bills Page — Expense Type Filter
|
|
|
|
**Files:**
|
|
- Modify: `apps/admin/src/pages/Bills/index.tsx`
|
|
|
|
- [ ] Add `filterExpenseType` + `<Select>` with water/electricity/cleaning/rent/other
|
|
- [ ] Wire to API
|
|
|
|
---
|
|
|
|
### Task 6: Attendance Anomaly Detection
|
|
|
|
**Files:**
|
|
- Modify: `apps/server/src/attendance/attendance.service.ts` — add `getAnomalies()` method
|
|
- Modify: `apps/server/src/attendance/attendance.controller.ts` — add `GET /attendance-records/anomalies`
|
|
- Modify: `apps/admin/src/pages/Attendance/index.tsx` — add Alert banner
|
|
|
|
- [ ] Backend: `getAnomalies()` queries students with ≥3 consecutive absences or ≥5 lates in 7 days
|
|
- [ ] Backend: returns `{ studentId, studentName, type: 'consecutive_absence'|'frequent_late', count, dateRange }`
|
|
- [ ] Frontend: `<Alert>` banner at top of page showing anomaly count
|
|
- [ ] Frontend: click to filter records for that student
|
|
|
|
---
|
|
|
|
### Task 7: Sync Stubs → Real Implementation
|
|
|
|
**Files:**
|
|
- Modify: `apps/server/src/sync/sync.service.ts`
|
|
|
|
- [ ] Check `process.env.DINGTALK_APP_KEY` before attempting ding sync
|
|
- [ ] Check `process.env.WECOM_CORP_ID` before attempting wecom sync
|
|
- [ ] Log actionable messages: "DingTalk not configured, set DINGTALK_APP_KEY"
|
|
- [ ] If configured, attempt real API calls with proper error handling
|
|
- [ ] Record sync counts in SyncLog
|