feat: add socrates (freeCodeCamp#65430)

Co-authored-by: Mrugesh Mohapatra <noreply@mrugesh.dev>

Author: ahmaxed

api/prisma/schema.prisma

@@ -173,6 +173,7 @@ model user {
   savedChallenges                SavedChallenge[] // Undefined | SavedChallenge[]
   // Nullable tri-state: null (likely new user), true (subscribed), false (unsubscribed)
   sendQuincyEmail                Boolean?
+  socrates                       Boolean?
   theme                          String? // Undefined
   timezone                       String? // Undefined
   twitter                        String? // Null | Undefined
@@ -228,6 +229,17 @@ model Donation {
   @@index([userId], map: "userId_1")
 }
 
+model SocratesUsage {
+  id     String   @id @default(auto()) @map("_id") @db.ObjectId
+  userId String   @db.ObjectId
+  /// UTC date representing the day of usage (midnight).
+  date   DateTime @db.Date
+  /// Number of hints used on this day.
+  count  Int      @default(0)
+
+  @@unique([userId, date])
+}
+
 model UserToken {
   id      String   @id @map("_id")
   created DateTime @db.Date

api/src/app.ts

@@ -191,6 +191,7 @@ export const build = async (
 
       await fastify.register(protectedRoutes.challengeRoutes);
       await fastify.register(protectedRoutes.donateRoutes);
+      await fastify.register(protectedRoutes.socratesRoutes);
       await fastify.register(protectedRoutes.protectedCertificateRoutes);
       await fastify.register(protectedRoutes.settingRoutes);
       await fastify.register(protectedRoutes.userRoutes);

api/src/plugins/__fixtures__/user.ts

@@ -93,6 +93,7 @@ export const newUser = (email: string) => ({
   rand: null, // TODO(Post-MVP): delete from schema (it's not used or required).
   savedChallenges: [],
   sendQuincyEmail: null,
+  socrates: null,
   theme: 'default',
   timezone: null,
   twitter: null,

api/src/routes/protected/index.ts

@@ -3,3 +3,4 @@ export * from './challenge.js';
 export * from './donate.js';
 export * from './settings.js';
 export * from './user.js';
+export * from './socrates.js';

api/src/routes/protected/settings.ts

@@ -616,6 +616,34 @@ ${isLinkSentWithinLimitTTL}`
     }
   );
 
+  fastify.put(
+    '/update-socrates',
+    {
+      schema: schemas.updateSocrates
+    },
+    async (req, reply) => {
+      const logger = fastify.log.child({ req, res: reply });
+      try {
+        await fastify.prisma.user.update({
+          where: { id: req.user?.id },
+          data: {
+            socrates: req.body.socrates
+          }
+        });
+
+        return {
+          message: 'flash.socrates-updated',
+          type: 'success'
+        } as const;
+      } catch (err) {
+        logger.error(err);
+        fastify.Sentry.captureException(err);
+        void reply.code(500);
+        return { message: 'flash.wrong-updating', type: 'danger' } as const;
+      }
+    }
+  );
+
   fastify.put(
     '/update-my-honesty',
     {