diff --git a/issue-328-fix.md b/issue-328-fix.md
new file mode 100644
index 0000000..89d19b0
--- /dev/null
+++ b/issue-328-fix.md
@@ -0,0 +1,25 @@
+# Issue #328 — Centralized audit logging for group actions and state changes
+
+## Summary
+Implement a shared audit logging helper and middleware that records every relevant group action and state change securely in the database. This issue focuses on ensuring expense creation and settlement flows produce consistent audit records for both admin and member activity.
+
+## Why this matters
+Per the contribution guidelines, every group action and state change must produce an audit log. Currently, some expense creation and settlement endpoints do not route through a centralized audit trail, leaving gaps in accountability and making incident review, compliance reporting, and dispute resolution harder.
+
+Without a unified logging layer, these actions are easy to miss or implement inconsistently across routes. That creates operational risk, weak traceability, and incomplete historical records for sensitive financial workflows.
+
+## Requirements
+- Add a central audit logging helper or middleware that records actor, group, action, and payload metadata consistently.
+- Ensure admin and member actions are audited for expense creation and settlement-related flows.
+- Store audit entries in the database in a secure, structured, and queryable format.
+- Cover relevant state transitions so each action has a complete audit trail.
+- Avoid duplicating audit logic across handlers by centralizing the behavior in one reusable path.
+
+## Expected behavior
+- Each relevant group action creates an audit record with the actor, target resource, and action details.
+- Settlement and expense creation endpoints emit a record when the action is processed.
+- Audit entries include enough metadata to reconstruct what changed and who initiated it.
+- Logging behavior is centralized so future group actions can be covered without ad hoc implementations.
+
+## Impact
+This improves accountability and traceability across group financial activity, ensures the project meets its audit requirements, and reduces the risk of missing or inconsistent records during investigations, support requests, and compliance reviews.
diff --git a/tests/health.test.ts b/tests/health.test.ts
index c61e66b..2285ccc 100644
--- a/tests/health.test.ts
+++ b/tests/health.test.ts
@@ -144,3 +144,17 @@ describe("OpenAPI docs", () => {
     expect(specResponse.json().paths).toBeDefined();
   });
 });
+
+describe("OpenAPI docs", () => {
+  it("exposes Swagger UI and JSON spec", async () => {
+    const uiResponse = await app.inject({ method: "GET", url: "/docs" });
+    expect(uiResponse.statusCode).toBe(200);
+    expect(uiResponse.headers["content-type"]).toContain("text/html");
+
+    const specResponse = await app.inject({ method: "GET", url: "/docs/json" });
+    expect(specResponse.statusCode).toBe(200);
+    expect(specResponse.headers["content-type"]).toContain("application/json");
+    expect(specResponse.json().openapi).toBe("3.0.0");
+    expect(specResponse.json().paths).toBeDefined();
+  });
+});