timsquad 3.5.0 → 3.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ko.md +103 -107
- package/README.md +100 -104
- package/dist/commands/daemon.d.ts.map +1 -1
- package/dist/commands/daemon.js +48 -2
- package/dist/commands/daemon.js.map +1 -1
- package/dist/commands/init.js +46 -14
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/{upgrade.d.ts → update.d.ts} +3 -3
- package/dist/commands/update.d.ts.map +1 -0
- package/dist/commands/{upgrade.js → update.js} +12 -17
- package/dist/commands/update.js.map +1 -0
- package/dist/daemon/context-writer.d.ts +14 -0
- package/dist/daemon/context-writer.d.ts.map +1 -1
- package/dist/daemon/context-writer.js +29 -0
- package/dist/daemon/context-writer.js.map +1 -1
- package/dist/daemon/event-queue.d.ts +7 -11
- package/dist/daemon/event-queue.d.ts.map +1 -1
- package/dist/daemon/event-queue.js +78 -118
- package/dist/daemon/event-queue.js.map +1 -1
- package/dist/daemon/file-watcher.d.ts +14 -8
- package/dist/daemon/file-watcher.d.ts.map +1 -1
- package/dist/daemon/file-watcher.js +78 -41
- package/dist/daemon/file-watcher.js.map +1 -1
- package/dist/daemon/index.d.ts +1 -1
- package/dist/daemon/index.d.ts.map +1 -1
- package/dist/daemon/index.js +54 -47
- package/dist/daemon/index.js.map +1 -1
- package/dist/index.js +3 -41
- package/dist/index.js.map +1 -1
- package/dist/lib/agent-generator.d.ts.map +1 -1
- package/dist/lib/agent-generator.js +21 -10
- package/dist/lib/agent-generator.js.map +1 -1
- package/dist/lib/compile-rules.d.ts +2 -0
- package/dist/lib/compile-rules.d.ts.map +1 -1
- package/dist/lib/compile-rules.js +39 -4
- package/dist/lib/compile-rules.js.map +1 -1
- package/dist/lib/compiler.d.ts +22 -1
- package/dist/lib/compiler.d.ts.map +1 -1
- package/dist/lib/compiler.js +178 -12
- package/dist/lib/compiler.js.map +1 -1
- package/dist/lib/config.d.ts +3 -0
- package/dist/lib/config.d.ts.map +1 -1
- package/dist/lib/config.js +17 -2
- package/dist/lib/config.js.map +1 -1
- package/dist/{commands/log.d.ts → lib/log-utils.d.ts} +7 -15
- package/dist/lib/log-utils.d.ts.map +1 -0
- package/dist/lib/log-utils.js +347 -0
- package/dist/lib/log-utils.js.map +1 -0
- package/dist/lib/skill-generator.d.ts +1 -1
- package/dist/lib/skill-generator.d.ts.map +1 -1
- package/dist/lib/skill-generator.js +19 -44
- package/dist/lib/skill-generator.js.map +1 -1
- package/dist/lib/ssot-map.d.ts +31 -0
- package/dist/lib/ssot-map.d.ts.map +1 -0
- package/dist/lib/ssot-map.js +79 -0
- package/dist/lib/ssot-map.js.map +1 -0
- package/dist/lib/template.d.ts +10 -3
- package/dist/lib/template.d.ts.map +1 -1
- package/dist/lib/template.js +137 -22
- package/dist/lib/template.js.map +1 -1
- package/dist/lib/upgrade-backup.js +1 -1
- package/dist/lib/upgrade-backup.js.map +1 -1
- package/dist/lib/workflow-state.d.ts +1 -1
- package/dist/lib/workflow-state.d.ts.map +1 -1
- package/dist/lib/workflow-state.js +1 -1
- package/dist/lib/workflow-state.js.map +1 -1
- package/dist/types/config.d.ts +10 -1
- package/dist/types/config.d.ts.map +1 -1
- package/dist/types/config.js +46 -41
- package/dist/types/config.js.map +1 -1
- package/dist/types/feedback.d.ts +1 -54
- package/dist/types/feedback.d.ts.map +1 -1
- package/dist/types/feedback.js +1 -22
- package/dist/types/feedback.js.map +1 -1
- package/dist/types/index.d.ts +1 -0
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/index.js +1 -0
- package/dist/types/index.js.map +1 -1
- package/dist/types/meta-index.d.ts +8 -0
- package/dist/types/meta-index.d.ts.map +1 -1
- package/dist/types/project.d.ts +6 -1
- package/dist/types/project.d.ts.map +1 -1
- package/dist/types/project.js +15 -0
- package/dist/types/project.js.map +1 -1
- package/dist/types/ssot-map.d.ts +30 -0
- package/dist/types/ssot-map.d.ts.map +1 -0
- package/dist/types/ssot-map.js +6 -0
- package/dist/types/ssot-map.js.map +1 -0
- package/package.json +1 -1
- package/templates/base/agents/base/tsq-architect.md +1 -1
- package/templates/base/agents/base/tsq-dba.md +3 -1
- package/templates/base/agents/base/tsq-designer.md +3 -1
- package/templates/base/agents/base/tsq-developer.md +3 -1
- package/templates/base/agents/base/tsq-librarian.md +45 -0
- package/templates/base/agents/base/tsq-qa.md +3 -1
- package/templates/base/agents/base/tsq-security.md +3 -1
- package/templates/base/agents/overlays/platform/claude-code.md +2 -2
- package/templates/base/config.template.yaml +17 -28
- package/templates/base/knowledge/templates/task-result.md +5 -10
- package/templates/base/skills/_shared/naming-conventions.md +49 -0
- package/templates/base/skills/_template/SKILL.md +31 -17
- package/templates/base/skills/{architecture → tsq-architecture}/SKILL.md +2 -2
- package/templates/base/skills/tsq-audit/SKILL.md +74 -0
- package/templates/base/skills/{methodology/bdd → tsq-bdd}/SKILL.md +14 -9
- package/templates/base/skills/tsq-coding/SKILL.md +65 -0
- package/templates/base/skills/tsq-coding/rules/async-patterns.md +81 -0
- package/templates/base/skills/tsq-coding/rules/code-organization.md +80 -0
- package/templates/base/skills/tsq-coding/rules/error-handling.md +76 -0
- package/templates/base/skills/tsq-coding/rules/type-safety.md +85 -0
- package/templates/base/skills/tsq-controller/SKILL.md +81 -0
- package/templates/base/skills/tsq-controller/memory/.gitkeep +0 -0
- package/templates/base/skills/{mobile/dart → tsq-dart}/SKILL.md +5 -3
- package/templates/base/skills/{database → tsq-database}/SKILL.md +13 -27
- package/templates/base/skills/tsq-database/rules/query-optimization.md +32 -0
- package/templates/base/skills/tsq-database/rules/supabase-patterns.md +94 -0
- package/templates/base/skills/{methodology/ddd → tsq-ddd}/SKILL.md +15 -10
- package/templates/base/skills/{methodology/debugging → tsq-debugging}/SKILL.md +2 -2
- package/templates/base/skills/tsq-decompose/SKILL.md +117 -0
- package/templates/base/skills/tsq-delete/SKILL.md +72 -0
- package/templates/base/skills/{mobile/flutter → tsq-flutter}/SKILL.md +6 -3
- package/templates/base/skills/tsq-grill/SKILL.md +86 -0
- package/templates/base/skills/{backend/node → tsq-hono}/SKILL.md +6 -4
- package/templates/base/skills/tsq-librarian/SKILL.md +78 -0
- package/templates/base/skills/tsq-log/SKILL.md +30 -0
- package/templates/base/skills/{frontend/nextjs → tsq-nextjs}/SKILL.md +14 -9
- package/templates/base/skills/{planning → tsq-planning}/SKILL.md +2 -2
- package/templates/base/skills/{database/prisma → tsq-prisma}/SKILL.md +15 -9
- package/templates/base/skills/tsq-product-audit/SKILL.md +113 -0
- package/templates/base/skills/tsq-product-audit/checklists/01-security.md +86 -0
- package/templates/base/skills/tsq-product-audit/checklists/02-performance.md +67 -0
- package/templates/base/skills/tsq-product-audit/checklists/03-seo.md +46 -0
- package/templates/base/skills/tsq-product-audit/checklists/04-accessibility.md +66 -0
- package/templates/base/skills/tsq-product-audit/checklists/05-ui-ux.md +50 -0
- package/templates/base/skills/tsq-product-audit/checklists/06-architecture.md +53 -0
- package/templates/base/skills/tsq-product-audit/checklists/07-functional-requirements.md +55 -0
- package/templates/base/skills/tsq-product-audit/rules/audit-protocol.md +136 -0
- package/templates/base/skills/tsq-product-audit/rules/false-positive-guard.md +81 -0
- package/templates/base/skills/tsq-product-audit/rules/scoring-criteria.md +113 -0
- package/templates/base/skills/tsq-product-audit/templates/improvement-plan-template.md +60 -0
- package/templates/base/skills/tsq-product-audit/templates/report-template.md +88 -0
- package/templates/base/skills/tsq-prompt/SKILL.md +86 -0
- package/templates/base/skills/tsq-protocol/SKILL.md +101 -33
- package/templates/base/skills/{frontend/react → tsq-react}/SKILL.md +6 -3
- package/templates/base/skills/tsq-retro/SKILL.md +86 -0
- package/templates/base/skills/tsq-retro/references/feedback-guide.md +58 -0
- package/templates/base/skills/tsq-retro/references/improve-protocol.md +87 -0
- package/templates/base/skills/tsq-retro/references/improvement-template.md +26 -0
- package/templates/base/skills/tsq-security/SKILL.md +66 -0
- package/templates/base/skills/tsq-security/rules/auth-patterns.md +62 -0
- package/templates/base/skills/tsq-security/rules/dependency-security.md +69 -0
- package/templates/base/skills/tsq-security/rules/input-validation.md +68 -0
- package/templates/base/skills/tsq-security/rules/secrets-management.md +65 -0
- package/templates/base/skills/tsq-spec/SKILL.md +58 -0
- package/templates/base/skills/{stability-verification → tsq-stability}/SKILL.md +3 -3
- package/templates/base/skills/tsq-start/SKILL.md +90 -0
- package/templates/base/skills/tsq-start/references/onboarding-questions.md +177 -0
- package/templates/base/skills/tsq-status/SKILL.md +32 -0
- package/templates/base/skills/{methodology/tdd → tsq-tdd}/SKILL.md +12 -3
- package/templates/base/skills/tsq-testing/SKILL.md +69 -0
- package/templates/base/skills/tsq-testing/references/e2e-stability.md +33 -0
- package/templates/base/skills/{typescript → tsq-typescript}/SKILL.md +5 -11
- package/templates/base/skills/{ui-design → tsq-ui}/SKILL.md +2 -2
- package/templates/base/skills/tsq-update/SKILL.md +48 -0
- package/templates/base/timsquad/constraints/competency-framework.xml +2 -2
- package/templates/base/timsquad/constraints/ssot-schema.xml +2 -2
- package/templates/base/timsquad/process/phase-checklist.yaml +1 -1
- package/templates/base/timsquad/process/state-machine.xml +2 -2
- package/templates/base/timsquad/process/validation-rules.xml +8 -8
- package/templates/base/timsquad/process/workflow-base.xml +8 -8
- package/templates/base/timsquad/retrospective/cycle-report.template.md +2 -2
- package/templates/base/timsquad/retrospective/patterns/failure-patterns.md +1 -1
- package/templates/base/timsquad/retrospective/patterns/success-patterns.md +2 -2
- package/templates/base/timsquad/retrospective/retrospective-state.xml +2 -2
- package/templates/base/timsquad/ssot/audit-trail-spec.template.md +155 -0
- package/templates/base/timsquad/ssot/compliance-matrix.template.md +105 -0
- package/templates/base/timsquad/ssot/component-map.template.md +181 -0
- package/templates/base/timsquad/ssot/data-design.template.md +4 -4
- package/templates/base/timsquad/ssot/deployment-spec.template.md +29 -22
- package/templates/base/timsquad/ssot/env-config.template.md +4 -2
- package/templates/base/timsquad/ssot/error-codes.template.md +3 -3
- package/templates/base/timsquad/ssot/functional-spec.template.md +40 -3
- package/templates/base/timsquad/ssot/glossary.template.md +2 -2
- package/templates/base/timsquad/ssot/infra-topology.template.md +191 -0
- package/templates/base/timsquad/ssot/integration-spec.template.md +2 -2
- package/templates/base/timsquad/ssot/monitoring-spec.template.md +185 -0
- package/templates/base/timsquad/ssot/navigation-map.template.md +154 -0
- package/templates/base/timsquad/ssot/performance-budget.template.md +132 -0
- package/templates/base/timsquad/ssot/planning.template.md +3 -3
- package/templates/base/timsquad/ssot/prd/_template.md +73 -0
- package/templates/base/timsquad/ssot/prd.template.md +10 -21
- package/templates/base/timsquad/ssot/requirements.template.md +3 -3
- package/templates/base/timsquad/ssot/sdk-spec.template.md +223 -0
- package/templates/base/timsquad/ssot/service-spec.template.md +3 -3
- package/templates/base/timsquad/ssot/state-machine.template.md +127 -0
- package/templates/base/timsquad/ssot/test-spec.template.md +11 -1
- package/templates/base/timsquad/ssot/ui-ux-spec.template.md +43 -3
- package/templates/base/timsquad/ssot-map.template.yaml +69 -0
- package/templates/base/timsquad/state/workspace.xml +11 -11
- package/templates/platforms/claude-code/rules/adr-rules.md +1 -1
- package/templates/platforms/claude-code/rules/api-conventions.md +12 -0
- package/templates/platforms/claude-code/rules/build-gate.md +1 -1
- package/templates/platforms/claude-code/rules/completion-verification.md +0 -2
- package/templates/platforms/claude-code/rules/context-monitor.md +1 -1
- package/templates/platforms/claude-code/rules/feedback-routing.md +2 -2
- package/templates/platforms/claude-code/rules/librarian-constraints.md +11 -0
- package/templates/platforms/claude-code/rules/phase-management.md +2 -2
- package/templates/platforms/claude-code/rules/plan-review.md +2 -2
- package/templates/platforms/claude-code/rules/quality-guards.md +0 -2
- package/templates/platforms/claude-code/rules/sequence-management.md +15 -15
- package/templates/platforms/claude-code/rules/session-notes.md +1 -1
- package/templates/platforms/claude-code/rules/test-conventions.md +13 -0
- package/templates/platforms/claude-code/rules/workspace-sync.md +1 -1
- package/templates/platforms/claude-code/scripts/build-gate.sh +6 -1
- package/templates/platforms/claude-code/scripts/change-scope-guard.sh +110 -0
- package/templates/platforms/claude-code/scripts/check-capability.sh +68 -0
- package/templates/platforms/claude-code/scripts/completion-guard.sh +134 -14
- package/templates/platforms/claude-code/scripts/context-restore.sh +95 -0
- package/templates/platforms/claude-code/scripts/e2e-commit-gate.sh +70 -0
- package/templates/platforms/claude-code/scripts/e2e-marker.sh +51 -0
- package/templates/platforms/claude-code/scripts/phase-guard.sh +3 -6
- package/templates/platforms/claude-code/scripts/pre-compact.sh +70 -0
- package/templates/platforms/claude-code/scripts/safe-guard.sh +2 -5
- package/templates/platforms/claude-code/scripts/subagent-start.sh +11 -0
- package/templates/platforms/claude-code/scripts/subagent-stop.sh +11 -0
- package/templates/platforms/claude-code/settings.json +28 -56
- package/templates/project-types/api-backend/config.yaml +9 -5
- package/templates/project-types/api-backend/process/workflow.xml +2 -2
- package/templates/project-types/fintech/config.yaml +13 -19
- package/templates/project-types/fintech/ssot/audit-trail-spec.template.md +207 -0
- package/templates/project-types/fintech/ssot/compliance-matrix.template.md +187 -0
- package/templates/project-types/infra/config.yaml +7 -4
- package/templates/project-types/infra/process/workflow.xml +3 -3
- package/templates/project-types/mobile-app/config.yaml +8 -14
- package/templates/project-types/mobile-app/process/workflow.xml +4 -4
- package/templates/project-types/platform/config.yaml +8 -5
- package/templates/project-types/platform/process/workflow.xml +3 -3
- package/templates/project-types/web-app/config.yaml +9 -15
- package/templates/project-types/web-app/process/workflow.xml +6 -6
- package/templates/project-types/web-service/config.yaml +10 -19
- package/templates/project-types/web-service/process/workflow.xml +6 -6
- package/dist/commands/compile.d.ts +0 -3
- package/dist/commands/compile.d.ts.map +0 -1
- package/dist/commands/compile.js +0 -170
- package/dist/commands/compile.js.map +0 -1
- package/dist/commands/feedback.d.ts +0 -12
- package/dist/commands/feedback.d.ts.map +0 -1
- package/dist/commands/feedback.js +0 -382
- package/dist/commands/feedback.js.map +0 -1
- package/dist/commands/full.d.ts +0 -3
- package/dist/commands/full.d.ts.map +0 -1
- package/dist/commands/full.js +0 -88
- package/dist/commands/full.js.map +0 -1
- package/dist/commands/git/commit.d.ts +0 -3
- package/dist/commands/git/commit.d.ts.map +0 -1
- package/dist/commands/git/commit.js +0 -85
- package/dist/commands/git/commit.js.map +0 -1
- package/dist/commands/git/index.d.ts +0 -5
- package/dist/commands/git/index.d.ts.map +0 -1
- package/dist/commands/git/index.js +0 -5
- package/dist/commands/git/index.js.map +0 -1
- package/dist/commands/git/pr.d.ts +0 -3
- package/dist/commands/git/pr.d.ts.map +0 -1
- package/dist/commands/git/pr.js +0 -139
- package/dist/commands/git/pr.js.map +0 -1
- package/dist/commands/git/release.d.ts +0 -3
- package/dist/commands/git/release.d.ts.map +0 -1
- package/dist/commands/git/release.js +0 -153
- package/dist/commands/git/release.js.map +0 -1
- package/dist/commands/git/sync.d.ts +0 -3
- package/dist/commands/git/sync.d.ts.map +0 -1
- package/dist/commands/git/sync.js +0 -132
- package/dist/commands/git/sync.js.map +0 -1
- package/dist/commands/improve.d.ts +0 -3
- package/dist/commands/improve.d.ts.map +0 -1
- package/dist/commands/improve.js +0 -286
- package/dist/commands/improve.js.map +0 -1
- package/dist/commands/knowledge.d.ts +0 -3
- package/dist/commands/knowledge.d.ts.map +0 -1
- package/dist/commands/knowledge.js +0 -316
- package/dist/commands/knowledge.js.map +0 -1
- package/dist/commands/log.d.ts.map +0 -1
- package/dist/commands/log.js +0 -1436
- package/dist/commands/log.js.map +0 -1
- package/dist/commands/meta-index.d.ts +0 -3
- package/dist/commands/meta-index.d.ts.map +0 -1
- package/dist/commands/meta-index.js +0 -401
- package/dist/commands/meta-index.js.map +0 -1
- package/dist/commands/metrics.d.ts +0 -3
- package/dist/commands/metrics.d.ts.map +0 -1
- package/dist/commands/metrics.js +0 -843
- package/dist/commands/metrics.js.map +0 -1
- package/dist/commands/quick.d.ts +0 -3
- package/dist/commands/quick.d.ts.map +0 -1
- package/dist/commands/quick.js +0 -136
- package/dist/commands/quick.js.map +0 -1
- package/dist/commands/retro.d.ts +0 -3
- package/dist/commands/retro.d.ts.map +0 -1
- package/dist/commands/retro.js +0 -828
- package/dist/commands/retro.js.map +0 -1
- package/dist/commands/session.d.ts +0 -3
- package/dist/commands/session.d.ts.map +0 -1
- package/dist/commands/session.js +0 -346
- package/dist/commands/session.js.map +0 -1
- package/dist/commands/skills.d.ts +0 -12
- package/dist/commands/skills.d.ts.map +0 -1
- package/dist/commands/skills.js +0 -228
- package/dist/commands/skills.js.map +0 -1
- package/dist/commands/status.d.ts +0 -3
- package/dist/commands/status.d.ts.map +0 -1
- package/dist/commands/status.js +0 -127
- package/dist/commands/status.js.map +0 -1
- package/dist/commands/upgrade.d.ts.map +0 -1
- package/dist/commands/upgrade.js.map +0 -1
- package/dist/commands/watch.d.ts +0 -3
- package/dist/commands/watch.d.ts.map +0 -1
- package/dist/commands/watch.js +0 -213
- package/dist/commands/watch.js.map +0 -1
- package/dist/commands/workflow.d.ts +0 -3
- package/dist/commands/workflow.d.ts.map +0 -1
- package/dist/commands/workflow.js +0 -607
- package/dist/commands/workflow.js.map +0 -1
- package/templates/base/skills/coding/SKILL.md +0 -47
- package/templates/base/skills/controller/SKILL.md +0 -111
- package/templates/base/skills/prompt-engineering/SKILL.md +0 -103
- package/templates/base/skills/retrospective/SKILL.md +0 -102
- package/templates/base/skills/security/SKILL.md +0 -55
- package/templates/base/skills/testing/SKILL.md +0 -63
- package/templates/base/timsquad/feedback/feedback-router.sh +0 -341
- package/templates/base/timsquad/feedback/routing-rules.yaml +0 -352
- package/templates/platforms/claude-code/CLAUDE.md.template +0 -89
- package/templates/platforms/claude-code/rules/skill-suggest.md +0 -27
- package/templates/platforms/claude-code/scripts/skill-rules.json +0 -85
- package/templates/platforms/claude-code/scripts/skill-suggest.sh +0 -105
- /package/templates/base/skills/{architecture → tsq-architecture}/references/adr-template.md +0 -0
- /package/templates/base/skills/{architecture → tsq-architecture}/references/api-design.md +0 -0
- /package/templates/base/skills/{methodology/bdd → tsq-bdd}/rules/gherkin-patterns.md +0 -0
- /package/templates/base/skills/{coding → tsq-coding}/rules/patterns.md +0 -0
- /package/templates/base/skills/{controller → tsq-controller}/references/README.md +0 -0
- /package/templates/base/skills/{controller → tsq-controller}/rules/README.md +0 -0
- /package/templates/base/skills/{mobile/dart → tsq-dart}/rules/async-patterns.md +0 -0
- /package/templates/base/skills/{mobile/dart → tsq-dart}/rules/code-style.md +0 -0
- /package/templates/base/skills/{mobile/dart → tsq-dart}/rules/null-safety.md +0 -0
- /package/templates/base/skills/{mobile/dart → tsq-dart}/rules/type-system.md +0 -0
- /package/templates/base/skills/{methodology/ddd → tsq-ddd}/rules/strategic-patterns.md +0 -0
- /package/templates/base/skills/{methodology/debugging → tsq-debugging}/references/root-cause-tracing.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/SKILL.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/references/ci-cd-pipeline.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/code-signing.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/codemagic-setup.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/fastlane-setup.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/github-actions.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/store-deployment.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/ci-cd/rules/versioning.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/SKILL.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/references/i18n-architecture.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/arb-files.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/locale-switching.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/localization-setup.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/plural-gender.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/i18n/rules/text-direction.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/SKILL.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/references/monitoring-architecture.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/analytics.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/crashlytics-setup.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/logging.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/performance-monitoring.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/monitoring/rules/sentry-integration.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/SKILL.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/references/api-client-architecture.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/caching.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/connectivity.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/dio-setup.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/error-handling.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/interceptors.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/networking/rules/retrofit-patterns.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/SKILL.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/references/notification-architecture.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/references/platform-setup.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/background-processing.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/deep-linking.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/fcm-setup.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/local-notifications.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/notification-handling.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/notification-permissions.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/push-notifications/rules/rich-notifications.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/references/freezed-patterns.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/references/project-structure.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/animations.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/architecture.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/navigation-routing.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/performance.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/platform-adaptive.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/state-management.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/testing.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/rules/widget-conventions.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/SKILL.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/references/mobile-security-checklist.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/api-key-protection.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/authentication.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/data-protection.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/obfuscation.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/secure-storage.md +0 -0
- /package/templates/base/skills/{mobile/flutter → tsq-flutter}/security/rules/ssl-pinning.md +0 -0
- /package/templates/base/skills/{backend/node → tsq-hono}/rules/async-patterns.md +0 -0
- /package/templates/base/skills/{backend/node → tsq-hono}/rules/deployment.md +0 -0
- /package/templates/base/skills/{backend/node → tsq-hono}/rules/env-config.md +0 -0
- /package/templates/base/skills/{backend/node → tsq-hono}/rules/error-handling.md +0 -0
- /package/templates/base/skills/{backend/node → tsq-hono}/rules/hono-app-setup.md +0 -0
- /package/templates/base/skills/{backend/node → tsq-hono}/rules/jwt-auth.md +0 -0
- /package/templates/base/skills/{backend/node → tsq-hono}/rules/middleware.md +0 -0
- /package/templates/base/skills/{backend/node → tsq-hono}/rules/testing.md +0 -0
- /package/templates/base/skills/{frontend/nextjs → tsq-nextjs}/rules/app-router.md +0 -0
- /package/templates/base/skills/{planning → tsq-planning}/references/prd-guide.md +0 -0
- /package/templates/base/skills/{planning → tsq-planning}/references/requirements-guide.md +0 -0
- /package/templates/base/skills/{database/prisma → tsq-prisma}/rules/queries.md +0 -0
- /package/templates/base/skills/{database/prisma → tsq-prisma}/rules/schema-design.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/_sections.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/anti-patterns.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-api-routes.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-defer-await.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-dependencies.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-parallel.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/async-suspense-boundaries.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/bundle-barrel-imports.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/bundle-defer-third-party.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/bundle-dynamic-imports.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/component-conventions.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/js-combine-iterations.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/js-early-exit.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/js-index-maps.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/js-set-map-lookups.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/rendering-conditional-render.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/rendering-content-visibility.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/rendering-hoist-jsx.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/rerender-defer-reads.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/rerender-derived-state.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/rerender-memo.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/rerender-transitions.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/server-after-nonblocking.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/server-cache-react.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/server-parallel-fetching.md +0 -0
- /package/templates/base/skills/{frontend/react → tsq-react}/rules/state-location.md +0 -0
- /package/templates/base/skills/{security → tsq-security}/rules/owasp-examples.md +0 -0
- /package/templates/base/skills/{security → tsq-security}/scripts/check-secrets.sh +0 -0
- /package/templates/base/skills/{stability-verification → tsq-stability}/references/release-checklist.md +0 -0
- /package/templates/base/skills/{stability-verification → tsq-stability}/references/security-fix-patterns.md +0 -0
- /package/templates/base/skills/{stability-verification → tsq-stability}/rules/verification-layers.md +0 -0
- /package/templates/base/skills/{stability-verification → tsq-stability}/rules/verification-workflow.md +0 -0
- /package/templates/base/skills/{stability-verification → tsq-stability}/scripts/verify.sh +0 -0
- /package/templates/base/skills/{methodology/tdd → tsq-tdd}/rules/real-world-example.md +0 -0
- /package/templates/base/skills/{methodology/tdd → tsq-tdd}/rules/techniques.md +0 -0
- /package/templates/base/skills/{testing → tsq-testing}/references/testing-patterns.md +0 -0
- /package/templates/base/skills/{typescript → tsq-typescript}/rules/type-patterns.md +0 -0
- /package/templates/base/skills/{typescript → tsq-typescript}/rules/utility-types.md +0 -0
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "컴포넌트 맵 (Component Map)"
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
last_updated: {{DATE}}
|
|
5
|
+
author: tsq-designer
|
|
6
|
+
status: draft
|
|
7
|
+
project: {{PROJECT_NAME}}
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 컴포넌트 맵 (Component Map)
|
|
11
|
+
|
|
12
|
+
> UI 컴포넌트의 계층 구조, 재사용 정책, Props 인터페이스를 정의합니다.
|
|
13
|
+
> 디자인 시스템과 개발 구현 사이의 일관성을 보장합니다.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. 컴포넌트 계층
|
|
18
|
+
|
|
19
|
+
### 1.1 분류 체계
|
|
20
|
+
|
|
21
|
+
| 계층 | 설명 | 예시 | 의존성 |
|
|
22
|
+
|-----|------|------|--------|
|
|
23
|
+
| Primitives | 최소 단위, 스타일만 | Button, Input, Text | 없음 |
|
|
24
|
+
| Components | 단일 기능 조합 | SearchBar, Card, Modal | Primitives |
|
|
25
|
+
| Composites | 비즈니스 로직 포함 | UserCard, OrderList | Components + 상태 |
|
|
26
|
+
| Layouts | 페이지 레이아웃 | AppShell, SidebarLayout | Composites |
|
|
27
|
+
| Pages | 라우트 대응 화면 | HomePage, DetailPage | Layouts + 데이터 |
|
|
28
|
+
|
|
29
|
+
### 1.2 디렉토리 구조
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
src/components/
|
|
33
|
+
├── primitives/
|
|
34
|
+
│ ├── Button/
|
|
35
|
+
│ │ ├── Button.tsx
|
|
36
|
+
│ │ ├── Button.test.tsx
|
|
37
|
+
│ │ └── index.ts
|
|
38
|
+
│ ├── Input/
|
|
39
|
+
│ ├── Text/
|
|
40
|
+
│ └── Icon/
|
|
41
|
+
├── components/
|
|
42
|
+
│ ├── SearchBar/
|
|
43
|
+
│ ├── Card/
|
|
44
|
+
│ ├── Modal/
|
|
45
|
+
│ └── Toast/
|
|
46
|
+
├── composites/
|
|
47
|
+
│ ├── UserCard/
|
|
48
|
+
│ ├── OrderList/
|
|
49
|
+
│ └── NotificationBell/
|
|
50
|
+
└── layouts/
|
|
51
|
+
├── AppShell/
|
|
52
|
+
├── AuthLayout/
|
|
53
|
+
└── DashboardLayout/
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## 2. Primitives
|
|
59
|
+
|
|
60
|
+
### 2.1 Button
|
|
61
|
+
|
|
62
|
+
| Prop | 타입 | 기본값 | 설명 |
|
|
63
|
+
|------|------|--------|------|
|
|
64
|
+
| variant | `'primary' \| 'secondary' \| 'ghost' \| 'danger'` | `'primary'` | 스타일 변형 |
|
|
65
|
+
| size | `'sm' \| 'md' \| 'lg'` | `'md'` | 크기 |
|
|
66
|
+
| disabled | `boolean` | `false` | 비활성화 |
|
|
67
|
+
| loading | `boolean` | `false` | 로딩 상태 |
|
|
68
|
+
| fullWidth | `boolean` | `false` | 전체 너비 |
|
|
69
|
+
| children | `ReactNode` | - | 버튼 내용 |
|
|
70
|
+
| onPress | `() => void` | - | 클릭 핸들러 |
|
|
71
|
+
|
|
72
|
+
### 2.2 Input
|
|
73
|
+
|
|
74
|
+
| Prop | 타입 | 기본값 | 설명 |
|
|
75
|
+
|------|------|--------|------|
|
|
76
|
+
| type | `'text' \| 'email' \| 'password' \| 'number'` | `'text'` | 입력 타입 |
|
|
77
|
+
| label | `string` | - | 라벨 |
|
|
78
|
+
| placeholder | `string` | - | 플레이스홀더 |
|
|
79
|
+
| error | `string` | - | 에러 메시지 |
|
|
80
|
+
| disabled | `boolean` | `false` | 비활성화 |
|
|
81
|
+
|
|
82
|
+
### 2.3 Text
|
|
83
|
+
|
|
84
|
+
| Prop | 타입 | 기본값 | 설명 |
|
|
85
|
+
|------|------|--------|------|
|
|
86
|
+
| variant | `'h1' \| 'h2' \| 'h3' \| 'body' \| 'caption'` | `'body'` | 타이포그래피 |
|
|
87
|
+
| color | `string` | `'text.primary'` | 색상 토큰 |
|
|
88
|
+
| align | `'left' \| 'center' \| 'right'` | `'left'` | 정렬 |
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## 3. Components
|
|
93
|
+
|
|
94
|
+
### 3.1 Card
|
|
95
|
+
|
|
96
|
+
| Prop | 타입 | 기본값 | 설명 |
|
|
97
|
+
|------|------|--------|------|
|
|
98
|
+
| variant | `'elevated' \| 'outlined' \| 'filled'` | `'elevated'` | 스타일 |
|
|
99
|
+
| padding | `'none' \| 'sm' \| 'md' \| 'lg'` | `'md'` | 내부 여백 |
|
|
100
|
+
| onPress | `() => void` | - | 클릭 가능 여부 |
|
|
101
|
+
| children | `ReactNode` | - | 카드 내용 |
|
|
102
|
+
|
|
103
|
+
### 3.2 Modal
|
|
104
|
+
|
|
105
|
+
| Prop | 타입 | 기본값 | 설명 |
|
|
106
|
+
|------|------|--------|------|
|
|
107
|
+
| open | `boolean` | `false` | 표시 여부 |
|
|
108
|
+
| onClose | `() => void` | - | 닫기 핸들러 |
|
|
109
|
+
| title | `string` | - | 제목 |
|
|
110
|
+
| size | `'sm' \| 'md' \| 'lg' \| 'full'` | `'md'` | 크기 |
|
|
111
|
+
| closeOnOverlay | `boolean` | `true` | 오버레이 클릭 닫기 |
|
|
112
|
+
|
|
113
|
+
### 3.3 Toast
|
|
114
|
+
|
|
115
|
+
| Prop | 타입 | 기본값 | 설명 |
|
|
116
|
+
|------|------|--------|------|
|
|
117
|
+
| type | `'success' \| 'error' \| 'warning' \| 'info'` | `'info'` | 토스트 타입 |
|
|
118
|
+
| message | `string` | - | 메시지 |
|
|
119
|
+
| duration | `number` | `3000` | 표시 시간 (ms) |
|
|
120
|
+
| action | `{ label: string; onPress: () => void }` | - | 액션 버튼 |
|
|
121
|
+
|
|
122
|
+
---
|
|
123
|
+
|
|
124
|
+
## 4. 재사용 정책
|
|
125
|
+
|
|
126
|
+
### 4.1 규칙
|
|
127
|
+
|
|
128
|
+
| 규칙 | 설명 |
|
|
129
|
+
|-----|------|
|
|
130
|
+
| 단방향 의존 | 상위 계층만 하위 계층을 import |
|
|
131
|
+
| Props 전용 통신 | 컴포넌트 간 데이터는 Props로만 전달 |
|
|
132
|
+
| 비즈니스 로직 분리 | Primitives/Components에 비즈니스 로직 금지 |
|
|
133
|
+
| 스타일 토큰 사용 | 하드코딩 색상/크기 금지, 디자인 토큰만 사용 |
|
|
134
|
+
|
|
135
|
+
### 4.2 신규 컴포넌트 기준
|
|
136
|
+
|
|
137
|
+
| 기준 | 임계값 |
|
|
138
|
+
|-----|--------|
|
|
139
|
+
| 재사용 횟수 | 3회 이상 사용 시 컴포넌트화 |
|
|
140
|
+
| Props 수 | 10개 초과 시 분리 검토 |
|
|
141
|
+
| 중첩 깊이 | 3단계 초과 시 Composite로 승격 |
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
## 5. 디자인 토큰
|
|
146
|
+
|
|
147
|
+
### 5.1 색상
|
|
148
|
+
|
|
149
|
+
| 토큰 | Light | Dark | 용도 |
|
|
150
|
+
|-----|-------|------|------|
|
|
151
|
+
| `colors.primary` | #3B82F6 | #60A5FA | 주요 액션 |
|
|
152
|
+
| `colors.secondary` | #6B7280 | #9CA3AF | 보조 액션 |
|
|
153
|
+
| `colors.danger` | #EF4444 | #F87171 | 위험/삭제 |
|
|
154
|
+
| `colors.text.primary` | #111827 | #F9FAFB | 본문 텍스트 |
|
|
155
|
+
| `colors.bg.primary` | #FFFFFF | #111827 | 배경 |
|
|
156
|
+
|
|
157
|
+
### 5.2 간격
|
|
158
|
+
|
|
159
|
+
| 토큰 | 값 | 용도 |
|
|
160
|
+
|-----|-----|------|
|
|
161
|
+
| `spacing.xs` | 4px | 아이콘 간격 |
|
|
162
|
+
| `spacing.sm` | 8px | 요소 내부 |
|
|
163
|
+
| `spacing.md` | 16px | 섹션 내부 |
|
|
164
|
+
| `spacing.lg` | 24px | 섹션 간 |
|
|
165
|
+
| `spacing.xl` | 32px | 페이지 여백 |
|
|
166
|
+
|
|
167
|
+
---
|
|
168
|
+
|
|
169
|
+
## 6. 관련 문서
|
|
170
|
+
|
|
171
|
+
- [UI/UX 명세](./ui-ux-spec.md) — 화면 디자인 상세
|
|
172
|
+
- [네비게이션 맵](./navigation-map.md) — 화면 구조
|
|
173
|
+
- [성능 예산](./performance-budget.md) — 번들 크기 제약
|
|
174
|
+
|
|
175
|
+
---
|
|
176
|
+
|
|
177
|
+
## 변경 이력
|
|
178
|
+
|
|
179
|
+
| 버전 | 날짜 | 작성자 | 변경 내용 |
|
|
180
|
+
|------|------|--------|----------|
|
|
181
|
+
| 1.0.0 | {{DATE}} | tsq-designer | 초기 작성 |
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
# {PROJECT_NAME} 데이터 설계서
|
|
1
|
+
# {{PROJECT_NAME}} 데이터 설계서
|
|
2
2
|
|
|
3
3
|
**Version**: 1.0
|
|
4
|
-
**Created**: {DATE}
|
|
4
|
+
**Created**: {{DATE}}
|
|
5
5
|
**Database**: PostgreSQL / MySQL / MongoDB
|
|
6
6
|
|
|
7
7
|
---
|
|
@@ -104,7 +104,7 @@ VALUES ('admin@example.com', 'Admin', '$2b$...', 'active');
|
|
|
104
104
|
|
|
105
105
|
| Version | Date | Description |
|
|
106
106
|
|---------|------|-------------|
|
|
107
|
-
| 001 | {DATE} | 초기 스키마 생성 |
|
|
107
|
+
| 001 | {{DATE}} | 초기 스키마 생성 |
|
|
108
108
|
|
|
109
109
|
---
|
|
110
110
|
|
|
@@ -129,4 +129,4 @@ VALUES ('admin@example.com', 'Admin', '$2b$...', 'active');
|
|
|
129
129
|
|
|
130
130
|
| 버전 | 날짜 | 변경 내용 | 작성자 |
|
|
131
131
|
|-----|-----|----------|-------|
|
|
132
|
-
| 1.0 | {DATE} | 최초 작성 | |
|
|
132
|
+
| 1.0 | {{DATE}} | 최초 작성 | |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
title: "배포 명세서 (Deployment Specification)"
|
|
3
3
|
version: 1.0.0
|
|
4
4
|
last_updated: {{DATE}}
|
|
5
|
-
author: tsq-
|
|
5
|
+
author: tsq-architect
|
|
6
6
|
status: draft
|
|
7
7
|
project: {{PROJECT_NAME}}
|
|
8
8
|
required_level: 3
|
|
@@ -21,13 +21,11 @@ required_level: 3
|
|
|
21
21
|
|
|
22
22
|
```
|
|
23
23
|
┌─────────────┐
|
|
24
|
-
│
|
|
25
|
-
│ (CloudFront)│
|
|
24
|
+
│ CDN │
|
|
26
25
|
└──────┬──────┘
|
|
27
26
|
│
|
|
28
27
|
┌──────▼──────┐
|
|
29
28
|
│ Load Balancer│
|
|
30
|
-
│ (ALB) │
|
|
31
29
|
└──────┬──────┘
|
|
32
30
|
│
|
|
33
31
|
┌─────────────────┼─────────────────┐
|
|
@@ -42,9 +40,10 @@ required_level: 3
|
|
|
42
40
|
┌────────────┼────────────┐
|
|
43
41
|
│ │ │
|
|
44
42
|
┌────▼────┐ ┌───▼────┐ ┌───▼────┐
|
|
45
|
-
│
|
|
46
|
-
│ (RDS) │ │(Cache) │ │(Storage)│
|
|
43
|
+
│ DB │ │ Cache │ │Storage │
|
|
47
44
|
└─────────┘ └────────┘ └────────┘
|
|
45
|
+
|
|
46
|
+
> 클라우드 예시: AWS (CloudFront, ALB, ECS, RDS), GCP (Cloud CDN, Cloud Run, Cloud SQL), Azure (Front Door, App Service, Azure DB)
|
|
48
47
|
```
|
|
49
48
|
|
|
50
49
|
### 1.2 환경 구성
|
|
@@ -63,34 +62,38 @@ required_level: 3
|
|
|
63
62
|
|
|
64
63
|
| 리소스 | 서비스 | 사양 | 환경별 수량 |
|
|
65
64
|
|-------|-------|------|-----------|
|
|
66
|
-
| 애플리케이션 |
|
|
67
|
-
| 배치 작업 |
|
|
65
|
+
| 애플리케이션 | 컨테이너 서비스 | 0.5 vCPU, 1GB | Dev:1, Stg:2, Prod:3+ |
|
|
66
|
+
| 배치 작업 | 서버리스 함수 | 256MB | 필요 시 |
|
|
67
|
+
|
|
68
|
+
> 클라우드별: AWS(ECS Fargate, Lambda), GCP(Cloud Run, Cloud Functions), Azure(Container Apps, Azure Functions)
|
|
68
69
|
|
|
69
70
|
### 2.2 데이터베이스
|
|
70
71
|
|
|
71
72
|
| 리소스 | 서비스 | 사양 | 백업 |
|
|
72
73
|
|-------|-------|------|------|
|
|
73
|
-
| Primary DB |
|
|
74
|
-
| Read Replica |
|
|
75
|
-
| Cache |
|
|
74
|
+
| Primary DB | Managed PostgreSQL | Medium | 7일 |
|
|
75
|
+
| Read Replica | (Prod만) | Medium | - |
|
|
76
|
+
| Cache | Managed Redis | Small | - |
|
|
77
|
+
|
|
78
|
+
> 클라우드별: AWS(RDS, ElastiCache), GCP(Cloud SQL, Memorystore), Azure(Azure DB, Azure Cache)
|
|
76
79
|
|
|
77
80
|
### 2.3 스토리지
|
|
78
81
|
|
|
79
82
|
| 리소스 | 서비스 | 용도 |
|
|
80
83
|
|-------|-------|------|
|
|
81
|
-
| 정적 파일 |
|
|
82
|
-
| 로그 |
|
|
83
|
-
| 백업 |
|
|
84
|
+
| 정적 파일 | 오브젝트 스토리지 | 이미지, 파일 업로드 |
|
|
85
|
+
| 로그 | 오브젝트 스토리지 + 로그 서비스 | 애플리케이션 로그 |
|
|
86
|
+
| 백업 | 아카이브 스토리지 | DB 백업 장기 보관 |
|
|
84
87
|
|
|
85
88
|
### 2.4 네트워크
|
|
86
89
|
|
|
87
|
-
| 리소스 |
|
|
88
|
-
|
|
89
|
-
| VPC |
|
|
90
|
-
| Public Subnet | 2개 AZ
|
|
91
|
-
| Private Subnet | 2개 AZ
|
|
92
|
-
| NAT Gateway |
|
|
93
|
-
| Security Group | 서비스별
|
|
90
|
+
| 리소스 | 설정 |
|
|
91
|
+
|-------|------|
|
|
92
|
+
| VPC/VNet | 10.0.0.0/16 |
|
|
93
|
+
| Public Subnet | 2개 AZ, 10.0.1.0/24, 10.0.2.0/24 |
|
|
94
|
+
| Private Subnet | 2개 AZ, 10.0.10.0/24, 10.0.20.0/24 |
|
|
95
|
+
| NAT Gateway | 아웃바운드 트래픽 |
|
|
96
|
+
| Security Group | 서비스별 최소 권한 |
|
|
94
97
|
|
|
95
98
|
---
|
|
96
99
|
|
|
@@ -137,6 +140,7 @@ jobs:
|
|
|
137
140
|
docker push $IMAGE_NAME
|
|
138
141
|
|
|
139
142
|
test:
|
|
143
|
+
runs-on: ubuntu-latest
|
|
140
144
|
needs: build
|
|
141
145
|
steps:
|
|
142
146
|
- name: Unit Tests
|
|
@@ -149,6 +153,7 @@ jobs:
|
|
|
149
153
|
run: npm audit
|
|
150
154
|
|
|
151
155
|
deploy-staging:
|
|
156
|
+
runs-on: ubuntu-latest
|
|
152
157
|
needs: test
|
|
153
158
|
if: github.ref == 'refs/heads/develop'
|
|
154
159
|
steps:
|
|
@@ -156,6 +161,7 @@ jobs:
|
|
|
156
161
|
run: ./deploy.sh staging
|
|
157
162
|
|
|
158
163
|
deploy-production:
|
|
164
|
+
runs-on: ubuntu-latest
|
|
159
165
|
needs: test
|
|
160
166
|
if: github.ref == 'refs/heads/main'
|
|
161
167
|
environment: production # 승인 필요
|
|
@@ -164,6 +170,7 @@ jobs:
|
|
|
164
170
|
run: ./deploy.sh production
|
|
165
171
|
|
|
166
172
|
verify:
|
|
173
|
+
runs-on: ubuntu-latest
|
|
167
174
|
needs: [deploy-staging, deploy-production]
|
|
168
175
|
steps:
|
|
169
176
|
- name: Smoke Test
|
|
@@ -381,4 +388,4 @@ CMD ["node", "dist/main.js"]
|
|
|
381
388
|
|
|
382
389
|
| 버전 | 날짜 | 작성자 | 변경 내용 |
|
|
383
390
|
|------|------|--------|----------|
|
|
384
|
-
| 1.0.0 | {{DATE}} | tsq-
|
|
391
|
+
| 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
title: "환경 설정 (Environment Configuration)"
|
|
3
3
|
version: 1.0.0
|
|
4
4
|
last_updated: {{DATE}}
|
|
5
|
-
author: tsq-
|
|
5
|
+
author: tsq-architect
|
|
6
6
|
status: draft
|
|
7
7
|
project: {{PROJECT_NAME}}
|
|
8
8
|
---
|
|
@@ -118,6 +118,8 @@ DATABASE_URL=postgresql://postgres:postgres@localhost:5432/{{PROJECT_NAME}}_dev
|
|
|
118
118
|
REDIS_URL=redis://localhost:6379
|
|
119
119
|
|
|
120
120
|
# Auth
|
|
121
|
+
# ⚠️ 아래는 로컬 개발 전용. 절대 프로덕션에서 사용 금지.
|
|
122
|
+
# 프로덕션은 반드시 시크릿 매니저(Vault, AWS Secrets Manager 등)에서 주입.
|
|
121
123
|
JWT_SECRET=local-dev-secret-change-in-production
|
|
122
124
|
JWT_EXPIRES_IN=1d
|
|
123
125
|
SESSION_SECRET=local-session-secret
|
|
@@ -343,4 +345,4 @@ if (await featureService.isEnabled('NEW_UI', userId)) {
|
|
|
343
345
|
|
|
344
346
|
| 버전 | 날짜 | 작성자 | 변경 내용 |
|
|
345
347
|
|------|------|--------|----------|
|
|
346
|
-
| 1.0.0 | {{DATE}} | tsq-
|
|
348
|
+
| 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
# {PROJECT_NAME} 에러 코드
|
|
1
|
+
# {{PROJECT_NAME}} 에러 코드
|
|
2
2
|
|
|
3
3
|
**Version**: 1.0
|
|
4
|
-
**Created**: {DATE}
|
|
4
|
+
**Created**: {{DATE}}
|
|
5
5
|
|
|
6
6
|
---
|
|
7
7
|
|
|
@@ -111,4 +111,4 @@
|
|
|
111
111
|
|
|
112
112
|
| 버전 | 날짜 | 변경 내용 | 작성자 |
|
|
113
113
|
|-----|-----|----------|-------|
|
|
114
|
-
| 1.0 | {DATE} | 최초 작성 | |
|
|
114
|
+
| 1.0 | {{DATE}} | 최초 작성 | |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
title: "기능 명세서 (Functional Specification)"
|
|
3
3
|
version: 1.0.0
|
|
4
4
|
last_updated: {{DATE}}
|
|
5
|
-
author: tsq-
|
|
5
|
+
author: tsq-architect
|
|
6
6
|
status: draft
|
|
7
7
|
project: {{PROJECT_NAME}}
|
|
8
8
|
---
|
|
@@ -130,7 +130,44 @@ Feature: [기능명]
|
|
|
130
130
|
|
|
131
131
|
### FS-002: [기능명]
|
|
132
132
|
|
|
133
|
-
|
|
133
|
+
#### 3.2.1 개요
|
|
134
|
+
|
|
135
|
+
| 항목 | 내용 |
|
|
136
|
+
|-----|------|
|
|
137
|
+
| **ID** | FS-002 |
|
|
138
|
+
| **기능명** | |
|
|
139
|
+
| **우선순위** | P0 / P1 / P2 |
|
|
140
|
+
| **관련 PRD** | [prd/xxx](./prd/xxx.md) |
|
|
141
|
+
| **관련 요건** | FR-XXX-001 |
|
|
142
|
+
| **관련 화면** | [SCR-002](./ui-ux-spec.md#SCR-002) |
|
|
143
|
+
| **관련 API** | [service-spec](./service-spec.md) |
|
|
144
|
+
|
|
145
|
+
#### 3.2.2 사전 조건 (Preconditions)
|
|
146
|
+
-
|
|
147
|
+
|
|
148
|
+
#### 3.2.3 주요 흐름 (Main Flow)
|
|
149
|
+
|
|
150
|
+
| 단계 | Actor | Action | System Response |
|
|
151
|
+
|:----:|-------|--------|----------------|
|
|
152
|
+
| 1 | | | |
|
|
153
|
+
| 2 | | | |
|
|
154
|
+
|
|
155
|
+
#### 3.2.4 대안 흐름 / 예외 흐름
|
|
156
|
+
-
|
|
157
|
+
|
|
158
|
+
#### 3.2.5 사후 조건 (Postconditions)
|
|
159
|
+
- [ ]
|
|
160
|
+
|
|
161
|
+
#### 3.2.6 수용 조건 (Acceptance Criteria)
|
|
162
|
+
|
|
163
|
+
```gherkin
|
|
164
|
+
Feature: [기능명]
|
|
165
|
+
|
|
166
|
+
Scenario: [시나리오명]
|
|
167
|
+
Given [사전 조건]
|
|
168
|
+
When [행동]
|
|
169
|
+
Then [기대 결과]
|
|
170
|
+
```
|
|
134
171
|
|
|
135
172
|
---
|
|
136
173
|
|
|
@@ -182,4 +219,4 @@ graph LR
|
|
|
182
219
|
|
|
183
220
|
| 버전 | 날짜 | 작성자 | 변경 내용 |
|
|
184
221
|
|------|------|--------|----------|
|
|
185
|
-
| 1.0.0 | {{DATE}} | tsq-
|
|
222
|
+
| 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
title: "용어 사전 (Glossary)"
|
|
3
3
|
version: 1.0.0
|
|
4
4
|
last_updated: {{DATE}}
|
|
5
|
-
author: tsq-
|
|
5
|
+
author: tsq-architect
|
|
6
6
|
status: draft
|
|
7
7
|
project: {{PROJECT_NAME}}
|
|
8
8
|
---
|
|
@@ -145,4 +145,4 @@ project: {{PROJECT_NAME}}
|
|
|
145
145
|
|
|
146
146
|
| 버전 | 날짜 | 작성자 | 변경 내용 |
|
|
147
147
|
|------|------|--------|----------|
|
|
148
|
-
| 1.0.0 | {{DATE}} | tsq-
|
|
148
|
+
| 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "인프라 토폴로지 (Infrastructure Topology)"
|
|
3
|
+
version: 1.0.0
|
|
4
|
+
last_updated: {{DATE}}
|
|
5
|
+
author: tsq-architect
|
|
6
|
+
status: draft
|
|
7
|
+
project: {{PROJECT_NAME}}
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 인프라 토폴로지 (Infrastructure Topology)
|
|
11
|
+
|
|
12
|
+
> 시스템의 물리/논리적 인프라 구조, 네트워크 토폴로지, 서비스 의존성을 정의합니다.
|
|
13
|
+
> 인프라 프로비저닝, 장애 분석, 용량 계획의 기준 문서입니다.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. 시스템 아키텍처
|
|
18
|
+
|
|
19
|
+
### 1.1 전체 토폴로지
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
┌─────────────┐
|
|
23
|
+
│ DNS │
|
|
24
|
+
└──────┬──────┘
|
|
25
|
+
│
|
|
26
|
+
┌──────▼──────┐
|
|
27
|
+
│ CDN/WAF │
|
|
28
|
+
└──────┬──────┘
|
|
29
|
+
│
|
|
30
|
+
┌───────────▼───────────┐
|
|
31
|
+
│ Load Balancer │
|
|
32
|
+
│ (ALB) │
|
|
33
|
+
└───────────┬───────────┘
|
|
34
|
+
│
|
|
35
|
+
┌─────────────────┼─────────────────┐
|
|
36
|
+
│ │ │
|
|
37
|
+
┌──────▼──────┐ ┌──────▼──────┐ ┌──────▼──────┐
|
|
38
|
+
│ Service A │ │ Service B │ │ Service C │
|
|
39
|
+
│ (Container) │ │ (Container) │ │ (Container) │
|
|
40
|
+
└──────┬──────┘ └──────┬──────┘ └──────┬──────┘
|
|
41
|
+
│ │ │
|
|
42
|
+
└─────────────────┼─────────────────┘
|
|
43
|
+
│
|
|
44
|
+
┌─────────────────┼─────────────────┐
|
|
45
|
+
│ │ │
|
|
46
|
+
┌──────▼──────┐ ┌──────▼──────┐ ┌──────▼──────┐
|
|
47
|
+
│ Database │ │ Cache │ │ Storage │
|
|
48
|
+
│ │ │ (Redis) │ │ │
|
|
49
|
+
└─────────────┘ └─────────────┘ └─────────────┘
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 2. 네트워크 구성
|
|
55
|
+
|
|
56
|
+
### 2.1 VPC 설계
|
|
57
|
+
|
|
58
|
+
| 항목 | 설정 | 비고 |
|
|
59
|
+
|-----|------|------|
|
|
60
|
+
| VPC CIDR | 10.0.0.0/16 | 65,534 호스트 |
|
|
61
|
+
| 리전 | (프로젝트 대상 리전) | |
|
|
62
|
+
| AZ | 2개 (a, c) | 고가용성 |
|
|
63
|
+
|
|
64
|
+
### 2.2 서브넷
|
|
65
|
+
|
|
66
|
+
| 서브넷 | CIDR | AZ | 접근 | 용도 |
|
|
67
|
+
|-------|------|:--:|------|------|
|
|
68
|
+
| public-a | 10.0.1.0/24 | a | 인터넷 | ALB, NAT |
|
|
69
|
+
| public-c | 10.0.2.0/24 | c | 인터넷 | ALB, NAT |
|
|
70
|
+
| private-app-a | 10.0.10.0/24 | a | NAT | 앱 서비스 |
|
|
71
|
+
| private-app-c | 10.0.20.0/24 | c | NAT | 앱 서비스 |
|
|
72
|
+
| private-data-a | 10.0.100.0/24 | a | 내부만 | DB, Cache |
|
|
73
|
+
| private-data-c | 10.0.200.0/24 | c | 내부만 | DB, Cache |
|
|
74
|
+
|
|
75
|
+
### 2.3 Security Groups
|
|
76
|
+
|
|
77
|
+
| SG | 인바운드 | 소스 | 용도 |
|
|
78
|
+
|---|---------|------|------|
|
|
79
|
+
| sg-alb | 80, 443 | 0.0.0.0/0 | 로드밸런서 |
|
|
80
|
+
| sg-app | 3000 | sg-alb | 앱 서비스 |
|
|
81
|
+
| sg-db | 5432 | sg-app | PostgreSQL |
|
|
82
|
+
| sg-cache | 6379 | sg-app | Redis |
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## 3. 서비스 구성
|
|
87
|
+
|
|
88
|
+
### 3.1 서비스 목록
|
|
89
|
+
|
|
90
|
+
| 서비스 | 타입 | 포트 | 인스턴스 (Prod) | 의존성 |
|
|
91
|
+
|-------|------|:----:|:-----------:|--------|
|
|
92
|
+
| API Server | 컨테이너 | 3000 | 2-10 | DB, Cache, Storage |
|
|
93
|
+
| Worker | 컨테이너 | - | 1-3 | DB, Queue |
|
|
94
|
+
| Scheduler | 서버리스 함수 | - | 1 | DB |
|
|
95
|
+
|
|
96
|
+
### 3.2 서비스 의존성
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
API Server ──► Database
|
|
100
|
+
──► Cache
|
|
101
|
+
──► Storage
|
|
102
|
+
──► Worker (Queue)
|
|
103
|
+
──► External API
|
|
104
|
+
|
|
105
|
+
Worker ──► Database
|
|
106
|
+
──► Queue
|
|
107
|
+
──► Notification
|
|
108
|
+
|
|
109
|
+
Scheduler ──► Database
|
|
110
|
+
──► Worker (Queue)
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### 3.3 외부 의존성
|
|
114
|
+
|
|
115
|
+
| 서비스 | 용도 | SLA | 장애 시 대응 |
|
|
116
|
+
|-------|------|:---:|-----------|
|
|
117
|
+
| 결제 PG | 결제 처리 | 99.9% | 재시도 + 큐잉 |
|
|
118
|
+
| SMS | 본인인증 | 99.5% | 대체 수단 (Email) |
|
|
119
|
+
| CDN | 정적 파일 | 99.99% | 오리진 폴백 |
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## 4. 데이터 흐름
|
|
124
|
+
|
|
125
|
+
### 4.1 주요 데이터 흐름
|
|
126
|
+
|
|
127
|
+
| 흐름 | 경로 | 프로토콜 | 암호화 |
|
|
128
|
+
|-----|------|---------|:------:|
|
|
129
|
+
| 클라이언트 → API | CDN → ALB → App | HTTPS | ✅ |
|
|
130
|
+
| App → DB | Private subnet | TCP/5432 | ✅ (TLS) |
|
|
131
|
+
| App → Cache | Private subnet | TCP/6379 | ✅ (TLS) |
|
|
132
|
+
| App → S3 | VPC Endpoint | HTTPS | ✅ |
|
|
133
|
+
| App → External | NAT Gateway | HTTPS | ✅ |
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## 5. 환경별 차이
|
|
138
|
+
|
|
139
|
+
| 항목 | Development | Staging | Production |
|
|
140
|
+
|-----|------------|---------|-----------|
|
|
141
|
+
| AZ | 1 | 2 | 2 |
|
|
142
|
+
| App 인스턴스 | 1 | 2 | 2-10 (Auto) |
|
|
143
|
+
| DB | db.t3.micro | db.t3.small | db.r6g.large |
|
|
144
|
+
| DB Multi-AZ | ❌ | ❌ | ✅ |
|
|
145
|
+
| Redis | ❌ | cache.t3.micro | cache.r6g.large |
|
|
146
|
+
| Redis 클러스터 | ❌ | ❌ | ✅ |
|
|
147
|
+
| WAF | ❌ | ❌ | ✅ |
|
|
148
|
+
| 백업 | ❌ | 일간 | 시간별 |
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## 6. IaC (Infrastructure as Code)
|
|
153
|
+
|
|
154
|
+
### 6.1 도구
|
|
155
|
+
|
|
156
|
+
| 도구 | 용도 | 경로 |
|
|
157
|
+
|-----|------|------|
|
|
158
|
+
| Terraform | 인프라 프로비저닝 | `infra/terraform/` |
|
|
159
|
+
| Docker Compose | 로컬 개발 | `docker-compose.yml` |
|
|
160
|
+
|
|
161
|
+
### 6.2 모듈 구조
|
|
162
|
+
|
|
163
|
+
```
|
|
164
|
+
infra/terraform/
|
|
165
|
+
├── modules/
|
|
166
|
+
│ ├── networking/ # VPC, Subnet, SG
|
|
167
|
+
│ ├── compute/ # ECS, Lambda
|
|
168
|
+
│ ├── database/ # RDS, ElastiCache
|
|
169
|
+
│ └── storage/ # S3, CloudFront
|
|
170
|
+
├── environments/
|
|
171
|
+
│ ├── dev/
|
|
172
|
+
│ ├── staging/
|
|
173
|
+
│ └── production/
|
|
174
|
+
└── global/ # IAM, Route53
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
## 7. 관련 문서
|
|
180
|
+
|
|
181
|
+
- [배포 명세](./deployment-spec.md) — CI/CD, 컨테이너 설정
|
|
182
|
+
- [모니터링 명세](./monitoring-spec.md) — 인프라 메트릭
|
|
183
|
+
- [보안 명세](./security-spec.md) — 네트워크 보안
|
|
184
|
+
|
|
185
|
+
---
|
|
186
|
+
|
|
187
|
+
## 변경 이력
|
|
188
|
+
|
|
189
|
+
| 버전 | 날짜 | 작성자 | 변경 내용 |
|
|
190
|
+
|------|------|--------|----------|
|
|
191
|
+
| 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
title: "외부 연동 명세서 (Integration Specification)"
|
|
3
3
|
version: 1.0.0
|
|
4
4
|
last_updated: {{DATE}}
|
|
5
|
-
author: tsq-
|
|
5
|
+
author: tsq-architect
|
|
6
6
|
status: draft
|
|
7
7
|
project: {{PROJECT_NAME}}
|
|
8
8
|
required_level: 3
|
|
@@ -388,4 +388,4 @@ const retryConfig = {
|
|
|
388
388
|
|
|
389
389
|
| 버전 | 날짜 | 작성자 | 변경 내용 |
|
|
390
390
|
|------|------|--------|----------|
|
|
391
|
-
| 1.0.0 | {{DATE}} | tsq-
|
|
391
|
+
| 1.0.0 | {{DATE}} | tsq-architect | 초기 작성 |
|