sunfmin

Percev — Product Specification

Version: 1.0 Draft Date: 2026-03-25 Author: Felix Sun Status: Draft

---

Problem Statement

sunfmin

{
  "playbooks": [
    {
      "platform": "macos",
      "gist_id": "84a5c108d5742c850704a5088a3f4cbf",
      "description": "Xcode, SwiftUI, XCUITest, codesign, ScreenCaptureKit"
    }
  ]
}

sunfmin

macOS Playbook — Xcode, SwiftUI, XCUITest, ScreenCaptureKit

All rules in this file are non-negotiable. Violating them causes the Orchestrator to reject your work and re-launch you.

---

Table of Contents

1. XcodeGen Pitfalls
2. Code Signing

sunfmin

Apple Platform Clean Architecture Constitution

Core Principles

I. Dependency Rule (Inward Dependencies)

Source code dependencies MUST only point inward. Inner layers MUST NOT know anything about outer layers.

• Entities MUST NOT import Domain, Data, or Presentation code

sunfmin

description: AI Self-Correction Loop - A universal pattern where AI owns the full feedback loop: writing automated checks first, implementing to satisfy them, and iterating until all validations pass.

Goal

Transition from "AI as autocomplete" to "AI as owner" by enforcing a closed feedback loop across any domain. The AI must verify its own work through automated checks before presenting results.

Core Principles

sunfmin

All Available Tools with Arguments

File Operations

read_file

Parameter	Type	Required	Description
file_path	string	Yes	Absolute path to the file to read
offset	integer	No	1-indexed line number to start reading from (for files >1000 lines)
limit	integer	No	Number of lines to read (use with offset)

sunfmin

IAM Architecture for Admin Consoles

This document describes the Identity and Access Management (IAM) architecture for our suite of admin consoles (CMS, OMS, PIM, etc.). The architecture centralizes authentication and authorization through an API Gateway, allowing individual services to focus on business logic.

Table of Contents

1. Overview
2. Architecture
3. Components
4. Authentication Flows

sunfmin

Feature Specification: Qortex IAM Console

Feature Branch: 001-iam-console
Created: 2025-12-18
Status: Draft
Input: Qortex IAM System Architecture Design

Overview

Qortex IAM is an independently deployable authentication and access management service providing unified capabilities for the Qortex product family (PIM, OIM, CIAM, Loyalty Console, Marketing Console):

sunfmin

import type {
  FullConfig,
  FullResult,
  Reporter,
  Suite,
  TestCase,
  TestResult,
} from '@playwright/test/reporter';
import * as path from 'path';

sunfmin

export default defineConfig({
  maxFailures: 3,
  reporter: './tests/e2e/utils/ai-reporter.ts',  // Custom AI-friendly reporter
  timeout: 5000,              // 5s max per test - fail fast
  expect: { timeout: 1000 },  // 1s for assertions
  use: {
    actionTimeout: 1000,      // 1s for actions
    baseURL: process.env.E2E_TARGET_URL || 'http://localhost:5173',
  },
  webServer: undefined,       // NEVER let Playwright start the server