@talkpilot/core-db 1.3.71 → 1.3.72

package/src/municipal/muniIssues/muniIssues.schema.ts

@@ -1,5 +1,6 @@
 import type { Document, IndexDescription } from "mongodb";
 import {
+  MUNI_ISSUE_STATUSES,
   MUNI_ISSUE_SYNC_STATUSES,
   MUNI_ISSUE_TEXT_MAX_LENGTH,
   MUNI_ISSUE_NAME_MAX_LENGTH,
@@ -55,12 +56,25 @@ export const muniIssuesJsonSchema: Document = {
       },
     },
     createdAt: { bsonType: "date" },
+    status: { enum: [...MUNI_ISSUE_STATUSES] },
+    response: {
+      bsonType: "object",
+      required: ["text", "createdAt"],
+      properties: {
+        text: { bsonType: "string", maxLength: MUNI_ISSUE_TEXT_MAX_LENGTH },
+        imageUrl: { bsonType: "string" },
+        createdAt: { bsonType: "date" },
+      },
+    },
+    updatedAt: { bsonType: "date" },
   },
 };
 
 export const muniIssuesIndexes: IndexDescription[] = [
   { key: { callSid: 1 }, name: "callSid_1" },
   { key: { createdAt: -1 }, name: "createdAt_-1" },
+  // Complaint list: one municipality's issues, newest first.
+  { key: { clientId: 1, createdAt: -1 }, name: "clientId_1_createdAt_-1" },
   // Unique: one stored document per Jira ticket, guarding against duplicate writes.
   { key: { "jira.key": 1 }, name: "jira_key_unique", unique: true },
 ];

package/src/municipal/muniIssues/muniIssues.setters.ts

@@ -1,5 +1,10 @@
-import { ObjectId } from "mongodb";
-import { CreateMuniIssueInput, MuniIssue } from "./muniIssues.types";
+import { Filter, ObjectId } from "mongodb";
+import {
+  CreateMuniIssueInput,
+  MuniIssue,
+  MuniIssueStatus,
+  SetMuniIssueResponseInput,
+} from "./muniIssues.types";
 import { getMuniIssuesCollection } from "./muniIssues.getters";
 import { ensureMuniIssuesCollectionOnce } from "./muniIssues.setup";
 
@@ -10,6 +15,7 @@ export const createMuniIssue = async (
 ): Promise<ObjectId> => {
   await ensureMuniIssuesCollectionOnce();
 
+  const now = new Date();
   const issue: MuniIssue = {
     _id: id,
     ...issueData,
@@ -17,8 +23,58 @@ export const createMuniIssue = async (
       ...issueData.jira,
       syncStatus: issueData.jira.syncStatus ?? "created",
     },
-    createdAt: new Date(),
+    status: "in_review",
+    createdAt: now,
+    updatedAt: now,
   };
   const { insertedId } = await getMuniIssuesCollection().insertOne(issue);
   return insertedId;
 };
+
+// An issue of this client that is tracked (has a status) and not yet answered.
+// The `response` condition is the lock: once answered, no further writes match.
+const openIssueFilter = (id: string, clientId: string): Filter<MuniIssue> => ({
+  _id: new ObjectId(id),
+  clientId,
+  status: { $exists: true },
+  response: { $exists: false },
+});
+
+/** Changes the status of an unanswered issue. Returns false if none matched. */
+export const updateMuniIssueStatus = async (
+  id: string,
+  clientId: string,
+  status: MuniIssueStatus,
+): Promise<boolean> => {
+  if (!ObjectId.isValid(id)) return false;
+  await ensureMuniIssuesCollectionOnce();
+
+  const { matchedCount } = await getMuniIssuesCollection().updateOne(
+    openIssueFilter(id, clientId),
+    { $set: { status, updatedAt: new Date() } },
+  );
+  return matchedCount > 0;
+};
+
+/** Saves the single TalkPilot response, which locks the issue. Returns false if none matched. */
+export const setMuniIssueResponse = async (
+  id: string,
+  clientId: string,
+  { status, text, imageUrl }: SetMuniIssueResponseInput,
+): Promise<boolean> => {
+  if (!ObjectId.isValid(id)) return false;
+  await ensureMuniIssuesCollectionOnce();
+
+  const now = new Date();
+  const { matchedCount } = await getMuniIssuesCollection().updateOne(
+    openIssueFilter(id, clientId),
+    {
+      $set: {
+        status,
+        response: { text, ...(imageUrl && { imageUrl }), createdAt: now },
+        updatedAt: now,
+      },
+    },
+  );
+  return matchedCount > 0;
+};

package/src/municipal/muniIssues/muniIssues.types.ts

@@ -1,10 +1,22 @@
 import { ObjectId } from "mongodb";
 
 import { CityName } from "../utils/types";
-import { MUNI_ISSUE_SYNC_STATUSES } from "./muniIssues.constants";
+import {
+  MUNI_ISSUE_STATUSES,
+  MUNI_ISSUE_SYNC_STATUSES,
+} from "./muniIssues.constants";
 
 export type MuniIssueSyncStatus = (typeof MUNI_ISSUE_SYNC_STATUSES)[number];
 
+export type MuniIssueStatus = (typeof MUNI_ISSUE_STATUSES)[number];
+
+/** The single TalkPilot response; once set, the complaint is locked. */
+export type MuniIssueResponse = {
+  text: string;
+  imageUrl?: string;
+  createdAt: Date;
+};
+
 export type MuniIssueContent = {
   issuerName: string;
   issuerRole: string;
@@ -25,13 +37,31 @@ export type MuniIssue = {
   issueContent: MuniIssueContent;
   jira: MuniIssueJira;
   createdAt: Date;
+  // Complaint tracking (CP-1888). Optional: issues created before it have none
+  // of these, which is how they are kept out of tracking.
+  status?: MuniIssueStatus;
+  response?: MuniIssueResponse;
+  updatedAt?: Date;
 };
 
-// _id/createdAt are set on insert; jira.syncStatus defaults to "created"
-// because the issue is only stored after its Jira ticket exists (CP-1115).
+// _id/createdAt/status/updatedAt are set on insert; jira.syncStatus defaults to
+// "created" because the issue is only stored after its Jira ticket exists (CP-1115).
 export type CreateMuniIssueInput = Omit<
   MuniIssue,
-  "_id" | "createdAt" | "jira"
+  "_id" | "createdAt" | "jira" | "status" | "response" | "updatedAt"
 > & {
   jira: { key: string; syncStatus?: MuniIssueSyncStatus };
 };
+
+export type SetMuniIssueResponseInput = {
+  status: MuniIssueStatus;
+  text: string;
+  imageUrl?: string;
+};
+
+/** `answered` filters by whether a TalkPilot response exists; omit it for all issues. */
+export type FindMuniIssuesOptions = {
+  answered?: boolean;
+  skip?: number;
+  limit?: number;
+};