phos 1.0.3 → 1.2.0

package/src/templates/backend/fastapi/src/sql/user_sql.py

@@ -0,0 +1,197 @@
+import bcrypt
+from datetime import datetime
+from src.db import get_db
+from src.types.user_type import User, CreateUserDto, UpdateUserDto
+
+SALT_ROUNDS = 10
+
+
+async def get_users():
+    query = """
+        SELECT id, email, username, full_name, password, avatar_url, bio, role, is_active, created_at, updated_at
+        FROM users
+        WHERE is_active = true
+        ORDER BY created_at DESC
+    """
+    conn = await get_db()
+    result = await conn.fetch(query)
+    return result
+
+
+async def get_user_by_id(user_id: int):
+    query = """
+        SELECT id, email, username, full_name, password, avatar_url, bio, role, is_active, created_at, updated_at
+        FROM users
+        WHERE id = $1
+    """
+    conn = await get_db()
+    result = await conn.fetchrow(query, user_id)
+    return result
+
+
+async def get_user_by_email(email: str):
+    query = """
+        SELECT id, email, username, full_name, password, avatar_url, bio, role, is_active, created_at, updated_at
+        FROM users
+        WHERE email = $1
+    """
+    conn = await get_db()
+    result = await conn.fetchrow(query, email)
+    return result
+
+
+async def get_user_by_username(username: str):
+    query = """
+        SELECT id, email, username, full_name, password, avatar_url, bio, role, is_active, created_at, updated_at
+        FROM users
+        WHERE username = $1
+    """
+    conn = await get_db()
+    result = await conn.fetchrow(query, username)
+    return result
+
+
+async def create_user(data: CreateUserDto):
+    hashed_password = bcrypt.hashpw(data.password.encode("utf-8"), bcrypt.gensalt(SALT_ROUNDS)).decode("utf-8")
+
+    query = """
+        INSERT INTO users (email, username, full_name, password, avatar_url, bio, role, is_active, created_at, updated_at)
+        VALUES ($1, $2, $3, $4, $5, $6, $7, true, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
+        RETURNING id, email, username, full_name, password, avatar_url, bio, role, is_active, created_at, updated_at
+    """
+    conn = await get_db()
+    result = await conn.fetchrow(
+        query,
+        data.email,
+        data.username,
+        data.full_name,
+        hashed_password,
+        data.avatar_url,
+        data.bio,
+        data.role or "user",
+    )
+    return result
+
+
+async def update_user(user_id: int, data: UpdateUserDto):
+    set_parts = []
+    values = []
+    param_index = 1
+
+    if data.email is not None:
+        set_parts.append(f"email = ${param_index}")
+        values.append(data.email)
+        param_index += 1
+
+    if data.username is not None:
+        set_parts.append(f"username = ${param_index}")
+        values.append(data.username)
+        param_index += 1
+
+    if data.full_name is not None:
+        set_parts.append(f"full_name = ${param_index}")
+        values.append(data.full_name)
+        param_index += 1
+
+    if data.password is not None:
+        hashed_password = bcrypt.hashpw(data.password.encode("utf-8"), bcrypt.gensalt(SALT_ROUNDS)).decode("utf-8")
+        set_parts.append(f"password = ${param_index}")
+        values.append(hashed_password)
+        param_index += 1
+
+    if data.avatar_url is not None:
+        set_parts.append(f"avatar_url = ${param_index}")
+        values.append(data.avatar_url)
+        param_index += 1
+
+    if data.bio is not None:
+        set_parts.append(f"bio = ${param_index}")
+        values.append(data.bio)
+        param_index += 1
+
+    if data.role is not None:
+        set_parts.append(f"role = ${param_index}")
+        values.append(data.role)
+        param_index += 1
+
+    if data.is_active is not None:
+        set_parts.append(f"is_active = ${param_index}")
+        values.append(data.is_active)
+        param_index += 1
+
+    if not set_parts:
+        return await get_user_by_id(user_id)
+
+    set_parts.append("updated_at = CURRENT_TIMESTAMP")
+    query = f"""
+        UPDATE users
+        SET {', '.join(set_parts)}
+        WHERE id = ${param_index}
+        RETURNING id, email, username, full_name, password, avatar_url, bio, role, is_active, created_at, updated_at
+    """
+    values.append(user_id)
+
+    conn = await get_db()
+    result = await conn.fetchrow(query, *values)
+    return result
+
+
+async def delete_user(user_id: int) -> bool:
+    query = """
+        DELETE FROM users
+        WHERE id = $1
+    """
+    conn = await get_db()
+    result = await conn.execute(query, user_id)
+    return result == "DELETE 1"
+
+
+async def soft_delete_user(user_id: int):
+    query = """
+        UPDATE users
+        SET is_active = false, updated_at = CURRENT_TIMESTAMP
+        WHERE id = $1
+        RETURNING id, email, username, full_name, password, avatar_url, bio, role, is_active, created_at, updated_at
+    """
+    conn = await get_db()
+    result = await conn.fetchrow(query, user_id)
+    return result
+
+
+async def search_users(keyword: str):
+    query = """
+        SELECT id, email, username, full_name, password, avatar_url, bio, role, is_active, created_at, updated_at
+        FROM users
+        WHERE is_active = true
+          AND (email ILIKE $1 OR username ILIKE $1 OR full_name ILIKE $1)
+        ORDER BY created_at DESC
+    """
+    conn = await get_db()
+    result = await conn.fetch(query, f"%{keyword}%")
+    return result
+
+
+def verify_password(plain_password: str, hashed_password: str) -> bool:
+    return bcrypt.checkpw(plain_password.encode("utf-8"), hashed_password.encode("utf-8"))
+
+
+user_table_schema = """
+CREATE TABLE IF NOT EXISTS users (
+  id SERIAL PRIMARY KEY,
+  email VARCHAR(255) UNIQUE NOT NULL,
+  username VARCHAR(100) UNIQUE NOT NULL,
+  full_name VARCHAR(255) NOT NULL,
+  password VARCHAR(255) NOT NULL,
+  avatar_url TEXT,
+  bio TEXT,
+  role VARCHAR(50) DEFAULT 'user',
+  is_active BOOLEAN DEFAULT true,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_users_email ON users(email);
+CREATE INDEX IF NOT EXISTS idx_users_username ON users(username);
+CREATE INDEX IF NOT EXISTS idx_users_role ON users(role);
+CREATE INDEX IF NOT EXISTS idx_users_is_active ON users(is_active);
+"""

package/src/templates/backend/fastapi/src/types/user_type.py

@@ -0,0 +1,64 @@
+from datetime import datetime
+from typing import Optional
+from pydantic import BaseModel, EmailStr, Field
+
+
+class User(BaseModel):
+    id: int
+    email: str
+    username: str
+    full_name: str
+    password: str
+    avatar_url: Optional[str] = None
+    bio: Optional[str] = None
+    role: str = "user"
+    is_active: bool = True
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
+class CreateUserDto(BaseModel):
+    email: EmailStr
+    username: str = Field(..., min_length=3, max_length=100)
+    full_name: str = Field(..., min_length=1, max_length=255)
+    password: str = Field(..., min_length=6, max_length=255)
+    avatar_url: Optional[str] = Field(None, max_length=1000)
+    bio: Optional[str] = Field(None, max_length=1000)
+    role: Optional[str] = Field(None, max_length=50)
+
+
+class UpdateUserDto(BaseModel):
+    email: Optional[EmailStr] = None
+    username: Optional[str] = Field(None, min_length=3, max_length=100)
+    full_name: Optional[str] = Field(None, min_length=1, max_length=255)
+    password: Optional[str] = Field(None, min_length=6, max_length=255)
+    avatar_url: Optional[str] = Field(None, max_length=1000)
+    bio: Optional[str] = Field(None, max_length=1000)
+    role: Optional[str] = Field(None, max_length=50)
+    is_active: Optional[bool] = None
+
+
+class UserResponse(BaseModel):
+    id: int
+    email: str
+    username: str
+    full_name: str
+    avatar_url: Optional[str] = None
+    bio: Optional[str] = None
+    role: str
+    is_active: bool
+    created_at: datetime
+    updated_at: datetime
+
+    class Config:
+        from_attributes = True
+
+
+class ApiResponse(BaseModel):
+    success: bool
+    data: Optional[any] = None
+    message: Optional[str] = None
+    error: Optional[str] = None

package/src/templates/frontend/vue/.editorconfig

@@ -0,0 +1,8 @@
+[*.{js,jsx,mjs,cjs,ts,tsx,mts,cts,vue,css,scss,sass,less,styl}]
+charset = utf-8
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+end_of_line = lf
+max_line_length = 100

package/src/templates/frontend/vue/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

package/src/templates/frontend/vue/.oxlintrc.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["eslint", "typescript", "unicorn", "oxc", "vue"],
+  "env": {
+    "browser": true
+  },
+  "categories": {
+    "correctness": "error"
+  }
+}

package/src/templates/frontend/vue/.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "semi": false,
+  "singleQuote": true,
+  "printWidth": 100
+}

package/src/templates/frontend/vue/.vscode/extensions.json

@@ -0,0 +1,11 @@
+{
+  "recommendations": [
+    "Vue.volar",
+    "vitest.explorer",
+    "ms-playwright.playwright",
+    "dbaeumer.vscode-eslint",
+    "EditorConfig.EditorConfig",
+    "oxc.oxc-vscode",
+    "esbenp.prettier-vscode"
+  ]
+}

package/src/templates/frontend/vue/README.md

@@ -0,0 +1,73 @@
+# vue
+
+This template should help get you started developing with Vue 3 in Vite.
+
+## Recommended IDE Setup
+
+[VS Code](https://code.visualstudio.com/) + [Vue (Official)](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur).
+
+## Recommended Browser Setup
+
+- Chromium-based browsers (Chrome, Edge, Brave, etc.):
+  - [Vue.js devtools](https://chromewebstore.google.com/detail/vuejs-devtools/nhdogjmejiglipccpnnnanhbledajbpd)
+  - [Turn on Custom Object Formatter in Chrome DevTools](http://bit.ly/object-formatters)
+- Firefox:
+  - [Vue.js devtools](https://addons.mozilla.org/en-US/firefox/addon/vue-js-devtools/)
+  - [Turn on Custom Object Formatter in Firefox DevTools](https://fxdx.dev/firefox-devtools-custom-object-formatters/)
+
+## Type Support for `.vue` Imports in TS
+
+TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) to make the TypeScript language service aware of `.vue` types.
+
+## Customize configuration
+
+See [Vite Configuration Reference](https://vite.dev/config/).
+
+## Project Setup
+
+```sh
+npm install
+```
+
+### Compile and Hot-Reload for Development
+
+```sh
+npm run dev
+```
+
+### Type-Check, Compile and Minify for Production
+
+```sh
+npm run build
+```
+
+### Run Unit Tests with [Vitest](https://vitest.dev/)
+
+```sh
+npm run test:unit
+```
+
+### Run End-to-End Tests with [Playwright](https://playwright.dev)
+
+```sh
+# Install browsers for the first run
+npx playwright install
+
+# When testing on CI, must build the project first
+npm run build
+
+# Runs the end-to-end tests
+npm run test:e2e
+# Runs the tests only on Chromium
+npm run test:e2e -- --project=chromium
+# Runs the tests of a specific file
+npm run test:e2e -- tests/example.spec.ts
+# Runs the tests in debug mode
+npm run test:e2e -- --debug
+```
+
+### Lint with [ESLint](https://eslint.org/)
+
+```sh
+npm run lint
+```

package/src/templates/frontend/vue/e2e/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "@tsconfig/node24/tsconfig.json",
+  "include": ["./**/*"]
+}

package/src/templates/frontend/vue/e2e/vue.spec.ts

@@ -0,0 +1,8 @@
+import { test, expect } from '@playwright/test'
+
+// See here how to get started:
+// https://playwright.dev/docs/intro
+test('visits the app root url', async ({ page }) => {
+  await page.goto('/')
+  await expect(page.locator('h1')).toHaveText('You did it!')
+})

package/src/templates/frontend/vue/env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/src/templates/frontend/vue/eslint.config.ts

@@ -0,0 +1,38 @@
+import { globalIgnores } from 'eslint/config'
+import { defineConfigWithVueTs, vueTsConfigs } from '@vue/eslint-config-typescript'
+import pluginVue from 'eslint-plugin-vue'
+import pluginPlaywright from 'eslint-plugin-playwright'
+import pluginVitest from '@vitest/eslint-plugin'
+import pluginOxlint from 'eslint-plugin-oxlint'
+import skipFormatting from 'eslint-config-prettier/flat'
+
+// To allow more languages other than `ts` in `.vue` files, uncomment the following lines:
+// import { configureVueProject } from '@vue/eslint-config-typescript'
+// configureVueProject({ scriptLangs: ['ts', 'tsx'] })
+// More info at https://github.com/vuejs/eslint-config-typescript/#advanced-setup
+
+export default defineConfigWithVueTs(
+  {
+    name: 'app/files-to-lint',
+    files: ['**/*.{vue,ts,mts,tsx}'],
+  },
+
+  globalIgnores(['**/dist/**', '**/dist-ssr/**', '**/coverage/**']),
+
+  ...pluginVue.configs['flat/essential'],
+  vueTsConfigs.recommended,
+
+  {
+    ...pluginPlaywright.configs['flat/recommended'],
+    files: ['e2e/**/*.{test,spec}.{js,ts,jsx,tsx}'],
+  },
+
+  {
+    ...pluginVitest.configs.recommended,
+    files: ['src/**/__tests__/*'],
+  },
+
+  ...pluginOxlint.buildFromOxlintConfigFile('.oxlintrc.json'),
+
+  skipFormatting,
+)

package/src/templates/frontend/vue/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="">
+  <head>
+    <meta charset="UTF-8">
+    <link rel="icon" href="/favicon.ico">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Vite App</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/src/templates/frontend/vue/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "vue",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "run-p type-check \"build-only {@}\" --",
+    "preview": "vite preview",
+    "test:unit": "vitest",
+    "test:e2e": "playwright test",
+    "build-only": "vite build",
+    "type-check": "vue-tsc --build",
+    "lint": "run-s lint:*",
+    "lint:oxlint": "oxlint . --fix",
+    "lint:eslint": "eslint . --fix --cache",
+    "format": "prettier --write --experimental-cli src/"
+  },
+  "dependencies": {
+    "pinia": "^3.0.4",
+    "vue": "^3.5.27",
+    "vue-router": "^5.0.1"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.1",
+    "@tsconfig/node24": "^24.0.4",
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^24.10.9",
+    "@vitejs/plugin-vue": "^6.0.3",
+    "@vitejs/plugin-vue-jsx": "^5.1.3",
+    "@vitest/eslint-plugin": "^1.6.6",
+    "@vue/eslint-config-typescript": "^14.6.0",
+    "@vue/test-utils": "^2.4.6",
+    "@vue/tsconfig": "^0.8.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-oxlint": "~1.42.0",
+    "eslint-plugin-playwright": "^2.5.1",
+    "eslint-plugin-vue": "~10.7.0",
+    "jiti": "^2.6.1",
+    "jsdom": "^27.4.0",
+    "npm-run-all2": "^8.0.4",
+    "oxlint": "~1.42.0",
+    "prettier": "3.8.1",
+    "typescript": "~5.9.3",
+    "vite": "^7.3.1",
+    "vite-plugin-vue-devtools": "^8.0.5",
+    "vitest": "^4.0.18",
+    "vue-tsc": "^3.2.4"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  }
+}

package/src/templates/frontend/vue/playwright.config.ts

@@ -0,0 +1,110 @@
+import process from 'node:process'
+import { defineConfig, devices } from '@playwright/test'
+
+/**
+ * Read environment variables from file.
+ * https://github.com/motdotla/dotenv
+ */
+// require('dotenv').config();
+
+/**
+ * See https://playwright.dev/docs/test-configuration.
+ */
+export default defineConfig({
+  testDir: './e2e',
+  /* Maximum time one test can run for. */
+  timeout: 30 * 1000,
+  expect: {
+    /**
+     * Maximum time expect() should wait for the condition to be met.
+     * For example in `await expect(locator).toHaveText();`
+     */
+    timeout: 5000,
+  },
+  /* Fail the build on CI if you accidentally left test.only in the source code. */
+  forbidOnly: !!process.env.CI,
+  /* Retry on CI only */
+  retries: process.env.CI ? 2 : 0,
+  /* Opt out of parallel tests on CI. */
+  workers: process.env.CI ? 1 : undefined,
+  /* Reporter to use. See https://playwright.dev/docs/test-reporters */
+  reporter: 'html',
+  /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+  use: {
+    /* Maximum time each action such as `click()` can take. Defaults to 0 (no limit). */
+    actionTimeout: 0,
+    /* Base URL to use in actions like `await page.goto('/')`. */
+    baseURL: process.env.CI ? 'http://localhost:4173' : 'http://localhost:5173',
+
+    /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+    trace: 'on-first-retry',
+
+    /* Only on CI systems run the tests headless */
+    headless: !!process.env.CI,
+  },
+
+  /* Configure projects for major browsers */
+  projects: [
+    {
+      name: 'chromium',
+      use: {
+        ...devices['Desktop Chrome'],
+      },
+    },
+    {
+      name: 'firefox',
+      use: {
+        ...devices['Desktop Firefox'],
+      },
+    },
+    {
+      name: 'webkit',
+      use: {
+        ...devices['Desktop Safari'],
+      },
+    },
+
+    /* Test against mobile viewports. */
+    // {
+    //   name: 'Mobile Chrome',
+    //   use: {
+    //     ...devices['Pixel 5'],
+    //   },
+    // },
+    // {
+    //   name: 'Mobile Safari',
+    //   use: {
+    //     ...devices['iPhone 12'],
+    //   },
+    // },
+
+    /* Test against branded browsers. */
+    // {
+    //   name: 'Microsoft Edge',
+    //   use: {
+    //     channel: 'msedge',
+    //   },
+    // },
+    // {
+    //   name: 'Google Chrome',
+    //   use: {
+    //     channel: 'chrome',
+    //   },
+    // },
+  ],
+
+  /* Folder for test artifacts such as screenshots, videos, traces, etc. */
+  // outputDir: 'test-results/',
+
+  /* Run your local dev server before starting the tests */
+  webServer: {
+    /**
+     * Use the dev server by default for faster feedback loop.
+     * Use the preview server on CI for more realistic testing.
+     * Playwright will re-use the local server if there is already a dev-server running.
+     */
+    command: process.env.CI ? 'npm run preview' : 'npm run dev',
+    port: process.env.CI ? 4173 : 5173,
+    reuseExistingServer: !process.env.CI,
+  },
+})

package/src/templates/frontend/vue/src/App.vue

@@ -0,0 +1,11 @@
+<script setup lang="ts"></script>
+
+<template>
+  <h1>You did it!</h1>
+  <p>
+    Visit <a href="https://vuejs.org/" target="_blank" rel="noopener">vuejs.org</a> to read the
+    documentation
+  </p>
+</template>
+
+<style scoped></style>

package/src/templates/frontend/vue/src/__tests__/App.spec.ts

@@ -0,0 +1,11 @@
+import { describe, it, expect } from 'vitest'
+
+import { mount } from '@vue/test-utils'
+import App from '../App.vue'
+
+describe('App', () => {
+  it('mounts renders properly', () => {
+    const wrapper = mount(App)
+    expect(wrapper.text()).toContain('You did it!')
+  })
+})

package/src/templates/frontend/vue/src/main.ts

@@ -0,0 +1,12 @@
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+
+import App from './App.vue'
+import router from './router'
+
+const app = createApp(App)
+
+app.use(createPinia())
+app.use(router)
+
+app.mount('#app')

package/src/templates/frontend/vue/src/router/index.ts

@@ -0,0 +1,8 @@
+import { createRouter, createWebHistory } from 'vue-router'
+
+const router = createRouter({
+  history: createWebHistory(import.meta.env.BASE_URL),
+  routes: [],
+})
+
+export default router

package/src/templates/frontend/vue/src/stores/counter.ts

@@ -0,0 +1,12 @@
+import { ref, computed } from 'vue'
+import { defineStore } from 'pinia'
+
+export const useCounterStore = defineStore('counter', () => {
+  const count = ref(0)
+  const doubleCount = computed(() => count.value * 2)
+  function increment() {
+    count.value++
+  }
+
+  return { count, doubleCount, increment }
+})