ftfw

type I데이터_처리기 interface {
	G영업일_모음() []uint32
	G현재가(string) float64
	G현재가_맵([]string) map[string]float64
	ETF_ETN_종목_여부(string) bool
	G제외_종목_여부(string) bool
	S상장_주식_수량_확인([]string) []string
}

type I데이터_처리기_백테스트_전용 interface {
	S준비(uint32, btc.T가격_구분)
	G일자() uint32
	G가격(uint32, btc.T가격_구분, string) float64
	G가격_맵(uint32, btc.T가격_구분, []string) map[string]float64
	G기준일_시가_종가_평균(uint32, string) float64
	G기준일_이전_전종목_가격_맵(uint32) map[string]*dd.S종목별_일일_가격정보_모음
}

type I전략_식별_정보 interface {
	G전략명() string
	G계좌번호() string
	G전략_식별_문자열() string
}

type I전략_실행기 interface {
	G실행() error
}

type I전략_인수[T팩터 T팩터_데이터, T재무 T재무_데이터] interface {
	I전략_식별_정보
	G리밸런싱_주기() lib.T리밸런싱_주기
	G종목_수량() int
	G복합_등급_계산_함수() func(*S필터_정렬_처리기[T팩터])
	G급등_종목_제외() bool
	G급락_종목_제외() bool
	G버퍼_퍼센트() float64 // 버퍼가 '0%'이면 버퍼룰 적용 안 함.
	G데이터_처리기() I데이터_처리기
	G팩터_데이터_처리기() I팩터_데이터_처리기[T팩터, T재무]
	G포트폴리오() I포트폴리오
}

type I팩터_데이터_처리기[T팩터 T팩터_데이터, T재무 T재무_데이터] interface {
	G필터_정렬_처리기() *S필터_정렬_처리기[T팩터]
}

type I포트폴리오 interface {
	G보유_종목_코드_모음() []string
	G리밸런싱_필요(string, lib.T리밸런싱_주기) bool
	G리밸런싱_기준_가격(종목코드 string) float64
	G리밸런싱_기준_수량(종목코드 string) int64
	G보유_수량_맵() (map[string]int64, error)
	S리밸런싱_실행(종목코드_모음 []string) error
	S손절(종목코드 string)
	S전체_손절()
	S익절(종목코드 string)
	S부분_익절(종목코드 string, 비율 float64)
}

type I포트폴리오_백테스트_전용 interface {
	S준비(uint32, btc.T가격_구분)
	S일일_결산()
	G투자_성과_계산() (float64, float64, float64) // CAGR/MDD/Sharpe
}

type S데이터_처리기_백테스트 struct {
	M일자   uint32
	M가격구분 btc.T가격_구분
	// contains filtered or unexported fields
}

type S리밸런싱 struct {
	M일자 uint32
	M주식 map[string]int64
}

type S매매 struct {
	M종목코드     string
	M일자       uint32
	M가격       float64
	M매도_매수_구분 lib.T매도_매수_구분
	M수량       int64
	M매매_상세_구분 T매매_상세_구분
}

type S일일_평가액 struct {
	M일자  uint32
	M평가액 float64
}

type S일자별_자산_현황 struct {
	M일자 uint32
	M현금 float64
	M주식 map[string]int64
}

type S재무_FG struct {
	S재무_정보_식별
}

type S재무_정보_식별 struct {
	M종목코드 string
	M연도   uint16
	M분기   uint8
}

type S재무_정보_저장소[T T재무_데이터] struct {
	M저장소 map[string]T
}

type S전략_실행기[T팩터 T팩터_데이터, T재무 T재무_데이터] struct {
	I전략_인수[T팩터, T재무]
}

type S전략_인수[T팩터 T팩터_데이터, T재무 T재무_데이터] struct {
	M전략명         string
	M계좌번호        string
	M리밸런싱_주기     lib.T리밸런싱_주기
	M종목_수량       int
	M주식_비중_퍼센트   float64
	M복합_등급_계산_함수 func(*S필터_정렬_처리기[T팩터])
	M급등_종목_제외    bool
	M급락_종목_제외    bool
	M버퍼_퍼센트      float64
	M데이터_처리기     I데이터_처리기
	M팩터_데이터_처리기  I팩터_데이터_처리기[T팩터, T재무]
	M포트폴리오       I포트폴리오
}

type S팩터_FG struct {
	M종목코드 string
	M종목명  string
	*S재무_FG
	M전분기_재무_정보    *S재무_FG
	M전년_동분기_재무_정보 *S재무_FG
	M최신_연도_재무_정보  *S재무_FG
	M차최신_연도_재무_정보 *S재무_FG
	// TODO
	M최근_급등 bool
	M최근_급락 bool
	M복합_등급 float64
}

type S팩터_데이터_처리기[T팩터 T팩터_데이터, T재무 T재무_데이터] struct {
	M재무정보_저장소_원본 *S재무_정보_저장소[T재무]
	M데이터_처리기     I데이터_처리기
}

type S팩터_세종 struct {
	M종목명 string
	*bfc.S재무_세종
	M전년_재무_정보 *bfc.S재무_세종
	// --- 비재무 정보 ---
	M상장주식수량 float64
	M전일_거래량 float64
	M기준가    float64
	// --- 사이즈 팩터 ---
	M시가총액    float64
	M시가총액_등급 float64
	// --- 가치 팩터 ---
	PSR   float64
	PSR등급 float64
	POR   float64
	POR등급 float64
	PER   float64
	PER등급 float64
	PBR   float64
	PBR등급 float64
	PEG   float64
	PEG등급 float64
	// --- 성장성 팩터 ---
	M매출액_성장율      float64
	M매출액_성장율_등급   float64
	M영업이익_성장율     float64
	M영업이익_성장율_등급  float64
	M당기순이익_성장율    float64
	M당기순이익_성장율_등급 float64
	// --- 수익성 팩터 --
	M자산회전율    float64 // 자산회전율 = 매출액 / 자산
	M자산회전율_등급 float64
	M자본회전율    float64 // 자본회전율 = 매출액 / 자본
	M자본회전율_등급 float64
	OPA       float64 // 영업이익 / 자산
	OPA등급     float64
	OPE       float64 // 영업이익 / 자본
	OPE등급     float64
	OPM       float64 // 영업이익 / 매출액
	OPM등급     float64
	ROA       float64 // 순이익 / 자산
	ROA등급     float64
	ROE       float64 // 순이익 / 자본
	ROE등급     float64
	NPM       float64 // 순이익 / 매출액
	NPM등급     float64
	// --- 추세 팩터 ---
	M3개월_모멘텀           float64
	M3개월_모멘텀_등급        float64
	M6개월_모멘텀           float64
	M6개월_모멘텀_등급        float64
	M9개월_모멘텀           float64
	M9개월_모멘텀_등급        float64
	M12개월_모멘텀          float64
	M12개월_모멘텀_등급       float64
	M12개월_고점_대비_하락율    float64
	M12개월_고점_대비_하락율_등급 float64
	// --- 퀄리티 팩터 ---
	M부채_비율        float64
	M부채_비율_등급     float64
	M부채_증가율       float64
	M부채_증가율_등급    float64
	M자본_증가율       float64
	M자본_증가율_등급    float64
	M자산_증가율       float64
	M자산_증가율_등급    float64
	M거래_금액_중간값_억  float64 // 1개월 거래 금액 중간값
	M거래_금액_중간값_등급 float64
	M가격_변동성       float64 // 6개월 일일 수익율 표준 편차
	M가격_변동성_등급    float64
	M거래금액_변동성     float64 // 6개월 거래 금액 변동율 표준 편차.
	M거래금액_변동성_등급  float64
	// --- 급등락 ---
	M최근_급등  bool
	M최근_급등일 uint32
	M최근_급락  bool
	M최근_급락일 uint32
	// --- 팩터 카테고리별 점수 ---
	M가치_점수  float64
	M가치_등급  float64
	M성장성_점수 float64
	M성장성_등급 float64
	M수익성_점수 float64
	M수익성_등급 float64
	M추세_점수  float64
	M추세_등급  float64
	M퀄리티_점수 float64
	M퀄리티_등급 float64
	// --- 최종 종합 점수 ---
	M복합_점수 float64
	M복합_등급 float64
}

type S포트폴리오 struct {
	M일자        uint32
	M가격구분      btc.T가격_구분
	M보유_현황     *S일자별_자산_현황
	M자산_현황_기록  []*S일자별_자산_현황
	M주문_체결_기록  []*S매매
	M리밸런싱_기록   []*S리밸런싱
	M일일_평가액_기록 []*S일일_평가액
	M데이터_처리기   I데이터_처리기
}

type S필터_정렬_처리기[T T팩터_데이터] struct {
	M저장소   []T
	Less함수 func(*S필터_정렬_처리기[T], int, int) bool
}

type T매매_상세_구분 int8

type T재무_데이터 interface {
	*bfc.S재무_세종 | *S재무_FG
	G종목코드() string
	G연도() uint16
	G분기() uint8
	G키() string
}

type T팩터_데이터 interface {
	*S팩터_세종 | *S팩터_FG
	G종목코드() string
	G최근_급등() bool
	G최근_급락() bool
	G복합_등급() float64
}