feat: streamline portfolio UI and support atomic record edits

apps/api/scripts/check-comments.cjs

@@ -0,0 +1,20 @@
+require('dotenv/config');
+const { PrismaClient } = require('@prisma/client');
+const { writeFileSync } = require('node:fs');
+const { resolve } = require('node:path');
+const db = new PrismaClient();
+(async () => {
+  const tables = await db.$queryRaw`SELECT TABLE_NAME, TABLE_COMMENT FROM information_schema.TABLES
+    WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME <> '_prisma_migrations' ORDER BY TABLE_NAME`;
+  const columns = await db.$queryRaw`SELECT TABLE_NAME, COLUMN_NAME, COLUMN_COMMENT FROM information_schema.COLUMNS
+    WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME <> '_prisma_migrations' ORDER BY TABLE_NAME, ORDINAL_POSITION`;
+  if (tables.some((t) => !t.TABLE_COMMENT) || columns.some((c) => !c.COLUMN_COMMENT))
+    throw Error('Application tables or columns are missing comments.');
+  writeFileSync(resolve(__dirname, '../../../docs/database-comments.json'), JSON.stringify({
+    tableCount: tables.length, columnCount: columns.length, tables, columns,
+  }, null, 2) + '\n');
+  console.log(`Database comments verified: ${tables.length} tables, ${columns.length} columns.`);
+})().catch(() => {
+  console.error('Comment verification failed. Check database access and table/column comments.');
+  process.exitCode = 1;
+}).finally(() => db.$disconnect());