feat: add listing file number

api/prisma/migrations/37_add_listing_file_number/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "listings" ADD COLUMN "listing_file_number" TEXT;

api/prisma/schema.prisma

@@ -566,6 +566,7 @@ model Listings {
   amenities                             String?
   buildingTotalUnits                    Int?                          @map("building_total_units")
   developer                             String?
+  listingFileNumber                     String?                       @map("listing_file_number")
   householdSizeMax                      Int?                          @map("household_size_max")
   householdSizeMin                      Int?                          @map("household_size_min")
   neighborhood                          String?

api/prisma/seed-staging.ts

@@ -157,14 +157,19 @@ export const stagingSeed = async (
   });
   const angelopolisJurisdiction = await prismaClient.jurisdictions.create({
     data: jurisdictionFactory('Angelopolis', {
-      featureFlags: [FeatureFlagEnum.enableNeighborhoodAmenities, FeatureFlagEnum.enableHousingDeveloperOwner],
+      featureFlags: [
+        FeatureFlagEnum.enableHousingDeveloperOwner,
+        FeatureFlagEnum.enableListingFileNumber,
+        FeatureFlagEnum.enableNeighborhoodAmenities,
+      ],
       visibleNeighborhoodAmenities: [
         NeighborhoodAmenitiesEnum.groceryStores,
         NeighborhoodAmenitiesEnum.pharmacies,
       ],
       requiredListingFields: [
         'listingsBuildingAddress',
         'name',
+        'listingFileNumber',
         'listingImages',
         'leasingAgentEmail',
         'leasingAgentName',

api/src/dtos/listings/listing.dto.ts

@@ -133,6 +133,14 @@ class Listing extends AbstractDTO {
   @ApiPropertyOptional()
   developer?: string;
 
+  @Expose()
+  @ValidateListingPublish('listingFileNumber', {
+    groups: [ValidationsGroupsEnum.default],
+  })
+  @IsString({ groups: [ValidationsGroupsEnum.default] })
+  @ApiPropertyOptional()
+  listingFileNumber?: string;
+
   @Expose()
   @IsNumber({}, { groups: [ValidationsGroupsEnum.default] })
   @ApiPropertyOptional()

api/src/enums/feature-flags/feature-flags-enum.ts

@@ -18,6 +18,7 @@ export enum FeatureFlagEnum {
   enableIsVerified = 'enableIsVerified',
   enableLimitedHowDidYouHear = 'enableLimitedHowDidYouHear',
   enableListingFavoriting = 'enableListingFavoriting',
+  enableListingFileNumber = 'enableListingFileNumber',
   enableListingFiltering = 'enableListingFiltering',
   enableListingOpportunity = 'enableListingOpportunity',
   enableListingPagination = 'enableListingPagination',
@@ -125,6 +126,11 @@ export const featureFlagMap: { name: string; description: string }[] = [
     description:
       'When true, a Favorite button is shown for public listings and users can view their favorited listings',
   },
+  {
+    name: FeatureFlagEnum.enableListingFileNumber,
+    description:
+      'When true, partners can enter and export a listing file number',
+  },
   {
     name: FeatureFlagEnum.enableListingFiltering,
     description:

api/src/services/listing-csv-export.service.ts

@@ -459,6 +459,17 @@ export class ListingCsvExporterService implements CsvExporterServiceInterface {
           ? 'Housing developer / owner'
           : 'Developer',
       },
+      ...(doAnyJurisdictionHaveFeatureFlagSet(
+        user.jurisdictions,
+        FeatureFlagEnum.enableListingFileNumber,
+      )
+        ? [
+            {
+              path: 'listingFileNumber',
+              label: 'Listing File Number',
+            },
+          ]
+        : []),
       {
         path: 'listingsBuildingAddress.street',
         label: 'Building Street Address',

shared-helpers/src/types/backend-swagger.ts

@@ -3962,6 +3962,9 @@ export interface Listing {
   /**  */
   developer?: string
 
+  /**  */
+  listingFileNumber?: string
+
   /**  */
   householdSizeMax?: number
 
@@ -4649,6 +4652,9 @@ export interface ListingCreate {
   /**  */
   developer?: string
 
+  /**  */
+  listingFileNumber?: string
+
   /**  */
   householdSizeMax?: number
 
@@ -4989,6 +4995,9 @@ export interface ListingUpdate {
   /**  */
   developer?: string
 
+  /**  */
+  listingFileNumber?: string
+
   /**  */
   householdSizeMax?: number
 
@@ -7576,6 +7585,7 @@ export enum FeatureFlagEnum {
   "enableIsVerified" = "enableIsVerified",
   "enableLimitedHowDidYouHear" = "enableLimitedHowDidYouHear",
   "enableListingFavoriting" = "enableListingFavoriting",
+  "enableListingFileNumber" = "enableListingFileNumber",
   "enableListingFiltering" = "enableListingFiltering",
   "enableListingOpportunity" = "enableListingOpportunity",
   "enableListingPagination" = "enableListingPagination",

sites/partners/page_content/locale_overrides/general.json

@@ -259,6 +259,7 @@
   "listings.listingAvailabilityQuestion": "What is the listing availability?",
   "listings.listingIsAlreadyLive": "This listing is already live. Updates will affect the applicant experience on the housing portal.",
   "listings.listingName": "Listing name",
+  "listings.listingFileNumber": "Listing file number",
   "listings.listingPhoto": "Listing photo",
   "listings.listingStatus.active": "Open",
   "listings.listingStatus.changesRequested": "Changes requested",

sites/partners/src/components/listings/PaperListingDetails/sections/DetailListingIntro.tsx

@@ -15,9 +15,22 @@ const DetailListingIntro = () => {
     FeatureFlagEnum.enableHousingDeveloperOwner,
     listing.jurisdictions.id
   )
+  const enableListingFileNumber = doJurisdictionsHaveFeatureFlagOn(
+    FeatureFlagEnum.enableListingFileNumber,
+    listing.jurisdictions.id
+  )
 
   return (
     <SectionWithGrid heading={t("listings.sections.introTitle")} inset>
+      {enableListingFileNumber && (
+        <Grid.Row>
+          <Grid.Cell>
+            <FieldValue id="listingFileNumber" label={t("listings.listingFileNumber")}>
+              {getDetailFieldString(listing.listingFileNumber)}
+            </FieldValue>
+          </Grid.Cell>
+        </Grid.Row>
+      )}
       <Grid.Row>
         <Grid.Cell>
           <FieldValue id="name" label={t("listings.listingName")}>

sites/partners/src/components/listings/PaperListingForm/sections/ListingIntro.tsx

@@ -33,6 +33,10 @@ const ListingIntro = (props: ListingIntroProps) => {
     FeatureFlagEnum.enableHousingDeveloperOwner,
     jurisdiction
   )
+  const enableListingFileNumber = doJurisdictionsHaveFeatureFlagOn(
+    FeatureFlagEnum.enableListingFileNumber,
+    jurisdiction
+  )
 
   const jurisdictionOptions: SelectOption[] = [
     { label: "", value: "" },
@@ -50,6 +54,22 @@ const ListingIntro = (props: ListingIntroProps) => {
         heading={t("listings.sections.introTitle")}
         subheading={t("listings.sections.introSubtitle")}
       >
+        {enableListingFileNumber && (
+          <Grid.Row columns={1}>
+            <Grid.Cell>
+              <Field
+                register={register}
+                {...defaultFieldProps(
+                  "listingFileNumber",
+                  t("listings.listingFileNumber"),
+                  props.requiredFields,
+                  errors,
+                  clearErrors
+                )}
+              />
+            </Grid.Cell>
+          </Grid.Row>
+        )}
         <Grid.Row columns={1}>
           <Grid.Cell>
             <Field

sites/partners/src/lib/listings/formTypes.ts

@@ -122,6 +122,7 @@ export const formDefaults: FormListing = {
   listingEvents: [],
   listingImages: [],
   listingFeatures: null,
+  listingFileNumber: "",
   listingNeighborhoodAmenities: null,
   listingUtilities: null,
   listingsLeasingAgentAddress: null,