wonderslife/pdd-skills-v3/system-architect

system-architect/
├── SKILL.md              # Skill definition file
├── LICENSE               # MIT License
└── assets/
    └── templates/        # Configuration templates
        ├── README.md
        ├── ARCHITECTURE.md
        └── .editorconfig

project-name/
├── src/
│   ├── __init__.py
│   ├── main.py              # Application entry point
│   ├── config/              # Configuration management
│   │   ├── __init__.py
│   │   ├── settings.py
│   │   └── logging.py
│   ├── api/                 # API endpoints
│   │   ├── __init__.py
│   │   ├── routes/
│   │   └── dependencies.py
│   ├── services/            # Business logic
│   │   ├── __init__.py
│   │   └── user_service.py
│   ├── models/              # Data models
│   │   ├── __init__.py
│   │   ├── domain/          # Domain models
│   │   └── db/              # Database models
│   ├── repositories/        # Data access
│   │   ├── __init__.py
│   │   └── user_repository.py
│   └── utils/               # Utility functions
│       ├── __init__.py
│       └── helpers.py
├── tests/
│   ├── __init__.py
│   ├── unit/
│   ├── integration/
│   └── conftest.py
├── docs/
│   ├── README.md
│   └── ARCHITECTURE.md
├── scripts/
│   └── setup.sh
├── .env.example
├── .gitignore
├── requirements.txt
├── requirements-dev.txt
├── pyproject.toml
├── Dockerfile
├── docker-compose.yml
└── README.md

project-name/
├── src/
│   ├── index.ts             # Application entry point
│   ├── config/              # Configuration
│   │   ├── index.ts
│   │   └── database.ts
│   ├── routes/              # API routes
│   │   ├── index.ts
│   │   └── userRoutes.ts
│   ├── controllers/         # Request handlers
│   │   └── userController.ts
│   ├── services/            # Business logic
│   │   └── userService.ts
│   ├── models/              # Data models
│   │   └── User.ts
│   ├── repositories/        # Data access
│   │   └── userRepository.ts
│   ├── middleware/          # Express middleware
│   │   ├── auth.ts
│   │   └── errorHandler.ts
│   ├── types/               # TypeScript types
│   │   └── index.ts
│   └── utils/               # Utility functions
│       └── helpers.ts
├── tests/
│   ├── unit/
│   ├── integration/
│   └── setup.ts
├── docs/
│   ├── README.md
│   └── ARCHITECTURE.md
├── scripts/
│   └── setup.sh
├── .env.example
├── .gitignore
├── package.json
├── tsconfig.json
├── eslint.config.js
├── Dockerfile
├── docker-compose.yml
└── README.md

# EditorConfig - https://editorconfig.org
 
root = true
 
[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
 
[*.{py,js,ts,json,yml,yaml}]
indent_style = space
indent_size = 2
 
[*.md]
trim_trailing_whitespace = false
 
[Makefile]
indent_style = tab

[tool.poetry]
name = "project-name"
version = "0.1.0"
description = "Project description"
authors = ["Your Name <your.email@example.com>"]
 
[tool.poetry.dependencies]
python = "^3.10"
fastapi = "^0.104.0"
uvicorn = "^0.24.0"
sqlalchemy = "^2.0.0"
pydantic = "^2.0.0"
python-dotenv = "^1.0.0"
 
[tool.poetry.dev-dependencies]
pytest = "^7.4.0"
pytest-cov = "^4.1.0"
black = "^23.10.0"
flake8 = "^6.1.0"
mypy = "^1.6.0"
 
[tool.black]
line-length = 100
target-version = ['py310']
 
[tool.mypy]
python_version = "3.10"
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true
 
[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "lib": ["ES2022"],
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "resolveJsonModule": true,
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "strictFunctionTypes": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noImplicitReturns": true,
    "noFallthroughCasesInSwitch": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist", "tests"]
}

import js from '@eslint/js';
import ts from 'typescript-eslint';
import prettier from 'eslint-config-prettier';
export default [
  js.configs.recommended,
  ...ts.configs.recommended,
  prettier,
  {
    rules: {
      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
      '@typescript-eslint/explicit-function-return-type': 'off',
      '@typescript-eslint/no-explicit-any': 'warn',
      'no-console': ['warn', { allow: ['warn', 'error'] }],
    },
  },
];

# Project Name
 
Brief description of what this project does.
 
## Features
 
-Feature 1
-Feature 2
-Feature 3
 
## Quick Start
 
### Prerequisites
 
-Python 3.10+ / Node.js 18+
-Docker and Docker Compose
-PostgreSQL 14+ (if not using Docker)
 
### Installation
 
\`\`\`bash
# Clone the repository
git clone https://github.com/your-org/project-name.git
cd project-name
 
# Install dependencies
pip install -r requirements.txt  # Python
# or
npm install  # Node.js
 
# Set up environment variables
cp .env.example .env
# Edit .env with your configuration
 
# Run the application
python src/main.py  # Python
# or
npm run dev  # Node.js
\`\`\`
 
### Docker Setup
 
\`\`\`bash
# Build and run with Docker Compose
docker-compose up -d
 
# View logs
docker-compose logs -f
 
# Stop services
docker-compose down
\`\`\`
 
## Project Structure
 
\`\`\`
project-name/
├── src/                # Source code
│   ├── api/           # API endpoints
│   ├── services/      # Business logic
│   ├── models/        # Data models
│   └── repositories/  # Data access
├── tests/             # Test files
├── docs/              # Documentation
└── scripts/           # Utility scripts
\`\`\`
 
## API Documentation
 
API documentation is available at `/docs` when running the application.
 
## Testing
 
\`\`\`bash
# Run all tests
pytest  # Python
# or
npm test  # Node.js
 
# Run with coverage
pytest --cov=src  # Python
# or
npm run test:coverage  # Node.js
\`\`\`
 
## Contributing
 
1.Fork the repository
2.Create a feature branch (`git checkout -b feature/amazing-feature`)
3.Commit your changes (`git commit -m 'Add amazing feature'`)
4.Push to the branch (`git push origin feature/amazing-feature`)
5.Open a Pull Request
 
## License
 
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

# Architecture Overview
 
## System Components
 
### Component Diagram
 
\`\`\`mermaid
graph TB
    Client[Client Application]
    API[API Layer]
    Service[Service Layer]
    Repository[Repository Layer]
    DB[(Database)]
    Cache[(Redis Cache)]
 
    Client --> API
    API --> Service
    Service --> Repository
    Repository --> DB
    Service --> Cache
\`\`\`
 
## Data Flow
 
1.**Request Flow**: Client → API → Service → Repository → Database
2.**Response Flow**: Database → Repository → Service → API → Client
3.**Caching**: Service checks Cache before Repository
 
## Technology Stack
 
| Component | Technology | Justification |
|-----------|------------|---------------|
| Backend | FastAPI/Express | Fast, async, type-safe |
| Database | PostgreSQL | ACID compliance, JSONB support |
| Cache | Redis | Fast in-memory caching |
| Container | Docker | Consistent deployment |
 
## Key Decisions
 
### Decision 1: Use PostgreSQL for Primary Database
 
**Context**: Need reliable data storage for financial transactions.
 
**Decision**: PostgreSQL with SQLAlchemy ORM.
 
**Consequences**:
-✅ ACID compliance
-✅ Strong ecosystem
-❌ Vertical scaling limits
 
**Alternatives Considered**: MySQL (fewer features), MongoDB (no ACID)
 
### Decision 2: Layered Architecture
 
**Context**: Need maintainable codebase with clear separation of concerns.
 
**Decision**: Three-layer architecture (API → Service → Repository).
 
**Consequences**:
-✅ Clear separation of concerns
-✅ Easy to test
-❌ More files to maintain
 
## Security
 
-**Authentication**: JWT tokens with refresh mechanism
-**Authorization**: Role-based access control (RBAC)
-**Data Protection**: Encryption at rest and in transit
-**Input Validation**: Pydantic/Joi validation on all inputs
 
## Scalability
 
-**Horizontal Scaling**: Stateless services behind load balancer
-**Database Scaling**: Read replicas for read-heavy workloads
-**Caching**: Redis for frequently accessed data
-**Async Processing**: Background jobs for long-running tasks
 
## Deployment