# GitHub Copilot Instructions

> **8à**: t |@ \¸X õµ Àh |x `CLAUDE.md`| 0<\ iÈä.
> ´©  Ü `CLAUDE.md`| È¤0 |\  ¬Xà, t |ü Ù0Ttü8”.

---

# EAPIM Portal - \¸ Àh

t |@ AI T) ´Ü¤4¸(GitHub Copilot, Claude Code ñ)  t  ¥ŒX TÜ| ‘Å` L 8àX” ÀhD õiÈä.

## \¸ ”

**EAPIM Portal**@ ü@‰D \ Ô0|tˆ API ì8  ¬ Ü¤\…Èä. API D¤  ¬, ¬© ñ], API ¤ 	, 8T, L¤¸ 0¥D õX” ù 0 «ü…Èä.

**0  ¤Ý:**
- Spring Boot 2.7.18 with Spring MVC and Thymeleaf
- Java 8 (targetCompatibility: 1.8)
- Gradle 7.x LÜ Ü¤\
- Oracle 12c pt0 t¤ (JNDI| µ\ t pt0Œ¤)
- Spring Security (ä¤@ x)
- JPA/Hibernate 5.6.15 with Envers (¬ ”)
- MapStruct (DTO äQ), Lombok (ô|ìt¸ p)

## LÜ …9´

### `¬ tX ä‰
- gradlew ¬© À - offline gradle èÅ ä‰
- msi-gf63 ôè0Ð” /c/eactive/workspaces/shell-scripts/kjb-gradle.sh \ gradle ä‰ (jdk, gradle ñ X½ À 8 Ä gradle ä‰X” ¤l½¸)

```bash
# dev \|\ ä‰ (0ø)
gradle bootRun

# ¹ \|\ ä‰
gradle bootRun --args='--spring.profiles.active=stage'
```

### LÜ

```bash
# Spring Boot ä‰  ¥ WAR LÜ
gradle bootWar
# œ%: build/libs/eapim-portal-boot.war

# `¬ tX „© \  WAR LÜ (JEUS/WebLogic)
gradle war
# œ%: build/libs/eapim-portal.war

# t° Ä LÜ
gradle clean build
```

### L¤¸

```bash
# ¨à L¤¸ ä‰
gradle test

# ä„¬À@ hØ L¤¸ ä‰
gradle test --info

# ¹ L¤¸ t˜¤ ä‰
gradle test --tests "com.eactive.apim.portal.apps.user.AccountControllerTest"

# (4Ð äm” L¤¸ ä‰
gradle test --tests "*Controller*"
```

### 

```bash
# ¬ \| Ux
gradle printProfile

# Œ¤ 8¸ $ Ux
gradle printSourceSets

# Docker tøÀ LÜ
./build_docker.sh
```

## D¤M˜

### @ð ¨È lp

t \¸” Gradle composite build| µt 3X x€ ¨ÈÐ XtiÈä:

1. **elink-online-core-jpa** (`../eapim-online/elink-online-core-jpa`)
   - Gateway pt0 ¨x  JPA Ôðð
   - API …8 Ôðð  ¬ìÀ ¬ õ
   - (¤À: `com.eactive.eai.data.entity.onl.*`

2. **elink-portal-common** (`../elink-portal-common`)
   - õ  ì8  ø¬ð  õµ ôì¸
   - 0ø ¬ìÀ ¬ l, QueryDSL ÀÐ
   - õµ x xäì  ôH  ø¬ð

3. **kjb-safedb** (`../kjb-safedb`)
   - ü@‰ SafeDB T8T |tì¬
   - pt0 t¤ ¨ ü pt0 T8T
   - T8T ìü(¬© D ˆ8, API ¤ ñ)Ð D

### (¤À lp

TÜ” 0  Ä5t DÌ **0¥ ¨È**(Á „`) )Ý<\ l1)Èä:

```
com.eactive.apim.portal/
   apps/                      # 0¥ ¨È
      agreements/            # API } 
      apis/                  # API tÈ\ø & 8
      apiservice/            # API D¤ øùQ
      app/                   # API ¤  ¬
      approval/              # ¹x Ìl\°
      auth/                  # x
      community/             # FAQ, õÀ¬m, Q&A, 48X
      dashboard/             # µÄ & „
      file/                  # | Å\Ü/ä´\Ü
      login/                 # \øx/\øDÃ
      proxy/                 # API L¤¸© Forward Proxy
      sample/                # Ø TÜ Ý1
      user/                  # ¬©  ¬
   common/                    # õµ  ì¬
   config/                    # Spring $
   gateway/                   # Gateway DB Á ü
       data/                  # Gateway ¬ìÀ ¬
```

 0¥ ¨È@ |<\ äLD ìhiÈä:
- `controller/` - Spring MVC è¸dì (@Controller)
- `service/` - DˆÈ¤ \Á (@Service, @Transactional)
- `repository/` - Spring Data JPA ¬ìÀ ¬
- `dto/` - pt0 ¡ ´ (Lombok @Data)
- `mapper/` - MapStruct x0˜t¤ (entity ” DTO ÀX)

### t pt0 t¤ D¤M˜

`¬ tX@ P X Oracle pt0 t¤| ¬©iÈä:

1. **EMS Database** (Portal/Admin)
   - JNDI: `jdbc/dsOBP_EMS`
   - Schema: `EMSADM`
   - Entities: `com.eactive.apim.portal.apps.*`
   - ©: ì8 ¬©, pÁ, API ¤, ¹x

2. **Gateway Database** (API Specs)
   - JNDI: `jdbc/dsOBP_AGW`
   - Schema: `AGWADM`
   - Entities: `com.eactive.eai.data.entity.onl.*`
   - ©: API …8, D¤, TÜÀ

$: `config/PortalDatasourceConfiguration.java`
-  pt0 t¤Ä ÄÄ EntityManager
- Atomikos JTA| µ\ „° ¸œ­X
- ¸œ­X \ø: `/Log/eapim/portal/`

### $ \|

X½Ä $ |: `src/main/resources/application-{profile}.yml`

- **dev**:  X½ (Oracle at 192.168.240.177:1599, DevTools \1T, SQL \E)
- **stage**: ¤LtÕ X½ (JNDI pt0Œ¤, proxy to inter-dapiwas01)
- **prod**: ´ X½ (JNDI pt0Œ¤, proxy to inter-apiwas00, ñ \1T)
- **gf63**: GlassFish 6.3 0ì
- **kjb_rinjae**: x  X½

ü” $:
- 8X À„DÃ: 15„
- | Å\Ü \ : 8MB
- D ˆ8 ÌÌ: 90|
- x  p TTL: 5„ (300)
- ¬© ¹x D: true

## ü” 0¥  DˆÈ¤ \Á

### ¬©  ¬ (`apps/user/`)

P  À ¬©  :
1. **´€ ¬© (Staff)**: ì8  ¬  ´
2. **0Å ¬© (Enterprise)**: x€ API ŒD

¬© |t¬tt:
-  … ’ tT| x ’  ¬ ¹x ’ \1T
- D ˆ8 E © (90| ÌÌ, õ¡Ä ÜY)
- \øx ä( Ü Ä  
- 4t Ä  ¬

### API ¤  ¬ (`apps/app/`)

API ¤” ¹x Ìl\°@ hØ  ¬)Èä:
- 0Å  ¬  `AppRequestController`| µt ¤ ”­
-  ¬  `ApprovalController`| µt ¹x/$
- ¤” /´ X½ ÀÐ
- ¤” eLink Gateway ClientID/ClientSecretü ð°

### ¹x Ìl\° (`apps/approval/`)

äL m©Ð  \ ”© ¹x Ü¤\:
- ¬© ñ] ¹x
- API ¤ Ý1/
- 4 à­

Ôðð: `Approval`, `Approver`, `ApprovalStatus` (WAITING, APPROVED, REJECTED)

### API L¤¸ (`apps/proxy/`, `apps/sample/`)

- Gateway „\X Forward Proxy
- ”­/Qõ \Et ˆ” API L¤0
- ìì ¸´X Ø TÜ Ý1
- API 8| \ Swagger UI µi

### ¬ ” (Hibernate Envers)

¨à Ôðð” Ù ¬| t `AbstractAuditingEntity`| U¥iÈä:
- `createdBy`, `createdDate`
- `lastModifiedBy`, `lastModifiedDate`
- `@Audited` ´xLtX<\ À½ t%  ¬
- Spring Data Envers| µ\ t% pŒ

## õµ  (4

### È 0¥ ¨È ” X0

1. `apps/` XÐ (¤À Ý1 (: `apps/newfeature/`)
2. `controller/`, `service/`, `repository/`, `dto/`, `mapper/`\ lpT
3. `repository/entity/`Ð JPA Ôðð Ý1 (`AbstractAuditingEntity` U¥)
4. `dto/`Ð Lombok `@Data`| ¬©\ DTO Ý1
5. `mapper/`Ð MapStruct ä| x0˜t¤ Ý1
6. `@Service`@ `@Transactional`D ¬©\ D¤ Ä5 l
7. `@Controller`@ `@RequestMapping`D ¬©\ è¸dì Ý1
8. `src/main/resources/templates/views/newfeature/`Ð Thymeleaf \¿ ” 
9. `src/main/resources/page-route.yml`Ð |°¸ $

### MapStruct DTO äQ

À… H\ DTO ÀXD t MapStruct ¬©:

```java
@Mapper(componentModel = "spring")
public interface UserMapper {
    PortalUserDto toDto(PortalUser entity);
    PortalUser toEntity(PortalUserDto dto);
    List<PortalUserDto> toDtoList(List<PortalUser> entities);
}
```

Ý1 l´” `build/generated/sources/annotationProcessor/java/main/`Ð X

### ôH  x

ôH $: `config/PortalConfigSecurity.java`
- ä¤@ x  ¬: `PortalAuthenticationManager`
- `changeSessionId()`| µ\ 8X à õ© )´
- à¤ 0  pD ¬©\ CSRF )´
- Lucy D0| µ\ XSS )´

í` Ä5:
```
ROLE_USER ’ [ROLE_INQUIRY, ROLE_ACCOUNT]
ROLE_CORP_USER ’ [ROLE_INQUIRY, ROLE_APP, ROLE_ACCOUNT]
ROLE_CORP_MANAGER ’ [ROLE_API_KEY_REQUEST, ROLE_INQUIRY, ROLE_APP,
                      ROLE_ACCOUNT, ROLE_CORP_API, ROLE_DASHBOARD,
                      ROLE_USER_MANAGER]
```

### pt0 t¤ ü¬

Spring Data JPA ¬ìÀ ¬ TÜ ¬© Œ¥:

```java
public interface PortalUserRepository extends JpaRepository<PortalUser, Long> {
    Optional<PortalUser> findByEmail(String email);

    @Query("SELECT u FROM PortalUser u WHERE u.status = :status")
    List<PortalUser> findByStatus(@Param("status") UserStatus status);
}
```

õ¡\ ü¬” QueryDSL ¬©:
```java
QPortalUser user = QPortalUser.portalUser;
return queryFactory.selectFrom(user)
    .where(user.email.eq(email)
        .and(user.status.eq(UserStatus.ACTIVE)))
    .fetchOne();
```

### ¸œ­X  ¬

\ propagationü hØ `@Transactional` ¬©:
- 0ø: `REQUIRED` (0t ¸œ­XÐ 8ìXp˜ È\ Ý1)
- }0 © ‘Å: \T| t `@Transactional(readOnly = true)`
- ä pt0 t¤: Atomikos JTA  Ù<\ „° ¸œ­X ˜¬

### Ðì ˜¬

`common/exception/`X  \Œ x ˜¬:
- `@ControllerAdvice`  © `GlobalExceptionHandler`
- ä¤@ x” `RuntimeException` U¥
- Thymeleaf Ðì ð ” AJAX ”­Ð” JSON X

### \E

`application.yml`X \E $:
```yaml
logging:
  file:
    path: /Log/App/eapim/
  level:
    com.eactive.apim.portal: DEBUG
    org.hibernate.SQL: DEBUG ( X½Ì)
```

LombokX `@Slf4j`@ hØ SLF4J ¬©:
```java
@Slf4j
@Service
public class UserService {
    public void someMethod() {
        log.debug("„ø TÜÀ");
        log.info("ô TÜÀ");
        log.error("Ðì TÜÀ", exception);
    }
}
```

## L¤¸  tÜ

### L¤¸ lp

`src/test/java/com/eactive/apim/portal/`X L¤¸:
- `BaseWebTest` - Spring Boot L¤¸ èM¤¸|  Ä 0ø t˜¤
- è¸dì L¤¸” `BaseWebTest` U¥
- µi L¤¸” `@SpringBootTest` ¬©
- Å½x è¸dì L¤¸” `@WebMvcTest` ¬©

### |x L¤¸ (4

```java
@SpringBootTest
@AutoConfigureMockMvc
class UserControllerTest extends BaseWebTest {

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private UserService userService;

    @Test
    void testUserRegistration() throws Exception {
        mockMvc.perform(post("/user/register")
                .param("email", "test@example.com")
                .with(csrf()))
            .andExpect(status().isOk())
            .andExpect(view().name("user/register-success"));
    }
}
```

### SafeDB L¤¸

L¤¸Ð” 0ø<\ SafeDB T8T  D\1T)Èä. D”\ ½°:
```bash
gradle test -Dsafedb=/path/to/safedb
```

## ” ¬m

### \  ÀÐ

t ì8@ \ D ”XŒ ¬©iÈä:
- Thymeleaf \¿@ \  t ¬©
- pt0 t¤” \  pt0 ìh (UTF-8)
- \  TÜÀ \|ð (`messages_ko.properties`)
- \  ¬©  tÜ (`ìÈ.md`)

### Forward Proxy $

API L¤¸” Gateway\X Forward Proxy ¬©:
- Dev: `http://localhost:10000`
- Stage: `http://inter-dapiwas01:10000`
- Prod: `http://inter-apiwas00:10000`

$: `apps/proxy/service/ProxyService.java`

### D ˆ8 E

`PortalUserValidator`Ð ©:
- \Œ 8
-  8, Œ8, +, ¹8 ìh D
- ð 8 ¬© ˆ 
- \ü 3 D ˆ8 ¬¬© ˆ 
- 90| Ä ÌÌ

### 8X  ¬

- ¬©ù è| 8X 
- 8X À„DÃ: 15„
- \øx Ü 8X à õ© )´
- Redis/Ehcache| µ\ 8X tì¤0Á (¤LtÕ/´)

### | Å\Ü \

- \  | l0: 8MB
- `FileService`Ð È© U¥ $
- |  ¥ X: `/Log/App/eapim/files/`
- Å\Ü Ü XSS ¤Ý

## 0ì

### `¬ tX „ ÀÐ

WAR | 8X „:
- **JEUS** (`jeus-web-dd.xml` D”)
- **WebLogic** (`weblogic.xml` D”)
- **GlassFish 6.3** (`gradle-gf63.sh` ¬©)
- **Tomcat** (Spring Boot ´¥)

### JNDI $ D

¤LtÕ/´ X½Ð JNDI ¬Œ¤ $:
- `jdbc/dsOBP_EMS` ’ Portal pt0 t¤
- `jdbc/dsOBP_AGW` ’ Gateway pt0 t¤

### X½ À

```bash
#  Ý¬m: 0ø $ $„|tÜ
JAVA_OPTS="-Xmx2g -Xms1g -Dspring.profiles.active=prod"
```

### Docker 0ì

```bash
# WAR LÜ
gradle bootWar

# Docker tøÀ LÜ
./build_docker.sh

# èLt ä‰
docker run -p 8080:8080 \
  -e JAVA_OPTS="-Dspring.profiles.active=prod" \
  -v /Log:/Log \
  eapim-portal:latest
```

##  ( ¨È

äL m©Ð ¥D ü” À½ Ü:
- **Gateway API …8**: `elink-online-core-jpa` ¨È Ux
- **õµ  ø¬ð**: `elink-portal-common` ¨È Ux
- **T8T**: `kjb-safedb` ¨È Ux
- **Admin ì8**: `../eapim-admin/`  ( \¸
- **Online ì8**: `../eapim-online/`  ( \¸

## ”  Ì

- ¬©  tÜ (\ ): `ìÈ.md`
- LÜ ¤l½¸: `build-gf63.sh`, `deploy_portal.sh`, `deploy_portal2.sh`
- Docker: `Dockerfile`, `build_docker.sh`
- SQL ¤l½¸: `../kjb-eapim-sql/`