AGENT SKILL
10-attend-manager
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 61
- 脚本build.sh322 B
- 许可证LICENSE.txt1.4 KB
- 脚本scripts/__init__.py1 B
- 脚本scripts/accept_changes.py4.0 KB
- 脚本scripts/comment.py10.4 KB
- 脚本scripts/office/helpers/__init__.py—
- 脚本scripts/office/helpers/merge_runs.py5.4 KB
- 脚本scripts/office/helpers/simplify_redlines.py5.6 KB
- 脚本scripts/office/pack.py4.9 KB
- 脚本scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd1.9 KB
- 脚本scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd2.5 KB
- 脚本scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd2.8 KB
- 脚本scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd1.3 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd73.2 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd6.8 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd50.1 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd624 B
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd148.5 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd1.2 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd8.7 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd14.4 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd81.7 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd1.2 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd7.2 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd6.2 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd1.2 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd880 B
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd2.5 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd3.4 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd7.3 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd22.8 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd1.3 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd236.6 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd25.5 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd24.7 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd535 B
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd5.6 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd3.9 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd167.4 KB
- 脚本scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd4.5 KB
- 脚本scripts/office/schemas/mce/mc.xsd3.1 KB
- 脚本scripts/office/schemas/microsoft/wml-2010.xsd25.9 KB
- 脚本scripts/office/schemas/microsoft/wml-2012.xsd3.7 KB
- 脚本scripts/office/schemas/microsoft/wml-2018.xsd901 B
- 脚本scripts/office/schemas/microsoft/wml-cex-2018.xsd1.7 KB
- 脚本scripts/office/schemas/microsoft/wml-cid-2016.xsd1002 B
- 脚本scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd600 B
- 脚本scripts/office/schemas/microsoft/wml-symex-2015.xsd745 B
- 脚本scripts/office/soffice.py5.2 KB
- 脚本scripts/office/unpack.py4.0 KB
- 脚本scripts/office/validate.py3.6 KB
- 脚本scripts/office/validators/__init__.py336 B
- 脚本scripts/office/validators/base.py31.9 KB
- 脚本scripts/office/validators/docx.py16.0 KB
- 脚本scripts/office/validators/pptx.py9.6 KB
- 脚本scripts/office/validators/redlining.py8.7 KB
- 脚本scripts/templates/comments.xml2.5 KB
- 脚本scripts/templates/commentsExtended.xml2.5 KB
- 脚本scripts/templates/commentsExtensible.xml2.6 KB
- 脚本scripts/templates/commentsIds.xml2.6 KB
- 脚本scripts/templates/people.xml115 B
03 SKILL.md 正文
10-attend-manager
Status: ACTIVE AppliesTo: v10
AttendManager 설계 문서다.
출석 시스템의 오케스트레이터로서 ATTEND row 해석, claim 판정, 보상 적용, 저장까지 담당한다.
Class Design
public sealed class AttendManager : CompoSingleton<AttendManager>
{
readonly AttendStorage _storage = new();
public AttendStorage Storage => _storage;
public bool IsInitialized { get; }
public IReadOnlyList<ATTEND> ActiveRows { get; }
public IReadOnlyList<AttendRuntime> Runtimes { get; }
public Task<CommonResult> InitializeAsync(CancellationToken ct = default);
public void RefreshCycle();
public int GetCurrentCycleDay();
public AttendRuntimeState GetRuntimeState(string attend_id);
public AttendRuntime GetRuntime(int day);
public bool IsClaimed(string attend_id);
public bool IsClaimable(string attend_id);
public Task<GameResult<RewardData[]>> ClaimAsync(string attend_id, CancellationToken ct = default);
public void ClearStorage();
}
Responsibilities
TB_ATTENDactive row를 로드/정렬한다.- day 1~7 출석 row만 운영 대상으로 사용한다.
- 초기화/리프레시 시 day 1~7 고정 슬롯의
AttendRuntime7개를 생성한다. - reset 직후 runtime 상태를
day1=CLAIMABLE,day2..7=WAIT로 구성한다. - reset 조건 3개(정보 없음/72시간 경과/7일차 다음 날)를 판정한다.
nextAttendDayrow 누락 시 별도 보정 없이 claim 불가로 처리한다.- claim 가능 여부를 판정한다.
- claim 성공 시
RewardManager.ApplyRewardGroup으로 지급을 실행한다. - claim 성공 결과로 적용된
RewardData[]를 반환한다. AttendStorage를 갱신하고 SaveData 저장을 호출한다.
비책임:
- 서버 ledger/멱등 보장
- Inventory 직접 수정
- ATTEND 테이블 생성/로드 파이프라인
Dependencies
RewardManager— 보상 적용SaveDataManager— 영속화Devian.Domain.Game—TB_ATTEND,ATTEND
Failure Rules
- 초기화 전 claim 호출은 실패(
SAVEDATA_SYNC_REQUIRED)다. - row 미존재/invalid/순서 불일치(
row.day != nextAttendDay)는 실패다. nextAttendDay에 해당하는 row 누락은 실패/skip 처리한다.- 같은 UTC day 중복 claim은 실패다.
- 7일차 완료 후(reset 전) claim 호출은 실패다.
- 보상 적용 실패 시 저장은 수행하지 않는다.
- claim 당일에는 다음 day runtime이
CLAIMABLE로 전이되지 않고WAIT를 유지한다.
Implementation Location (3-path mirror)
- UPM (정본):
framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/Attend/AttendManager.cs
- Packages (sync):
framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/MobilePackage/Runtime/Attend/AttendManager.cs
- Assets/Samples (import):
framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/Attend/AttendManager.cs