Merge branch 'main' into feat_backend_frontend_code_generate

Author: ZHallen122

.eslintrc.js

@@ -1,3 +1,4 @@
+/* eslint-disable no-undef */
 module.exports = {
   root: true,
   parser: '@typescript-eslint/parser',

.tmuxinator/dev.yml

@@ -0,0 +1,28 @@
+name: codefox
+root: <%= ENV["PWD"] %>
+
+on_project_start: tmux set-option -g prefix C-a
+
+windows:
+  - backend:
+      root: <%= ENV["PWD"] %>/backend
+      panes:
+        - backend:
+            - echo "Backend Server (Ctrl+a 1 to focus, Ctrl+a r to restart)"
+            - pnpm dev
+  - frontend:
+      root: <%= ENV["PWD"] %>/frontend
+      layout: main-vertical
+      panes:
+        - frontend:
+            - echo "Frontend Server (Ctrl+a 2 to focus, Ctrl+a r to restart)"
+            - pnpm dev
+        - codegen:
+            - echo "Codegen Watch (Ctrl+a 2 to focus, Ctrl+a r to restart)"
+            - pnpm generate:watch
+  - llm:
+      root: <%= ENV["PWD"] %>/llm-server
+      panes:
+        - llm:
+            - echo "LLM Server (Ctrl+a 3 to focus, Ctrl+a r to restart)"
+            - pnpm dev

README.md

@@ -64,3 +64,125 @@ graph TD
     classDef layerStyle fill:#f4f4f4,stroke:#666,stroke-width:1px,stroke-dasharray: 5 5
     class Project_Generate_Layer layerStyle
 ```
+
+# CodeFox Development Guide
+
+## Prerequisites
+
+Before you begin, ensure you have the following installed:
+
+- Node.js >= 18.0.0
+- PNPM 9.1.2 (`npm install -g [email protected]`)
+- Tmux >= 3.2
+- Tmuxinator >= 3.0.0 (`gem install tmuxinator`)
+
+## Project Structure
+
+The project consists of three main components:
+
+```
+codefox/
+├── backend/         # NestJS backend server
+├── frontend/        # Next.js frontend application
+└── llm-server/     # LLM service
+```
+
+## Installation
+
+1. Clone the repository:
+
+```bash
+git clone <repository-url>
+cd codefox
+```
+
+2. Install dependencies:
+
+```bash
+pnpm install
+```
+
+3. Set up environment variables:
+
+```bash
+# Copy and configure environment files for each service
+cp backend/.env.template backend/.env
+cp frontend/.env.template frontend/.env
+cp llm-server/.env.template llm-server/.env
+```
+
+## Development
+
+### Using Tmuxinator (Recommended)
+
+The project includes a Tmuxinator configuration for easy development. This will start all services in separate windows with proper layouts:
+
+```bash
+pnpm dev:tmux
+```
+
+This command will create:
+
+- Window 1: Backend server
+- Window 2: Frontend development server (left) and GraphQL codegen watcher (right)
+- Window 3: LLM server
+
+Tmux Navigation:
+
+- `Ctrl+a 1/2/3` - Switch between windows
+- `Ctrl+a r` - Restart current pane's service
+- `Ctrl+a d` - Detach from session
+
+### Manual Development
+
+If you prefer to run services individually:
+
+```bash
+# Start all services
+pnpm dev
+
+# Or start services individually
+pnpm dev:backend    # Start backend only
+cd frontend && pnpm dev  # Start frontend only
+cd llm-server && pnpm dev  # Start LLM server only
+```
+
+## Additional Commands
+
+```bash
+pnpm build          # Build all packages
+pnpm lint          # Run linting
+pnpm format        # Format code
+pnpm test          # Run tests
+```
+
+## GraphQL Code Generation
+
+The frontend uses GraphQL with automatic type generation. The codegen watcher is automatically started in the Tmuxinator setup, but you can also run it manually:
+
+```bash
+cd frontend
+pnpm generate:watch
+```
+
+## Troubleshooting
+
+If you encounter any issues:
+
+1. Ensure all environment variables are properly set
+2. Check if all required services are running
+3. Clear node_modules and reinstall dependencies:
+
+```bash
+pnpm clean
+pnpm install
+```
+
+4. For Tmuxinator issues:
+   - Ensure Tmux is running version 3.2 or higher
+   - Check if the session is already running: `tmux ls`
+   - Kill existing session if needed: `tmux kill-session -t codefox`
+
+## License
+
+ISC

backend/.env

@@ -1,3 +1,3 @@
 PORT=8080
 JWT_SECRET="JACKSONCHENNAHEULALLEN"
-SALT_ROUNDS=123
+SALT_ROUNDS=123

backend/.env.development

@@ -1,3 +1,4 @@
 PORT=8080
 JWT_SECRET="JACKSONCHENNAHEULALLEN"
-SALT_ROUNDS=123
+SALT_ROUNDS=123
+OPENAI_BASE_URI="http://localhost:3001"

backend/.eslintrc.js

@@ -5,7 +5,7 @@ module.exports = {
     tsconfigRootDir: __dirname,
     sourceType: 'module',
   },
-  plugins: ['@typescript-eslint/eslint-plugin'],
+  plugins: ['@typescript-eslint/eslint-plugin', 'unused-imports'],
   extends: [
     'plugin:@typescript-eslint/recommended',
     'plugin:prettier/recommended',
@@ -22,12 +22,23 @@ module.exports = {
     '@typescript-eslint/explicit-function-return-type': 'off',
     '@typescript-eslint/explicit-module-boundary-types': 'off',
     '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-unused-vars': 'off',
     'prefer-const': [
       'error',
       {
         destructuring: 'all',
         ignoreReadBeforeAssign: true,
       },
     ],
+    'unused-imports/no-unused-imports': 'error',
+    'unused-imports/no-unused-vars': [
+      'warn',
+      {
+        vars: 'all',
+        varsIgnorePattern: '^_',
+        args: 'after-used',
+        argsIgnorePattern: '^_',
+      },
+    ],
   },
 };

backend/.gitignore

@@ -14,6 +14,7 @@ lerna-debug.log*
 
 # OS
 .DS_Store
+*.db
 
 # Tests
 /coverage

backend/database.db

@@ -1,17 +1,32 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
   moduleFileExtensions: ['js', 'json', 'ts'],
   rootDir: 'src',
   testRegex: '.*\\.spec\\.ts$',
   transform: {
-    '^.+\\.(t|j)s$': 'ts-jest',
+    '^.+\\.(t|j)s$': [
+      'ts-jest',
+      {
+        tsconfig: {
+          allowJs: true,
+          module: 'ESNext',
+        },
+        useESM: true,
+      },
+    ],
   },
   collectCoverageFrom: ['**/*.(t|j)s'],
   coverageDirectory: '../coverage',
   testEnvironment: 'node',
   moduleNameMapper: {
     '^src/(.*)$': '<rootDir>/$1',
+    '^(\\.{1,2}/.*)\\.js$': '$1',
   },
   modulePaths: ['<rootDir>'],
   moduleDirectories: ['node_modules', 'src'],
   testPathIgnorePatterns: ['/template'],
+  transformIgnorePatterns: [
+    'node_modules/(?!(strip-json-comments|other-esm-packages)/)',
+  ],
+  preset: 'ts-jest/presets/default-esm',
 };

backend/jest.config.js

@@ -7,21 +7,22 @@
   "license": "UNLICENSED",
   "packageManager": "[email protected]",
   "scripts": {
-    "build": "nest build",
+    "build": "pnpm run build:common && nest build",
+    "build:common": "pnpm --filter codefox-common run build",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
     "lint": "ts-prune \"{src,apps,libs,test}/**/*.ts\" && eslint \"{src,apps,libs,test}/**/*.ts\" --fix ",
     "start": "nest start --watch",
-    "start:dev": "nest start --watch",
-    "dev": "pnpm start:dev",
+    "start:dev": "NODE_OPTIONS=\"--experimental-specifier-resolution=node\" nest start --watch",
+    "dev": "pnpm run build:common && pnpm start:dev",
     "dev:backend": "pnpm start:dev",
     "start:debug": "nest start --debug --watch",
-    "start:prod": "node dist/main",
+    "start:prod": "node --experimental-specifier-resolution=node dist/main",
     "test": "jest --passWithNoTests",
     "test:watch": "jest --watch",
     "test:cov": "jest --coverage",
     "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
     "test:e2e": "jest --config ./test/jest-e2e.json",
-    "test:integration": "RUN_INTEGRATION_TESTS=true jest",
+    "test:integration": "INTEGRATION_TEST=true jest",
     "check-types": "tsc --noEmit"
   },
   "dependencies": {
@@ -41,21 +42,27 @@
     "@types/fs-extra": "^11.0.4",
     "@types/normalize-path": "^3.0.2",
     "@types/toposort": "^2.0.7",
-    "toposort": "^2.0.2",
     "axios": "^1.7.7",
     "bcrypt": "^5.1.1",
     "class-validator": "^0.14.1",
+    "dotenv": "^16.4.7",
+    "eslint-plugin-unused-imports": "^4.1.4",
+    "fastembed": "^1.14.1",
     "fs-extra": "^11.2.0",
+    "gpt-3-encoder": "^1.1.4",
     "graphql": "^16.9.0",
     "graphql-subscriptions": "^2.0.0",
     "graphql-ws": "^5.16.0",
     "lodash": "^4.17.21",
     "markdown-to-txt": "^2.0.1",
     "normalize-path": "^3.0.0",
+    "openai": "^4.77.0",
+    "p-queue-es5": "^6.0.2",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.1",
     "sqlite3": "^5.1.7",
     "subscriptions-transport-ws": "^0.11.0",
+    "toposort": "^2.0.2",
     "typeorm": "^0.3.20",
     "uuid": "^10.0.0"
   },
@@ -70,6 +77,7 @@
     "@types/supertest": "^6.0.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
+    "codefox-common": "workspace:*",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-prettier": "^5.0.0",