Skip to content

Commit 7e57640

Browse files
committed
docs: add branch protection baseline and sprint-01 backlog
1 parent 27d2110 commit 7e57640

5 files changed

Lines changed: 151 additions & 1 deletion

File tree

.github/CODEOWNERS

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,7 @@
1-
* @demshine/admin
1+
# Replace placeholders with real GitHub usernames or teams.
2+
* @demshine
3+
4+
# Suggested ownership split:
5+
# /apps/web/ @demshine/frontend
6+
# /apps/api/ @demshine/backend
7+
# /infra/ @demshine/devops

.github/ISSUE_TEMPLATE/task.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
name: Task
3+
about: Engineering or delivery task
4+
labels: task
5+
---
6+
7+
## Context
8+
9+
## Scope
10+
11+
## Acceptance Criteria
12+
1.
13+
2.
14+
3.
15+
16+
## Risks
17+
18+
## Dependencies

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,3 +26,5 @@ Private monorepo bootstrap for the AI short-drama production platform.
2626
- `docs/release-playbook.md`
2727
- `docs/security-baseline.md`
2828
- `docs/roadmap.md`
29+
- `docs/branch-protection.md`
30+
- `docs/sprints/sprint-01-backlog.md`

docs/branch-protection.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# Branch Protection Baseline
2+
3+
## Target Branches
4+
- `main`
5+
- `develop`
6+
7+
## `main` Rules
8+
- Require a pull request before merging.
9+
- Require approvals: minimum 1.
10+
- Dismiss stale pull request approvals when new commits are pushed.
11+
- Require status checks to pass before merging.
12+
- Require branches to be up to date before merging.
13+
- Restrict direct pushes and force pushes.
14+
- Restrict branch deletions.
15+
16+
## `develop` Rules
17+
- Require a pull request before merging.
18+
- Require status checks to pass before merging.
19+
- Require branches to be up to date before merging.
20+
- Restrict direct pushes and force pushes.
21+
22+
## Required Checks (Initial)
23+
- `validate`
24+
25+
## Review Policy
26+
- Every PR must include:
27+
- Scope
28+
- Risk
29+
- Rollback plan
30+
- Acceptance evidence
31+
32+
## Admin Guidance
33+
- Keep admin bypass disabled unless incident response requires emergency hotfix.
34+
- If bypass is used, record reason in release notes.

docs/sprints/sprint-01-backlog.md

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
# Sprint 01 Backlog (2 Weeks)
2+
3+
## Goal
4+
Deliver a usable shot-level asset hub with provider-ready orchestration for AI short-drama production.
5+
6+
## Scope
7+
- Shot state machine and storage.
8+
- Unified generation task queue baseline.
9+
- Runway/Kling adapter skeleton.
10+
- Script Desk + Video Desk first usable UI.
11+
12+
## Work Items
13+
14+
### BE-001 Shot Domain Model
15+
- Owner: Backend
16+
- Priority: P0
17+
- Description: Create shot entity, shot status transitions, and validation rules.
18+
- Acceptance:
19+
- Shot statuses: `draft`, `ready`, `generating`, `generated`, `selected`, `edited`, `published`.
20+
- Invalid transitions are rejected with clear errors.
21+
22+
### BE-002 Asset Candidate Model
23+
- Owner: Backend
24+
- Priority: P0
25+
- Description: Support multi-candidate videos per shot and one selected candidate.
26+
- Acceptance:
27+
- A shot can bind multiple candidates from different providers.
28+
- Exactly one candidate can be selected.
29+
30+
### BE-003 Task Queue Baseline
31+
- Owner: Backend
32+
- Priority: P0
33+
- Description: Unified task records for generation requests.
34+
- Acceptance:
35+
- Task lifecycle: `queued`, `running`, `succeeded`, `failed`, `cancelled`.
36+
- Retry count and error code are persisted.
37+
38+
### BE-004 Provider Adapter Interface
39+
- Owner: Backend
40+
- Priority: P0
41+
- Description: Introduce adapter interface for `runway` and `kling`.
42+
- Acceptance:
43+
- Shared input/output contract implemented.
44+
- Provider-specific raw response stored for debug.
45+
46+
### API-001 Core Endpoints
47+
- Owner: Backend
48+
- Priority: P0
49+
- Description: Implement first batch of endpoints.
50+
- Acceptance:
51+
- `POST /projects/:id/shots/import`
52+
- `GET /projects/:id/shots`
53+
- `POST /shots/:id/generate`
54+
- `POST /shots/:id/select`
55+
56+
### FE-001 Script Desk (MVP)
57+
- Owner: Frontend
58+
- Priority: P0
59+
- Description: Build shot list page with filters and batch actions.
60+
- Acceptance:
61+
- Filter by status/provider.
62+
- Batch generate and batch retry actions.
63+
64+
### FE-002 Video Desk (MVP)
65+
- Owner: Frontend
66+
- Priority: P0
67+
- Description: Candidate comparison and selection UI.
68+
- Acceptance:
69+
- Preview candidates per shot.
70+
- One-click select candidate as primary.
71+
72+
### QA-001 Flow Validation
73+
- Owner: QA
74+
- Priority: P0
75+
- Description: Validate end-to-end shot workflow with mock providers.
76+
- Acceptance:
77+
- 20-shot run without status corruption.
78+
- Failed tasks can retry successfully.
79+
80+
### PM-001 Acceptance Checklist
81+
- Owner: Product
82+
- Priority: P1
83+
- Description: Freeze sprint acceptance checklist and demo script.
84+
- Acceptance:
85+
- Checklist approved before sprint review.
86+
87+
## Out of Scope
88+
- Full CapCut export package generation.
89+
- Advanced quality scoring model.
90+
- Multi-tenant RBAC finalization.

0 commit comments

Comments
 (0)