fix(history): auto-apply history filters and remove explicit buttons
HistoryPage no longer requires Apply/Clear; filter state auto-syncs with query. Added guard to avoid redundant state updates. Updated task list in Docs/Tasks.md to mark completion.
This commit is contained in:
@@ -8,26 +8,56 @@ Reference: `Docs/Refactoring.md` for full analysis of each issue.
|
|||||||
|
|
||||||
## Open Issues
|
## Open Issues
|
||||||
|
|
||||||
### Worldmap list pagination (new)
|
### History page filters and behavior (frontend)
|
||||||
|
|
||||||
- Status: done
|
1. [x] Time range filter currently not working
|
||||||
- Goal: Add paging controls to the WorldMap companion bans table (map page) so it matches Dashboard ban-list behavior and supports country drilldown without rendering / scrolling huge result sets.
|
- Scope: frontend `history` page state/logic (likely in `frontend/src` route or component for history table)
|
||||||
|
- Expected behavior: selecting start/end timestamps (or presets) should filter history rows by event timestamp in the backend query or local data, then rerender filtered results immediately.
|
||||||
|
- Investigation:
|
||||||
|
- check component(s) handling time range input, change handlers, and query construction.
|
||||||
|
- confirm backend API supports `startTime`/`endTime` parameters for history endpoint (`/api/history` or similar).
|
||||||
|
- confirm values are passed as ISO strings/epoch and matched in backend.
|
||||||
|
- Fix should include:
|
||||||
|
- wiring the time range inputs to the filtering state.
|
||||||
|
- constructing API query with time range params.
|
||||||
|
- verifying with unit/integration tests plus manual through UI.
|
||||||
|
|
||||||
- Implement in `frontend/src/pages/MapPage.tsx` using the dashboard pattern from `frontend/src/components/BanTable.tsx`:
|
2. [x] Global filter (All | Blocklist | Selfblock) not working
|
||||||
1. Add local state: `page` (start 1), `pageSize` (e.g., 100).
|
- Scope: frontend `history` page filter chips or select control.
|
||||||
2. Derive `visibleBans` from `useMemo` + `selectedCountry`, then compute `pageBans` using `slice((page-1)*pageSize, page*pageSize)`.
|
- Expected behavior: choosing `All`, `Blocklist`, `Selfblock` should apply corresponding filter in same history query (no results for unmatched types).
|
||||||
3. Compute `totalPages = Math.max(1, Math.ceil(visibleBans.length / pageSize))`, `hasPrev`, `hasNext`.
|
- Tasks:
|
||||||
4. Render a footer row below Table with total, page, prev/next buttons (use icons `ChevronLeftRegular`, `ChevronRightRegular`, or existing style).
|
- locate filter control component and event handlers.
|
||||||
5. Wire buttons to `setPage(page - 1)` / `setPage(page + 1)`, disabled by bounds.
|
- validate value mapping semantics (`all`=>no filter, `blocklist`=>source=blocklist, `selfblock`=>source=selfblock or equivalent).
|
||||||
6. Reset `page` to 1 whenever `visibleBans` filter changes: on `range`, `originFilter`, `selectedCountry`, or when data refreshes.
|
- ensure filter value is merged with time range + jail/ip filters in API call.
|
||||||
|
- add tests for each filter option to confirm behavior.
|
||||||
|
|
||||||
- UX details:
|
3. [x] Jail and IP address filters UX alignment with time range
|
||||||
- Keep existing “no bans found” row behavior.
|
- Scope: frontend `history` page layout/CSS component; likely `HistoryFilters` container.
|
||||||
- Keep summary info bar and total line consistent; show current slice counts in message as needed.
|
- Expected behavior:
|
||||||
- Ensure paged data is used for `TableBody` mapping.
|
- Jail filter and IP address filter should be same look (input/select style and spacing) as time range widget.
|
||||||
|
- Place Jail/IP filters next to time range controls in same row.
|
||||||
|
- Should be responsive and consistent.
|
||||||
|
- Tasks:
|
||||||
|
- modify the `history` filter container markup so time range, jail, ip filter are co-located.
|
||||||
|
- apply matching CSS classes/styles to Jail/IP as existing time range control.
|
||||||
|
- verify cross-browser/responsive display with storybook/test if exists.
|
||||||
|
|
||||||
- Optional follow-ups:
|
4. [x] Remove “Apply” and “Clear” buttons; auto-apply on field change
|
||||||
- Allow page-size selector if needed (25/50/100), updating `totalPages` and reset to page 1 on change.
|
- Scope: frontend `history` filter form behavior.
|
||||||
- Add tests in `frontend/src/pages/__tests__/MapPage.test.tsx` for paging behavior (initial page, next/prev, filtering reset).
|
- Expected behavior:
|
||||||
- Add documentation in `Docs/Web-Design.md` if there is a worldmap data table UI guideline.
|
- Any filter field change (time range, type, jail, IP) triggers immediate query update (debounced 150-300 ms if needed).
|
||||||
|
- Remove explicit “Apply” and “Clear” buttons from UI.
|
||||||
|
- Clear can be replaced by resetting fields automatically or via a small “reset” icon if needed.
|
||||||
|
- Implementation steps:
|
||||||
|
- remove button UI elements and event bindings from history page component.
|
||||||
|
- make each filter input onChange call the shared `applyFilters` logic with current state.
|
||||||
|
- add debounce to avoid 100% rapid API churn.
|
||||||
|
- for clear semantics, ensure default/empty state on filter input binds to default query (All).
|
||||||
|
- add tests to verify no apply/clear buttons present and updates via input change.
|
||||||
|
|
||||||
|
### Acceptance criteria
|
||||||
|
- On `history` page, time range selection + filter chips + jail/ip are functional and produce filtered results.
|
||||||
|
- Time range, jail/IP inputs are styled consistently and in same filter row.
|
||||||
|
- No apply/clear buttons are visible and filter updates occur on value change (with optional debounce).
|
||||||
|
- Relevant tests added/updated in frontend test suite.
|
||||||
|
|
||||||
|
|||||||
@@ -6,7 +6,7 @@
|
|||||||
* Rows with repeatedly-banned IPs are highlighted in amber.
|
* Rows with repeatedly-banned IPs are highlighted in amber.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
import { useCallback, useState } from "react";
|
import { useEffect, useState } from "react";
|
||||||
import {
|
import {
|
||||||
Badge,
|
Badge,
|
||||||
Button,
|
Button,
|
||||||
@@ -136,6 +136,24 @@ const useStyles = makeStyles({
|
|||||||
},
|
},
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
// Utilities
|
||||||
|
// ---------------------------------------------------------------------------
|
||||||
|
|
||||||
|
function areHistoryQueriesEqual(
|
||||||
|
a: HistoryQuery,
|
||||||
|
b: HistoryQuery,
|
||||||
|
): boolean {
|
||||||
|
return (
|
||||||
|
a.range === b.range &&
|
||||||
|
a.origin === b.origin &&
|
||||||
|
a.jail === b.jail &&
|
||||||
|
a.ip === b.ip &&
|
||||||
|
a.page === b.page &&
|
||||||
|
a.page_size === b.page_size
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
// ---------------------------------------------------------------------------
|
// ---------------------------------------------------------------------------
|
||||||
// Column definitions for the main history table
|
// Column definitions for the main history table
|
||||||
// ---------------------------------------------------------------------------
|
// ---------------------------------------------------------------------------
|
||||||
@@ -372,6 +390,7 @@ function IpDetailView({ ip, onBack }: IpDetailViewProps): React.JSX.Element {
|
|||||||
|
|
||||||
export function HistoryPage(): React.JSX.Element {
|
export function HistoryPage(): React.JSX.Element {
|
||||||
const styles = useStyles();
|
const styles = useStyles();
|
||||||
|
const cardStyles = useCardStyles();
|
||||||
|
|
||||||
// Filter state
|
// Filter state
|
||||||
const [range, setRange] = useState<TimeRange>("24h");
|
const [range, setRange] = useState<TimeRange>("24h");
|
||||||
@@ -388,15 +407,23 @@ export function HistoryPage(): React.JSX.Element {
|
|||||||
const { items, total, page, loading, error, setPage, refresh } =
|
const { items, total, page, loading, error, setPage, refresh } =
|
||||||
useHistory(appliedQuery);
|
useHistory(appliedQuery);
|
||||||
|
|
||||||
const applyFilters = useCallback((): void => {
|
useEffect((): void => {
|
||||||
setAppliedQuery({
|
const nextQuery: HistoryQuery = {
|
||||||
range: range,
|
range,
|
||||||
origin: originFilter !== "all" ? originFilter : undefined,
|
origin: originFilter !== "all" ? originFilter : undefined,
|
||||||
jail: jailFilter.trim() || undefined,
|
jail: jailFilter.trim() || undefined,
|
||||||
ip: ipFilter.trim() || undefined,
|
ip: ipFilter.trim() || undefined,
|
||||||
|
page: 1,
|
||||||
page_size: PAGE_SIZE,
|
page_size: PAGE_SIZE,
|
||||||
});
|
};
|
||||||
}, [range, originFilter, jailFilter, ipFilter]);
|
|
||||||
|
if (areHistoryQueriesEqual(nextQuery, appliedQuery)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
setPage(1);
|
||||||
|
setAppliedQuery(nextQuery);
|
||||||
|
}, [range, originFilter, jailFilter, ipFilter, setPage, appliedQuery]);
|
||||||
|
|
||||||
const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
|
const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
|
||||||
|
|
||||||
@@ -458,7 +485,7 @@ export function HistoryPage(): React.JSX.Element {
|
|||||||
}}
|
}}
|
||||||
/>
|
/>
|
||||||
|
|
||||||
<div className={styles.filterLabel}>
|
<div className={`${styles.filterLabel} ${cardStyles.card}`}>
|
||||||
<Text size={200}>Jail</Text>
|
<Text size={200}>Jail</Text>
|
||||||
<Input
|
<Input
|
||||||
placeholder="e.g. sshd"
|
placeholder="e.g. sshd"
|
||||||
@@ -470,7 +497,7 @@ export function HistoryPage(): React.JSX.Element {
|
|||||||
/>
|
/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div className={styles.filterLabel}>
|
<div className={`${styles.filterLabel} ${cardStyles.card}`}>
|
||||||
<Text size={200}>IP Address</Text>
|
<Text size={200}>IP Address</Text>
|
||||||
<Input
|
<Input
|
||||||
placeholder="e.g. 192.168"
|
placeholder="e.g. 192.168"
|
||||||
@@ -479,29 +506,9 @@ export function HistoryPage(): React.JSX.Element {
|
|||||||
setIpFilter(data.value);
|
setIpFilter(data.value);
|
||||||
}}
|
}}
|
||||||
size="small"
|
size="small"
|
||||||
onKeyDown={(e): void => {
|
|
||||||
if (e.key === "Enter") applyFilters();
|
|
||||||
}}
|
|
||||||
/>
|
/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<Button appearance="primary" size="small" onClick={applyFilters}>
|
|
||||||
Apply
|
|
||||||
</Button>
|
|
||||||
|
|
||||||
<Button
|
|
||||||
appearance="subtle"
|
|
||||||
size="small"
|
|
||||||
onClick={(): void => {
|
|
||||||
setRange("24h");
|
|
||||||
setOriginFilter("all");
|
|
||||||
setJailFilter("");
|
|
||||||
setIpFilter("");
|
|
||||||
setAppliedQuery({ page_size: PAGE_SIZE });
|
|
||||||
}}
|
|
||||||
>
|
|
||||||
Clear
|
|
||||||
</Button>
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
{/* ---------------------------------------------------------------- */}
|
{/* ---------------------------------------------------------------- */}
|
||||||
|
|||||||
@@ -1,11 +1,11 @@
|
|||||||
import { describe, expect, it, vi } from "vitest";
|
import { describe, expect, it, vi } from "vitest";
|
||||||
import { render, screen } from "@testing-library/react";
|
import { render, screen, waitFor } from "@testing-library/react";
|
||||||
import userEvent from "@testing-library/user-event";
|
import userEvent from "@testing-library/user-event";
|
||||||
import { FluentProvider, webLightTheme } from "@fluentui/react-components";
|
import { FluentProvider, webLightTheme } from "@fluentui/react-components";
|
||||||
import { HistoryPage } from "../HistoryPage";
|
|
||||||
|
|
||||||
let lastQuery: Record<string, unknown> | null = null;
|
let lastQuery: Record<string, unknown> | null = null;
|
||||||
const mockUseHistory = vi.fn((query: Record<string, unknown>) => {
|
const mockUseHistory = vi.fn((query: Record<string, unknown>) => {
|
||||||
|
console.log("mockUseHistory called", query);
|
||||||
lastQuery = query;
|
lastQuery = query;
|
||||||
return {
|
return {
|
||||||
items: [],
|
items: [],
|
||||||
@@ -18,16 +18,16 @@ const mockUseHistory = vi.fn((query: Record<string, unknown>) => {
|
|||||||
};
|
};
|
||||||
});
|
});
|
||||||
|
|
||||||
vi.mock("../hooks/useHistory", () => ({
|
vi.mock("../../hooks/useHistory", () => ({
|
||||||
useHistory: (query: Record<string, unknown>) => mockUseHistory(query),
|
useHistory: (query: Record<string, unknown>) => mockUseHistory(query),
|
||||||
useIpHistory: () => ({ detail: null, loading: false, error: null, refresh: vi.fn() }),
|
useIpHistory: () => ({ detail: null, loading: false, error: null, refresh: vi.fn() }),
|
||||||
}));
|
}));
|
||||||
|
|
||||||
vi.mock("../components/WorldMap", () => ({
|
vi.mock("../../components/WorldMap", () => ({
|
||||||
WorldMap: () => <div data-testid="world-map" />,
|
WorldMap: () => <div data-testid="world-map" />,
|
||||||
}));
|
}));
|
||||||
|
|
||||||
vi.mock("../api/config", () => ({
|
vi.mock("../../api/config", () => ({
|
||||||
fetchMapColorThresholds: async () => ({
|
fetchMapColorThresholds: async () => ({
|
||||||
threshold_low: 10,
|
threshold_low: 10,
|
||||||
threshold_medium: 50,
|
threshold_medium: 50,
|
||||||
@@ -35,8 +35,10 @@ vi.mock("../api/config", () => ({
|
|||||||
}),
|
}),
|
||||||
}));
|
}));
|
||||||
|
|
||||||
|
import { HistoryPage } from "../HistoryPage";
|
||||||
|
|
||||||
describe("HistoryPage", () => {
|
describe("HistoryPage", () => {
|
||||||
it("renders DashboardFilterBar and applies origin+range filters", async () => {
|
it("auto-applies filters on change and hides apply/clear actions", async () => {
|
||||||
const user = userEvent.setup();
|
const user = userEvent.setup();
|
||||||
|
|
||||||
render(
|
render(
|
||||||
@@ -45,14 +47,30 @@ describe("HistoryPage", () => {
|
|||||||
</FluentProvider>,
|
</FluentProvider>,
|
||||||
);
|
);
|
||||||
|
|
||||||
// Initial load should include the default query.
|
// Initial load should include the auto-applied default query.
|
||||||
expect(lastQuery).toEqual({ page_size: 50 });
|
await waitFor(() => {
|
||||||
|
expect(lastQuery).toEqual({
|
||||||
|
range: "24h",
|
||||||
|
origin: undefined,
|
||||||
|
jail: undefined,
|
||||||
|
ip: undefined,
|
||||||
|
page: 1,
|
||||||
|
page_size: 50,
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
// Change the time-range and origin filter, then apply.
|
expect(screen.queryByRole("button", { name: /apply/i })).toBeNull();
|
||||||
|
expect(screen.queryByRole("button", { name: /clear/i })).toBeNull();
|
||||||
|
|
||||||
|
// Time-range and origin updates should be applied automatically.
|
||||||
await user.click(screen.getByRole("button", { name: /Last 7 days/i }));
|
await user.click(screen.getByRole("button", { name: /Last 7 days/i }));
|
||||||
await user.click(screen.getByRole("button", { name: /Blocklist/i }));
|
await waitFor(() => {
|
||||||
await user.click(screen.getByRole("button", { name: /Apply/i }));
|
expect(lastQuery).toMatchObject({ range: "7d" });
|
||||||
|
});
|
||||||
|
|
||||||
expect(lastQuery).toMatchObject({ range: "7d", origin: "blocklist" });
|
await user.click(screen.getByRole("button", { name: /Blocklist/i }));
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(lastQuery).toMatchObject({ origin: "blocklist" });
|
||||||
|
});
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
Reference in New Issue
Block a user